如何在React Native iOS封装库的Podspec中导入.xcframework？

一、Podspec直接引用的正确配置 #

你之前的路径配置有误，Podspec里引用用户项目中的XCFramework，应该基于${PODS_ROOT}（指向RN项目ios/Pods目录）来拼接路径——因为SDK是由使用你的库的用户自行提供并放置在他们的项目目录中。

假设用户将XCFramework放在RN项目的ios/ThirdPartySDK/mysdk.xcframework，Podspec里的配置应该是：

# 引入指定路径下的XCFramework
s.vendored_frameworks = "${PODS_ROOT}/../ThirdPartySDK/mysdk.xcframework"

# 添加框架搜索路径，确保Xcode能找到它
s.pod_target_xcconfig = {
  'FRAMEWORK_SEARCH_PATHS' => '$(inherited) "${PODS_ROOT}/../ThirdPartySDK"'
}

需要明确告知使用你的库的用户：

• 在他们的RN项目ios目录下创建ThirdPartySDK文件夹
• 将自己的mysdk.xcframework放入该文件夹
• 执行pod install完成配置

二、常见错误排查 #

• 路径不匹配：执行pod install后，可在Xcode的Pods项目中检查该XCFramework是否被正确引入，若显示红色，说明路径错误，需核对实际文件位置和Podspec中的路径。
• 架构缺失：确保XCFramework包含所有需要的架构（比如arm64、x86_64），否则会出现编译失败或运行时崩溃。
• 权限问题：检查XCFramework文件的可读权限，避免Xcode因权限不足无法加载框架。

三、替代方案 #

如果Podspec直接引用的方式仍有问题，可尝试以下方案：

1. 用户手动添加至Xcode项目 #

让用户打开RN项目的ios/*.xcworkspace，将XCFramework直接拖入项目导航栏，在弹出的选项中勾选"Copy items if needed"，然后在目标项目的Build Phases > Link Binary With Libraries中确认该框架已添加，并在General > Frameworks, Libraries, and Embedded Content中将其设置为Embed & Sign。

2. 本地Podspec包装SDK #

让用户将XCFramework打包成本地Podspec，无需发布到CocoaPods：

1. 在用户项目的ios/ThirdPartySDK目录下创建mysdk.podspec：

Pod::Spec.new do |s|
  s.name = 'mysdk'
  s.version = '1.0.0'
  s.platform = :ios, '11.0'
  s.vendored_frameworks = 'mysdk.xcframework'
end

2. 在用户项目的Podfile中添加本地依赖：

pod 'mysdk', :path => './ThirdPartySDK'

后续用户更新SDK时，只需替换mysdk.xcframework，无需重新发布。

3. Podfile的post_install钩子配置 #

在用户项目的Podfile中添加post_install钩子，动态注入框架搜索路径：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 替换成你的RN封装库的Pod名称
    next unless target.name == 'YourRNWrapperLibrary'
    
    target.build_configurations.each do |config|
      # 添加SDK所在目录到框架搜索路径
      config.build_settings['FRAMEWORK_SEARCH_PATHS'] = '$(inherited) "${PROJECT_DIR}/ThirdPartySDK"'
      # 强制链接该框架
      config.build_settings['OTHER_LDFLAGS'] += ' -framework mysdk'
    end
  end
end

用户只需将XCFramework放在ios/ThirdPartySDK目录下，执行pod install即可自动配置。

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