Github Actions iOS CI报错SkeletonView 1.4.2无Package.swift如何解决

问题根因 #

1. 你的CI流程指定使用的Xcode 11.3内置的Swift Package Manager存在版本解析逻辑bug，即使项目内显式指定了更高版本的SkeletonView，SPM仍会自动回溯拉取历史版本，最终误匹配到1.4.2版本
2. SkeletonView 1.4.2版本仅支持CocoaPods集成，未提供SPM所需的Package.swift文件，因此拉取到该版本时直接抛出解析错误

排查步骤 #

• 校验本地与CI的Xcode版本差异：本地若使用Xcode 12及以上版本，SPM已修复该版本回溯bug，因此本地构建正常，仅CI环境会复现问题
• 检查仓库内是否提交了Package.resolved文件：如果未提交该文件，CI每次执行构建都会重新解析所有依赖的版本，更容易触发该bug
• 本地执行带详细日志的依赖解析命令，排查依赖链：执行xcodebuild -resolvePackageDependencies -verbose，查看完整的依赖解析日志，确认是否有其他第三方包间接依赖了SkeletonView 1.4.2版本

解决方案 #

按落地成本从低到高排序：

1. 升级CI使用的Xcode版本
   修改CI配置中的Xcode选择命令，切换为12.4及以上版本即可修复SPM的版本解析bug，示例如下：

sudo xcode-select -switch /Applications/Xcode_12.4.app

如果业务场景必须使用Xcode 11.3，可参考以下方案
2. 显式锁定SkeletonView的版本
在项目的SPM依赖配置中，将SkeletonView的版本规则从「范围匹配」修改为「精确匹配具体可用版本」，强制SPM拉取指定版本，不会自动回溯旧版本
3. 提交Package.resolved文件到Git仓库
将本地正常构建生成的Package.resolved文件提交到仓库，CI执行依赖解析时会优先读取该文件的锁定版本，不会重新执行版本解析逻辑
4. 构建命令添加禁用自动版本解析参数
修改CI的xcodebuild命令，新增-disableAutomaticPackageResolution参数，强制SPM使用项目内配置的版本，不会自动更新或回溯版本，修改后命令示例：

xcodebuild clean build test -project sample/sample.xcodeproj -scheme "sample" -sdk iphonesimulator -destination "platform=iOS Simulator,name=iPad Pro (12.9-inch) (5th generation)" ONLY_ACTIVE_ARCH=NO CODE_SIGNING_REQUIRED=NO -disableAutomaticPackageResolution

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