自研React Native组件包集成Carthage依赖编译失败如何解决

你遇到的问题核心原因是create-react-native-library生成的组件包配置完全由根目录下的.podspec文件驱动，不需要手动修改组件自身的Xcode项目配置，手动配置的参数也不会在下游集成时生效，按以下步骤操作即可：

步骤1：整理Carthage构建产物 #

在组件包的ios目录下执行Carthage更新构建命令，确认生成所需xcframework后，在ios目录下新建Vendor文件夹，将Carthage/Build下所有需要用到的xcframework全部移入Vendor文件夹中。
如果需要下游用户集成时自动执行Carthage构建，可以跳过文件移动，后续在podspec中配置构建命令即可

步骤2：修改组件包根目录的.podspec配置 #

在podspec中添加以下配置项，关联Carthage生成的依赖：

• 添加第三方xcframework引用：

s.vendored_frameworks = 'ios/Vendor/*.xcframework'
# 如果没有移动xcframework，路径写为 'ios/Carthage/Build/**/*.xcframework'

• 添加框架搜索路径配置，确保编译时能找到依赖：

s.xcconfig = {
  'FRAMEWORK_SEARCH_PATHS' => '"${PODS_TARGET_SRCROOT}/ios/Vendor"',
  # 如有需要可添加额外编译参数，例如依赖要求加-ObjC标记：
  # 'OTHER_LDFLAGS' => '-ObjC'
}

• 对齐依赖要求的基础配置：
  确认podspec中的iOS、tvOS部署版本和你之前原生项目的部署版本保持一致，如果依赖是动态框架，添加配置s.static_framework = false，静态框架则设为true。
• 可选配置：如果不想把xcframework上传到Git仓库，可以添加自动构建命令，下游集成时会自动执行Carthage构建：

s.prepare_command = 'cd ios && carthage update --platform ios,tvos --use-xcframeworks'

注意该配置要求下游用户本地安装有Carthage环境，否则会集成失败

步骤3：验证集成效果 #

进入示例项目的ios目录，执行pod install，Xcode会自动根据podspec配置关联所有Carthage依赖，无需手动添加框架，直接编译示例项目即可验证是否正常工作。

常见问题排查 #

• 如果报依赖找不到的错误，优先检查vendored_frameworks的路径是否正确，路径为相对于podspec所在根目录的相对路径
• 如果报架构缺失错误，检查Carthage构建命令是否指定了所有需要支持的平台，和podspec中配置的支持平台保持一致

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