用途:该技能用于在 Xcode 项目构建失败时,优先排查依赖解析问题(CocoaPods、SPM、框架冲突),其核心观点是多数持续性构建失败源于依赖解析而非代码缺陷。
主要能力:覆盖 SPM 包缓存清理与框架搜索路径诊断、CocoaPods 的 Podfile.lock 冲突与链接错误排查、“Multiple commands produce”重复目标成员问题定位、框架版本冲突与依赖图分析、Debug 与 Release 构建差异对比、以及工作区(workspace)与工程(project)误用等常见问题。
必要用法:出现“No such module”后先重置包缓存并重新解析,例如 swift package reset、xcodebuild -resolvePackageDependencies、xcodebuild clean build -scheme YourScheme;CocoaPods 问题可查看 cat Podfile.lock 与 cat Podfile,必要时 pod deintegrate && pod install 并打开 .xcworkspace;SPM 依赖可用 swift package show-dependencies 与 cat Package.resolved;框架搜索路径可用 xcodebuild -showBuildSettings -scheme YourScheme | grep FRAMEWORK_SEARCH_PATHS 检查。文档还提供版本锁定、版本范围、fork 与 pin、排除传递依赖等策略。
适用场景:本地与 CI 构建不一致、添加依赖后编译失败、Pod 安装成功但构建失败、App Store 构建与本地构建结果不同等。
限制:资料未提供该技能的安装方式、收费、价格与平台支持信息;文档中引用的具体版本示例与命令需结合实际项目验证,不应直接照搬。