如何解决Xcode Cloud中SPM引入第三方库的构建失败问题？

核心排查与修复步骤 #

• 锁定SPM依赖版本
  避免使用不稳定的分支（如main），建议在Package.swift中指定具体tag或commit哈希，确保Xcode Cloud拉取的依赖版本与本地一致：

  // 指定tag版本
  .package(url: "https://github.com/Alamofire/Alamofire.git", from: "5.8.0")
  // 或锁定到具体commit
  .package(url: "https://github.com/Alamofire/Alamofire.git", .exact("a1b2c3d4e5f6g7h8"))
  

• 清理构建缓存
  在Xcode Cloud工作流设置中开启“清理构建缓存”，或在项目的ci_scripts目录添加预构建脚本：

  rm -rf ~/Library/Caches/org.swift.swiftpm
  rm -rf .build
  

• 验证权限与网络
  若依赖私有仓库，需在Xcode Cloud账户设置中添加对应SSH密钥/访问令牌；公开仓库确认构建机器可正常访问代码托管平台。

• 统一Xcode版本
  本地使用的Xcode版本必须与Xcode Cloud构建指定版本完全一致（含beta版本），不同版本对SPM的处理存在差异。

• 提交Package.resolved文件
  确保Package.resolved已提交至Git仓库，Xcode Cloud会依赖该文件拉取指定版本的依赖，避免版本解析不一致。

• 本地模拟CI构建
  用命令行模拟Xcode Cloud构建环境，复现问题方便排查：

  xcodebuild -scheme YourSchemeName -destination 'generic/platform=iOS' build
  

针对截图中模块构建失败的额外处理 #

截图显示Alamofire、Kingfisher等模块构建失败，可尝试：

• 检查依赖的平台要求，确保项目部署目标与依赖兼容。
• 本地删除DerivedData后重新构建，提交更新后的Package.resolved。

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