如何更新CocoaPods(pods)关联适配的Xcode版本?
Xcode 14 升级后 CocoaPods 版本识别异常修复方案
问题现象
升级Xcode到14版本后相关功能异常,执行pod env查看环境信息时,CocoaPods识别到的Xcode版本仍为旧版13.4.1,环境信息如下:
CocoaPods : 1.11.3 Ruby : ruby 2.6.9p207 (2021-11-24 revision 67954) [universal.arm64e-darwin22] RubyGems : 3.0.3.1 Host : macOS 13.0 (22A5286j) Xcode : 13.4.1 (13F100) Git : git version 2.32.1 (Apple Git-133) Ruby lib dir : /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib Repositories : trunk - CDN - https://cdn.cocoapods.org/
问题参考截图:
修复步骤
1. 修正系统默认关联的Xcode路径
CocoaPods读取的是系统全局绑定的Command Line Tools对应Xcode版本,升级后未更新绑定路径就会出现识别旧版本的问题,两种操作方式二选一即可:
- 图形界面操作:打开Xcode 14,点击菜单栏
Xcode->Settings(低版本Xcode为Preferences),切换到Locations标签页,在Command Line Tools下拉菜单中选中已安装的Xcode 14对应条目,等待系统配置完成。 - 命令行操作(适合多Xcode版本共存场景):终端执行以下命令,默认Xcode14安装在应用程序目录时可直接使用,自定义了安装路径的替换为实际路径即可:
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
执行后按提示输入开机密码,输入过程终端不显示字符为正常现象,输入完成回车即可。
2. 验证系统Xcode绑定是否生效
终端执行命令校验:
xcodebuild -version
输出内容显示为Xcode 14开头的版本信息,即代表系统层面的Xcode关联配置正确。
3. 升级兼容Xcode14的CocoaPods版本
当前使用的1.11.3版本CocoaPods存在Xcode14兼容问题,需升级到1.12及以上稳定版本:
- RubyGems安装的CocoaPods执行以下命令升级:
sudo gem install cocoapods -v 1.12.1
- Homebrew安装的CocoaPods执行以下命令升级:
brew upgrade cocoapods
升级完成后进入项目根目录,清理旧的依赖缓存后重新集成:
pod deintegrate pod install --repo-update
4. 最终校验
在项目目录执行pod env,查看输出的Xcode字段已显示为14版本,重新编译项目确认异常消失即修复完成。
内容的提问来源于stack exchange,提问作者fonzyara
相关产品推荐
相关产品推荐

