React Native项目中CocoaPod依赖如何访问主项目的Swift Package

核心原理 #

CocoaPods默认不会自动继承主项目的Swift Package Manager（简称SPM）依赖搜索路径，导致封装层Pod编译时无法识别主项目引入的SPM SDK，以下提供两种可直接落地的方案：

方案1：修改自定义CocoaPods封装层的podspec配置（侵入性最低） #

仅需修改封装层的.podspec文件，无需改动主项目配置：

• 在podspec中添加如下编译配置：

s.pod_target_xcconfig = {
  'OTHER_SWIFT_FLAGS' => '$(inherited)',
  'OTHER_LDFLAGS' => '$(inherited) -framework 替换为你的SDK框架名称',
  'FRAMEWORK_SEARCH_PATHS' => '$(inherited) $(BUILT_PRODUCTS_DIR)',
  'SWIFT_INCLUDE_PATHS' => '$(inherited) $(BUILT_PRODUCTS_DIR)'
}

• 配置完成后，在主项目ios目录执行pod install，清理Xcode缓存后重新编译即可。

方案2：修改主项目Podfile注入路径（无需改动封装层代码） #

如果不希望修改封装层的podspec，可以通过主项目Podfile的post_install钩子注入配置：

• 在主项目ios/Podfile末尾添加如下代码：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 替换为你的自定义CocoaPods封装层的target名称
    if target.name == '你的封装层Pod名称'
      target.build_configurations.each do |config|
        config.build_settings['FRAMEWORK_SEARCH_PATHS'] ||= []
        config.build_settings['FRAMEWORK_SEARCH_PATHS'] << '$(inherited) $(BUILT_PRODUCTS_DIR)'
        config.build_settings['OTHER_LDFLAGS'] ||= []
        # 替换为你的SDK框架名称
        config.build_settings['OTHER_LDFLAGS'] << '$(inherited) -framework 你的SDK框架名称'
      end
    end
  end
end

• 修改完成后执行pod install，重新编译项目即可。

注意事项 #

• 确保主项目引入的Swift Package SDK目标为动态库，如果是静态库，需要额外在封装层podspec中添加s.static_framework = true匹配类型。
• 如果出现找不到模块的报错，先按Command + Shift + K清理Xcode缓存，删除DerivedData目录后再重新编译。
• 不推荐在CocoaPods依赖中直接声明SPM依赖，即使CocoaPods 1.11+支持该配置，也会和React Native的Pods结构产生冲突，导致重复引入依赖。

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