# 升级 Xcode 到 13+ 版本
升级 flutter 后
运行 flutter doctor
提示要升级 Xcode
# 选择适合的 Xcode 版本
升级前，查看当前机器系统版本
选择对应的 Xcode 兼容版本
这一步非常关键，接下来决定下载哪个版本 Xcode
通常一个策略是，下载当前系统支持的最新版本 Xcode
我的系统版本是 MacOS Monterey 12.6.4 版本
对照上面图片选择 Xcode Version 14.2 版本
为什么要选择系统支持最新版本，避免选择低版本的 Xcode
安装时出现 Xcode_xxx.xx 文件损坏，无法安装
网上教程也是一堆，一顿操作解决不了什么问题
Xcode 本身 10GB 左右，下载半天，安装不了，非常闹心
# 下载 Xcode
官网打开 Xcode (opens new window) 显示的是最新版本
由于下载是旧的版本，下载地址 (opens new window)
地址中包含的所有的 Xcode 版本，输入搜索慢慢查找就行
Xcode 14.2 版本有两个： Xcode 14.2 Release Candidate 与 Xcode 14.2
选择后者即可
下载的小技巧，使用 Firefox 下载
Chrome 浏览器下载，如果网络波动导致下载被取消
后果就是辛苦下载了几个 GB 的文件还要重新下载
过来人，听我的没错
如果家庭网络波动，偶尔断线，注意手动点击重试
# 安装 Xcode
这一步没什么好说的，双击 xxx.xip 包开始安装
耐心等待，到这一步基本算是成功了
# 必要时要升级下系统
Xcode 版本与机器系统绑定的
意思是 Xcoce 最新版本无法兼容老的系统
可以参考Xcode 兼容版本对照表 (opens new window) 决定是否要升级系统
通常大概率要升级，给电脑插上电源，耐心等待即可
# 升级 ruby
Mac OS 系统，自带 ruby 版本是 2.6.8
flutter 开发或 React Native 开发前要升级下版本
不升级，当命令行 sudo gem install cocoapods -v 1.10.0 -V 升级 cocoapods 时
可能报如下报错：
Could not find a valid gem 'cocoapods' (1.10.0)，Possible alternatives: cocoap
导致按官方手册 cocoapods 无法升级到最新版本
这就很 emm...
所以先升级 ruby 是必要的
# 安装 ruby 版本管理工具 rbenv
# 安装 ruby 最新版本或指定版本
我的是 3.1.2 版本
rbenv install 3.1.2
# 设置 ruby 版本
rbenv local 3.1.2
rbenv global 3.1.2
当重启 shell 输入 ruby -v 时发现版本并未更新过来
其实 rbenv 版本管理未生效
# 配置 rbenv，让版本管理生效
命令行中输入 echo $0 查看当前使用的 shell
我用的是 zsh
打开 ~/.zsrc
添加配置
# Include rbenv for ZSH
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
2
3
重启 shell 生效
其他的 shell 配置参考 (opens new window)
# Mac 运行cocoapods 出现 Could not find ‘ffi‘ (＞= 1.2.0) among 86 total gem(s) (Gem::MissingSpecError)
开始尝试着安装 ffi 依然报错
版本兼容问题
如此可以先卸载 cocoapods 重新安装
CocoaPods 是 Swift 和 Objective-C Cocoa 项目的依赖管理器
iOS 开发需要它
# 第一种卸载方式
sudo gem uninstall -aIx
rm -rf ~/.gem
sudo gem install cocoapods
2
3
# 第二种卸载方式
# 卸载
sudo gem uninstall cocoapods
# 列表所有 cocoapods 开头包
gem list --local | grep cocoapods
# 将上述 cocoapods 开头包全部删除
sudo gem uninstall cocoapods-xxx
2
3
4
5
6
7
8
9
# 重新安装
sudo gem install cocoapods
默认安装最新版本
也可以指定安装版本
sudo gem install cocoapods -v 1.12.0 -V
# 查看安装成功
pod --version
# ruby 包镜像源
ruby 通过 gem 安装各种依赖包时
默认的源地址是 https://rubygems.org/
大概率被墙
国内有一些比较好的镜像源可使用，个人推荐使用 ruby-china
- ruby-china: https://gems.ruby-china.com/
- 清华源：https://mirrors.tuna.tsinghua.edu.cn/rubygems/
- 科大源：https://mirrors.ustc.edu.cn/rubygems/
更新源地址如下：
# 查看当前源
gem sources -l
# *** CURRENT SOURCES ***，是官方源
# https://rubygems.org/
# 新增源，使用 ruby-china，sources 复数
gem sources --add https://gems.ruby-china.com/
# 移除官方源
gem sources --remove https://rubygems.org/
# 再次查看源是否更新成功
gem sources -l
2
3
4
5
6
7
8
9
10
11
12
13
14
两点注意：
- 源更换结果只保留一条
- 先新增后删除，避免操作报错
# 小结
开发不难
各种环境的安装调式
文件的配置最闹心
所以时常保持更新很重要
扫一扫，微信中打开
