Unity项目构建iOS时CocoaPods安装失败的解决办法

1. 彻底清理CocoaPods残留 #

之前的重装可能没清干净残留文件，按顺序执行以下命令：

• 卸载所有CocoaPods版本：sudo gem uninstall cocoapods，出现版本选择时输入y确认卸载全部
• 删除CocoaPods本地仓库：rm -rf ~/.cocoapods
• 清理Ruby Gem缓存：gem cleanup

2. 安装Unity兼容的CocoaPods稳定版 #

最新版CocoaPods可能和Unity版本不兼容，推荐安装1.11.3版本：

• 安装指定版本：sudo gem install cocoapods -v 1.11.3
• 初始化Pod仓库（过程可能耗时，别中断）：pod setup

3. 重置Unity的依赖管理器设置 #

• 打开Unity，进入Window > Package Manager，找到External Dependency Manager（旧版叫Play Services Resolver）
• 进入插件设置，确认iOS Resolver下的Use CocoaPods已勾选，Podfile Generation设为Automatic
• 点击Force Resolve，让Unity重新解析并生成依赖配置

4. 清理Unity项目缓存 #

• 关闭Unity，删除项目根目录下的Library、Temp、Obj三个文件夹
• 重新打开Unity，重新执行iOS构建流程

5. 修复Xcode签名问题 #

构建完成后如果Xcode仍无法管理签名：

• 打开生成的Xcode项目，切换到Signing & Capabilities标签页
• 先取消勾选Automatically manage signing，稍等几秒后重新勾选
• 确认Team选择正确，Bundle Identifier没有重复或不符合Apple命名规则

6. 手动在Xcode项目中执行Pod安装 #

如果以上步骤都无效，尝试手动补全Pod依赖：

• 打开终端，导航到Xcode项目所在文件夹：cd /你的项目构建路径/iOS
• 执行Pod更新安装：pod install --repo-update
• 安装完成后，打开项目的.xcworkspace文件（不要打开.xcodeproj）进行后续操作

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