xcodebuild -resolvePackageDependencies作用及SPM与CocoaPods共存管理咨询

一、xcodebuild -resolvePackageDependencies的作用和查找逻辑 #

核心作用 #

这条命令是让Xcode完成Swift Package Manager（SPM）依赖的解析工作：

• 生成或更新Package.resolved文件，精确记录每个SPM依赖的实际使用版本（包含commit哈希）
• 确保所有指定的SPM依赖被下载、编译，并匹配项目配置的平台（iOS Simulator）、构建模式（Release）要求
• 验证依赖之间的兼容性，避免版本冲突

查找逻辑 #

1. 读取指定的Inji.xcworkspace和Inji scheme中的SPM配置，包括所有依赖的仓库地址、版本规则（tag、分支、commit哈希等）
2. 根据版本规则从远程仓库拉取对应依赖，检查是否支持指定的平台和构建配置
3. 确定所有依赖的最终兼容版本，写入Package.resolved文件，确保后续构建使用一致的依赖版本

二、为什么pod install会删除Package.resolved？ #

这是CocoaPods的默认行为：早期SPM与CocoaPods兼容性较差，CocoaPods在执行pod install时会重置Xcode的SPM相关配置，包括删除Package.resolved。虽然现在两者兼容性有所提升，但这个默认行为仍未完全移除。

三、CI环境下同时管理SPM与CocoaPods的解决方案 #

要解决Package.resolved被删除或反复生成的问题，按以下步骤操作：

1. 修改CocoaPods配置，保留Package.resolved #

在项目的Podfile开头添加官方支持的配置（CocoaPods 1.10+可用），禁止CocoaPods删除Package.resolved：

install! 'cocoapods', :preserve_package_resolved => true

如果使用低于1.10的CocoaPods版本，建议升级到最新稳定版；若无法升级，可在CI脚本中先备份Package.resolved，执行pod install后再恢复：

# CI脚本中执行
cp Package.resolved Package.resolved.backup
pod install --repo-update
cp Package.resolved.backup Package.resolved

2. 固定SPM依赖版本 #

确保项目中添加的SPM依赖使用精确版本规则：

• 优先指定固定tag（如~> 1.2.3或1.2.3）
• 或直接指定具体的commit哈希
  避免使用upToNextMajor这类模糊版本规则，防止每次解析生成不同的Package.resolved内容。

3. 统一CI流程的依赖解析顺序 #

在CI脚本中先执行SPM依赖解析，再执行pod install，确保Package.resolved先被生成并保留：

# 第一步：解析SPM依赖，生成/更新Package.resolved
xcodebuild -resolvePackageDependencies -workspace ./Inji.xcworkspace -scheme Inji -configuration Release -destination "generic/platform=iOS Simulator"

# 第二步：执行CocoaPods安装，此时不会删除Package.resolved
pod install --repo-update

4. 将Package.resolved纳入版本控制 #

把Package.resolved添加到Git仓库并提交，确保CI环境和本地开发环境使用完全一致的SPM依赖版本，避免每次拉取代码后重新解析生成不同的文件。

内容的提问来源于stack exchange，提问作者Abhishek Paul abhi