CocoaPods安装方法(2021最新版)

article/2025/9/22 10:06:54

CocoaPods简介:

CocoaPods是一个用Ruby写的、负责管理iOS项目中第三方开源库的工具，CocoaPods能让我们集中的、统一管理第三方开源库，为我们节省设置和更新第三方开源库的时间。

CocoaPods安装:

下面就正式开始安装CocoaPods，命令中间可能有空格看不出来，建议直接复制粘贴执行；

因为Mac电脑自带Ruby环境，我们就只需打开终端开始动手。然而又因为默认情况下我们mac系统自带的Ruby环境版本比较低（大概是2.0.0或者其他较高版本），但是现在安装CocoaPods需要2.2.2版本及以上的，所以我们不管三七二十一先直接先升级ruby。

打开终端：>_

1、查看当前Ruby版本

执行：
ruby -v

结果：

ruby 3.0.0p0 (2020-12-25 revision 95aff21468) [x86_64-darwin20]

2、升级Ruby环境，首先需要安装rvm（第一步要下载一些东西等两分钟左右）

curl -L get.rvm.io | bash -s stable source ~/.bashrcsource ~/.bash_profile

3、查看rvm版本

rvm -v

显示如下(或者是其他版本)

rvm 1.29.12 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]

4、列出ruby可安装的版本信息

rvm list known

显示如下

# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.8]
[ruby-]2.4[.10]
[ruby-]2.5[.8]
[ruby-]2.6[.6]
[ruby-]2.7[.2]
[ruby-]3[.0.0]
ruby-head
.....

5、安装Homebrew

已安装的可跳过。
这里很多小伙伴会遇到错误，大多是因为网络问题，多试几次就好了，实在不行就切换网络；人品不行的就放弃吧；

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

6、安装一个ruby版本

// 安装 （这里我选择的是3.0.0版本，当然你也可以选择其他的）
rvm install 3.0.0
// 注意:安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行);
// 如果你电脑没有安装Xcode和Command Line Tools for Xcode以及Homebrew 会自动下载安装,建议提前安装这三者.// 设为默认
rvm use 3.0.0 --default

7、更换源

sudo gem update --systemgem sources --remove https://rubygems.org/gem sources --add https://gems.ruby-china.com/

8、验证你的Ruby镜像是并且仅是ruby-china

gem sources -l

如果是以下结果说明正确，如果有其他的请自行百度解决

*** CURRENT SOURCES ***https://gems.ruby-china.com/

9、这时候才正式开始安装CocoaPods

sudo gem install -n /usr/local/bin cocoapods

10、如果安装了多个Xcode使用下面的命令选择（一般需要选择最近的Xcode版本

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer

11、安装本地库（请先把下面的内容看完）

pod setup

执行以上命令后

Setting up CocoaPods master repo$ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progressCloning into 'master'...remote: Counting objects: 1879515, done.        remote: Compressing objects: 100% (321/321), done.        Receiving objects:  21% (404525/1879515), 73.70 MiB | 22.00 KiB/

然后就是漫长的等待，当然,网络好的情况下会更快

说明：该步骤是安装本地库，不安装也没事，项目可以照常pod install。
只不过不安装的话就不能使用pod search 命令了；如果你追求完美那就继续往下看；

git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
注意：
注意：
注意：
重要的事情要重申：使用这个命令执行等待一段时间之后大有可能会失败，
原因基本是网络问题，
请不要着急，
根据自己和小伙伴的多次测试，
只有在使用移动手机网络或者在凌晨的时候网速才会理想
（大概几分钟就OK，其他情况下即使你的网络带宽很好也没用）如果你晚上熬不住，早上起不来，手机流量又没了，那就往下看吧！哎。。。。。。。

或者使用下面的，国内镜像，速度刚刚的

git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git  ~/.cocoapods/repos/trunk

目录结构见下图,如果不是就自己手动移动一下

如果还不行

// 安装最新版cocoapods
sudo gem install cocoapods --pre
// 移除本地master
sudo rm -fr ~/.cocoapods/repos/master
// 移除本地缓存
sudo rm -fr ~/Library/Caches/CocoaPods/
// 重新setup，如果很慢可使用问题1的解决方法（git clone）
pod setup --verbose
// 移除trunk
pod repo remove trunk

可以参考：

CocoaPods｜安装流程与使用（macOS-Mojave）

如果一直安装不成功请参考这里

以下一段忽略,直接看第13步:

要查看文件下载进度的可以另外打开一个终端窗口(快捷键:选中终端按下Command+N组合键)，输入以下两行命令回车执行