SwiftPM依赖过时问题：Jenkins CI无法拉取SDK最新develop分支代码

问题背景 #

我有一个存储在独立Git仓库中的Swift Package项目（简称SDK，无Xcode项目），通过Xcode为Showcase App添加该SDK作为依赖，配置为跟踪develop分支，用于QA团队测试SDK的最新开发版本。本地环境下，右键点击Showcase中的Package选择Update Package就能正常获取最新代码，但在Jenkins CI环境中，xcodebuild命令行工具始终拉取旧版本代码，无法识别develop分支的变更。

已尝试的解决方案 #

• 将Package.resolved从Git索引移除并加入.gitignore，确保克隆代码后不存在该文件
• 构建前删除~/Library/Cache/org.swift.swiftpm和~/Library/org.swift.swiftpm缓存目录
• 每次构建前删除Jenkins构建任务的旧工作区
• 使用Fastlane工具，通过cloned_source_packages_path: "SourcePackages"将克隆的源码包路径指定到工作区内，生成的xcodebuild命令为：

  xcodebuild -resolvePackageDependencies -scheme ScannerShowcase -project ScannerShowcase.xcodeproj -configuration Release -clonedSourcePackagesDirPath SourcePackage
  

可行的解决方向 #

1. 强制xcodebuild刷新依赖 #

在xcodebuild命令中添加-refresh参数强制忽略本地缓存，同时指定使用最新的SwiftPM版本处理依赖：

xcodebuild -resolvePackageDependencies -scheme ScannerShowcase -project ScannerShowcase.xcodeproj -configuration Release -clonedSourcePackagesDirPath SourcePackage -refresh -package-manager-version latest

-refresh会让SwiftPM重新拉取远程分支的最新状态，避免依赖本地缓存的旧版本。

2. 清理更全面的缓存目录 #

除了用户目录的SwiftPM缓存，还需要清理Xcode的DerivedData目录，避免残留的编译缓存影响：

# 清理所有相关缓存
rm -rf ~/Library/Caches/org.swift.swiftpm
rm -rf ~/Library/org.swift.swiftpm
rm -rf "$HOME/Library/Developer/Xcode/DerivedData"

同时确认Jenkins工作空间的清理规则包含隐藏文件和子目录，确保每次构建都是完全干净的环境。

3. 动态指定分支最新Commit哈希（临时应急方案） #

如果上述方法无效，可以在构建脚本中动态获取develop分支的最新Commit哈希，并替换Xcode项目中的依赖配置：

# 获取SDK仓库develop分支的最新Commit哈希
SDK_LATEST_COMMIT=$(git ls-remote git@your-sdk-repo-url.git develop | cut -f1)
# 替换Xcode项目文件中的分支配置为Commit哈希
sed -i '' "s/develop/$SDK_LATEST_COMMIT/g" ScannerShowcase.xcodeproj/project.pbxproj

这种方式能强制拉取指定的最新代码，但需要维护脚本，适合临时应急使用。

4. 检查Xcode项目的依赖配置细节 #

打开Showcase的Xcode项目，确认SDK依赖的配置是否正确：

• 确保依赖的"Requirement"设置为Branch: develop，而非版本范围（比如"Up to Next Major Version"）
• 手动检查project.pbxproj文件中SDK依赖的条目，确认requirement字段是branch: develop，没有被自动添加的版本约束覆盖

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