依赖CocoaPods库构建XCFramework时依赖未打包问题解决方案求助

共有两种可行方案，可根据你的业务场景选择： #

方案1：将所有CocoaPods依赖静态打包进XCFramework（推荐） #

该方案对客户端最友好，客户只需要集成你输出的XCFramework即可，不需要额外配置依赖。

操作步骤： #

1. 配置你的框架Target的构建设置：
   • Mach-O Type 设为 Static Library
   • 确认 BUILD_LIBRARY_FOR_DISTRIBUTION = YES （你当前脚本已经配置，保持即可）
   • Always Embed Swift Standard Libraries 设为 NO
2. 修改Podfile，增加post_install钩子，强制所有依赖的Pod也开启编译兼容配置，避免后续模块校验错误：

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

修改后执行pod install生效。
3. 保持你当前的xcodebuild归档、生成XCFramework的脚本即可，编译完成后所有依赖的Pod代码都会被打包进ABC.framework的二进制文件中，客户端直接集成XCFramework就能正常运行，不需要额外加依赖。 #

方案2：不打包依赖，由客户端自行引入对应第三方库 #

如果你的客户普遍也会用到相同的第三方库，为了避免包体积重复，可以选择该方案，但需要严格约束客户端的配置。

操作步骤： #

1. 你编译XCFramework时，Mach-O Type 设为 Dynamic Framework，且不要把依赖的Pod静态链接到你的二进制中。
2. 给客户提供的集成文档里必须明确标注所有依赖Pod的精确版本号，要求客户端Podfile必须引入完全相同版本的依赖，版本不一致会直接导致模块找不到或者运行时崩溃。
3. 客户端集成时除了引入XCFramework，需要做以下配置：
   • 在Framework Search Paths中添加ABC.xcframework的存放路径
   • 在Other Linker Flags中添加-ObjC参数

常见问题说明 #

• 单纯配置客户端的framework search path无法解决你的问题，错误的根本原因是依赖没有被打包进XCFramework，或者你编译用的依赖版本和客户端的版本/编译配置不一致。
• 不要使用Umbrella Framework方案，该方案存在签名冲突、App Store审核被拒等潜在风险，不符合苹果的官方推荐规范。

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