如何通过 podspec 在颤振插件上添加 .a 库

Posted 2023-02-15

【中文标题】如何通过 podspec 在颤振插件上添加 .a 库

【英文标题】：How to add .a libraries on flutter plugin via podspec

【发布时间】：2020-09-20 11:45:37

【问题描述】：

我正在尝试在插件的 ios 端包含 .a 文件。下面是我的文件结构。

现在，当我尝试通过 vendored_libraries 在 podspec 上添加 .a 文件时，pod 安装已成功完成。当我编译代码时，我得到Library Not Found -lAccuraFace

我尝试在 Pod 目标的构建阶段的 Link Binary With Libraries 部分添加 .a 文件。还是一样，如何定义 podspec，让 .a 文件自动包含并链接。

这是我的插件 podspec 文件

Pod::Spec.new do |s|
  s.name             = 'accuraemirates'
  s.version          = '0.0.1'
  s.summary          = 'A new Flutter plugin.'
  s.description      = <<-DESC
A new Flutter plugin.
                       DESC
  s.homepage         = 'http://example.com'
  s.license          =  :file => '../LICENSE' 
  s.author           =  'Your Company' => '[e-mail]' 
  s.source           =  :path => '.' 
  s.source_files = 'Classes/**/*'
  s.dependency 'Flutter'
  s.public_header_files = 'Classes/*.h'
  s.private_header_files = 'Classes/CodeScan/**/*.h,.cpp,.a'
  s.platform = :ios, '8.0'
  s.preserve_paths = 'opencv2.framework'
  s.xcconfig =  
    'OTHER_LDFLAGS' => '-framework opencv2 -lAccuraFace',
  
  s.ios.vendored_frameworks = 'opencv2.framework', "CoreVideo.framework", "Foundation.framework", "CoreGrpahics.framework", 
  "Accelerate.framework", "CoreMedia.framework", "CoreImage.framework", "QuartzCore.framework", "AudioToolbox.framework", "CoreData.framework", "SystemConfiguration.framework"
  s.ios.vendored_libraries = 'Classes/Framework/*.a', "libz.1.dylib", "c++", "stdc++"

  # Flutter.framework does not contain a i386 slice. Only x86_64 simulators are supported.
  s.pod_target_xcconfig =  'DEFINES_MODULE' => 'YES', 'VALID_ARCHS[sdk=iphonesimulator*]' => 'x86_64' 
  s.swift_version = '5.0'
end

这是根 podfile

ENV['COCOAPODS_DISABLE_STATS'] = 'true'

project 'Runner', 
  'Debug' => :debug,
  'Profile' => :release,
  'Release' => :release,


def parse_KV_file(file, separator='=')
  file_abs_path = File.expand_path(file)
  if !File.exists? file_abs_path
    return [];
  end
  generated_key_values = 
  skip_line_start_symbols = ["#", "/"]
  File.foreach(file_abs_path) do |line|
    next if skip_line_start_symbols.any?  |symbol| line =~ /^\s*#symbol/ 
    plugin = line.split(pattern=separator)
    if plugin.length == 2
      podname = plugin[0].strip()
      path = plugin[1].strip()
      podpath = File.expand_path("#path", file_abs_path)
      generated_key_values[podname] = podpath
    else
      puts "Invalid plugin specification: #line"
    end
  end
  generated_key_values
end

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  # Flutter Pod

  copied_flutter_dir = File.join(__dir__, 'Flutter')
  copied_framework_path = File.join(copied_flutter_dir, 'Flutter.framework')
  copied_podspec_path = File.join(copied_flutter_dir, 'Flutter.podspec')
  unless File.exist?(copied_framework_path) && File.exist?(copied_podspec_path)
    # Copy Flutter.framework and Flutter.podspec to Flutter/ to have something to link against if the xcode backend script has not run yet.
    # That script will copy the correct debug/profile/release version of the framework based on the currently selected Xcode configuration.
    # CocoaPods will not embed the framework on pod install (before any build phases can generate) if the dylib does not exist.

    generated_xcode_build_settings_path = File.join(copied_flutter_dir, 'Generated.xcconfig')
    unless File.exist?(generated_xcode_build_settings_path)
      raise "Generated.xcconfig must exist. If you're running pod install manually, make sure flutter pub get is executed first"
    end
    generated_xcode_build_settings = parse_KV_file(generated_xcode_build_settings_path)
    cached_framework_dir = generated_xcode_build_settings['FLUTTER_FRAMEWORK_DIR'];

    unless File.exist?(copied_framework_path)
      FileUtils.cp_r(File.join(cached_framework_dir, 'Flutter.framework'), copied_flutter_dir)
    end
    unless File.exist?(copied_podspec_path)
      FileUtils.cp(File.join(cached_framework_dir, 'Flutter.podspec'), copied_flutter_dir)
    end
  end

  # Keep pod path relative so it can be checked into Podfile.lock.
  pod 'Flutter', :path => 'Flutter'

  # Plugin Pods

  # Prepare symlinks folder. We use symlinks to avoid having Podfile.lock
  # referring to absolute paths on developers' machines.
  system('rm -rf .symlinks')
  system('mkdir -p .symlinks/plugins')
  plugin_pods = parse_KV_file('../.flutter-plugins')
  plugin_pods.each do |name, path|
    symlink = File.join('.symlinks', 'plugins', name)
    File.symlink(path, symlink)
    pod name, :path => File.join(symlink, 'ios')
  end
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['ENABLE_BITCODE'] = 'NO'
    end
  end
