安装ruby
注意:本人是通过HomeBrew进行安装更新的ruby,如果已经使用其他方式(rvm)安装过ruby,可跳过该步骤,或者卸载当前版本的ruby,进行重新安装。因为如果系统中存在多个方式安装ruby,可能会导致cocoapods 安装异常
更新软件源可根据实际情况选择是否更新,如果安装完成HomeBrew之后不需要执行该操作,或者直接执行安装命令根据是否报错选择如下命令
# 更新软件包
brew update-reset
# 安装ruby
brew install ruby
ruby安装验证
# 验证安装版本
ruby --version
使用Ruby gem 安装 cocoapods
第一步:验证是否已经安装 cocoapods
gem list |grep cocoapods
# 查看软件包安装位置
gem list --details
# 如果 已有版本不符合预期,先卸载cocoapods在安装
gem uninstall cocoapods
第二步:安装cocoapods
sudo gem install cocoapods
安装cocoapods时会展示安装的版本,使用如下命令验证是否安装成功
验证:
# 查询安装版本
gem list|grep cocoapods
# 验证 pod命令是否正常
pod --version
如果 验证pod的版本和自己安装版本不对应时,需要替换系统pod命令,执行如下步骤
# 步骤1:查看当前Pod 安装位置
which pod # 输出 /usr/local/bin/pod
# 步骤二: 保存老版本pod
mv /usr/local/bin/pod /usr/local/bin/pod_old
# 步骤三: 查看自行安装的cocoapods 路径 Installed at 为安装路径
gem list --detail|grep -A 8 cocoapods
# 步骤四: 更新新版本pod
ln -s /usr/local/lib/ruby/gems/3.2.0/bin/pod /usr/local/bin/pod
# 步骤五: 验证是否正取
pod --version
问题解决
如果通过如下命令获取的cocoapods版本和自行安装的版本不对应时可进行如下问题排查
# 查询安装版本
gem list|grep cocoapods
上诉问题大概率是因为系统中装了多个ruby,导致gem命令,以及gem环境参数错乱,如果是因为gem参数错乱导致的问题,可按照如下步骤进行解决,其他问题需要自行结合自己的实际情况处理
# 步骤1:验证是否安装了多个版本ruby
gem env # 查看配置是否存在多个ruby,然后验证配置是否混乱,标志位多个版本的 ruby路径
# 步骤2:验证gem list 中的cocoapods 安装路径以及安装在哪个Ruby库下
gem list --detail
# 或者
sudo find / -name cocoapods
# 步骤3: 删除除系统ruby之外的ruby版本
# 自行查找删除
# 步骤4: 重启终端
# 步骤5: 再次通过如下命令验证达到正常效果
gem list|grep cocoapods