You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何更新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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 06:30:44