end

是否无法在 Flutter 插件上从 podspec 文件添加/链接 .a 库。

【参考方案1】：

终于找到问题了..

Pod::Spec.new do |s|
  # other obvious values
  s.source_files = 'Classes//*.h,.a,.swift,.mm,.m,.hpp'
  s.resources = 'Resources//'
  s.static_framework = true 
  s.public_header_files = "Classes/VideoCamera/VideoCameraWrapperDelegate.h", "Classes/VideoCamera/VideoCameraWrapper.h",'Classes/.h',
  s.private_header_files = 'Classes/CodeScan//.h,.cpp,.hpp'
  s.platform = :ios, '8.0'
  s.preserve_paths = 'opencv2.framework', 'Classes/Framework/.a'

  s.xcconfig =  
     # here on LDFLAG, I had to set -l and then the library name (without lib prefix although the file name has it).
    'OTHER_LDFLAGS' => '-framework opencv2 -lc++ -lAccuraFace -lAccuraEmirate -lDocRecog -lz',
    'USER_HEADER_SEARCH_PATHS' => '"$PROJECT_DIR/.."/',
    "LIBRARY_SEARCH_PATHS" => '"$PROJECT_DIR/.."/*',
  
  s.vendored_frameworks = 'opencv2.framework' # Various framworks you need
  # Here the name of the library can include lib as the file name has it too.
  s.vendored_libraries = 'AccuraFace','libAccuraEmirate','libDocRecog'
end

请注意这里的两个值 OTHER_LDFLAGS 和 vendored_libraries。尽管我有相同的文件，但它们需要带有或不带有 lib 前缀的名称。奇怪但有效。

【讨论】：

嗨 Aawaz，你能提供代码示例吗，我是新的插件开发和 ios，我正在使用 onfido 包，不知道如何使它工作，我与 opencv2.framework 和 libAccuraEmirate 混淆了，我应该在哪里添加我不确定的内容，请您在这里帮忙

【参考方案2】：

你肯定可以添加.a库，试试看下面的配置路径

TARGETS->Build Settings->Search Paths-> Library Search Paths

在那里，添加.a库所在的路径。

这是一个有效的路径配置演示：

================================================ =============================

更新

对于颤振插件

至于作为flutter plugin 发布，带有.a 后缀的文件实际上是静态库，这里有一个sn-p 说明如何在.podspec 文件中进行操作：

 s.subspec 'Core' do |sc|
    sc.ios.library = 'z'
    sc.frameworks = 'SystemConfiguration', 'QuartzCore', 'CoreText', 'WebKit'
    sc.source_files = 'AppboyKit/headers/AppboyKitLibrary/*.h', 'AppboyKit/ABKIdentifierForAdvertisingProvider.m', 'AppboyKit/ABKModalWebViewController.m', 'AppboyKit/ABKNoConnectionLocalization.m', 'AppboyKit/ABKLocationManagerProvider.m'
    sc.resource = 'AppboyKit/Appboy.bundle'
    sc.vendored_libraries = 'AppboyKit/libAppboyKitLibrary.a'
    sc.weak_framework = 'CoreTelephony', 'Social', 'Accounts', 'AdSupport', 'UserNotifications'
  end

注意行以sc.vendored_libraries开头，这里是complete source。

【讨论】：

但这是一个插件代码，所以每次有人将它添加到他们的项目中时，都会运行 pod install 从而删除库搜索路径。我想从 podsepc 文件中配置它。

@AawazGyawali 也许你可以看看this issue。和this

感谢您的评论，我已经检查了它们，如果您看到我的 podspec，我已经使用该技术添加了 s.preserve_paths = 'opencv2.framework' opencv2。但它们都没有定义如何为 .a 文件设置相同的值。

谢谢，@zionpi。尽管您的回答不起作用，但我能够通过一个有点奇怪的配置来修复它。检查我发布的答案。

@AawazGyawali 干得好。如果我理解正确，它需要同时带有和不带有 lib 前缀的库？