SuperAPI AI 工具集

axiom-build-debugging

测试与质量

查看项目

更新于 10-15 20:11

技能介绍

用途:用于排查 Apple 平台(Xcode)构建失败,核心原则是约 80% 的持续性构建失败源于依赖解析问题(CocoaPods、SPM、框架冲突),而非代码缺陷。

主要能力:覆盖 SPM 包解析流程、包缓存清理与框架搜索路径诊断;识别重复 target 成员导致的“Multiple commands produce”;CocoaPods 的 Podfile.lock 冲突、链接错误与版本约束调试;本地与 CI 构建差异、依赖缓存差异;复杂依赖树的版本冲突分析与解析策略。

典型用法:SPM 报“No such module”时,先清理缓存再解析,例如 rm -rf ~/Library/Developer/Xcode/DerivedData、rm -rf ~/Library/Caches/org.swift.swiftpm,然后 xcodebuild -resolvePackageDependencies,再 xcodebuild clean build -scheme YourScheme。CocoaPods 冲突时查看 Podfile.lock 与 Podfile 版本,必要时删除 Pods/ 与 Podfile.lock 后 pod install,并打开 .xcworkspace 而非 .xcodeproj。SPM 版本冲突可用 swift package show-dependencies、cat Package.resolved,并清理 .build 与 Package.resolved 后 swift package resolve。

适用场景:新增 Swift Package 后无法编译、pod install 成功但构建失败、同一文件被多个 target 包含、框架搜索路径缺失、Debug 与 Release 行为不一致、本地通过而 CI 或 App Store 构建失败。

限制与注意:资料未提供具体收费、平台支持范围或效果保证。技能强调在时间压力下不要盲目执行“快速修复”,应先对比可用构建与失败构建的版本、Xcode 与 CocoaPods 版本等证据;建议提交 lockfile、避免使用无版本约束的依赖、不要混用多个包管理器。