Flutter iOS中添加静态库的步骤及验证方法咨询

一、插件项目中添加静态库的具体步骤 #

1. 把静态库（.a文件）和对应头文件放到插件的ios/Classes目录下，要是有多份库文件，建议建个子目录比如Classes/Libs统一存放，方便路径管理。
2. 修改插件的.podspec配置：
   • 新增s.public_header_files = 'Classes/**/*.h'，这步是让CocoaPods把静态库的头文件打包成可被模块引用的公共接口。
   • 确认s.vendored_libraries的路径准确，比如静态库在Classes/Libs里，就写成s.vendored_libraries = 'Classes/Libs/*.a'，避免匹配到无关文件。
   • 保留DEFINES_MODULE = YES，这是Swift能识别插件为模块的核心配置。
3. 刷新依赖：回到插件根目录执行flutter clean，再进入example/ios目录运行pod install，让Pod重新加载新配置。

二、验证静态库添加成功的方法 #

1. 直接在Example项目的AppDelegate.swift里测试：
   • 顶部添加import hello（hello是你插件的名字，对应podspec里的s.name），如果能正常导入且编译不报错，说明模块引用没问题。
   • 要是静态库有可调用的方法，比如testLibFunc()，可以在application(_:didFinishLaunchingWithOptions:)里调用，运行不崩溃就说明完全成功。
2. 检查Pod生成的模块文件：
   • 打开example/ios/Pods/hello目录，查看是否存在hello.modulemap文件，这个文件里会列出静态库的头文件引用，存在就说明配置生效。
3. 头文件引用位置说明：
   • 插件内部的代码（比如Classes下的Objective-C文件）直接用#import "xxx.h"引用静态库头文件即可；
   • 主App的AppDelegate.swift里不用直接引用静态库头文件，只要import 插件名就行，插件已经把静态库封装成模块了。

修改后的.podspec示例 #

Pod::Spec.new do |s|
  s.name             = 'hello'
  s.version          = '0.0.1'
  s.summary          = 'A new Flutter plugin project.'
  s.description      = <<-DESC
A new Flutter plugin project.
                       DESC
  s.homepage         = 'http://example.com'
  s.license          = { :file => '../LICENSE' }
  s.author           = { 'Your Company' => 'email@example.com' }
  s.source           = { :path => '.' }
  s.source_files = 'Classes/**/*'
  # 精准指定静态库路径
  s.vendored_libraries = 'Classes/Libs/*.a'
  # 暴露公共头文件以生成模块接口
  s.public_header_files = 'Classes/**/*.h'
  s.dependency 'Flutter'
  s.platform = :ios, '11.0'

  s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES', 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'i386' }
  s.swift_version = '5.0'
end

内容的提问来源于stack exchange，提问作者bakboem