MacOS 10.15.6 最新安装 Cocoapods 教程及问题解决

一、概念理解

首先不要急着搜索终端命令，你需要明白安装 cocoapods 都需要什么环境，这对于安装途中如果遇到问题该如何解决很重要，很重要，很重要！

1、安装pods需要依赖 ruby 环境，而安装 ruby 你需要借助工具 rvm，rvm是用来管理 ruby 版本的，也就是说你的电脑上可以安装多个不同版本的 ruby 可以使用 rvm 来管理他们。而安装 rvm 又需要借助另外一个工具 Homebrew，Homebrew是一款Mac OS平台下的软件包管理工具，拥有安装、卸载、更新、查看、搜索等很多实用的功能。这里不对 Homebrew 做过多讲解。

2、所以看完了上面，大概的安装步骤就已经很明确了—— 首先安装Homebrew --> 再安装rvm --> 再安装ruby -> 最后安装cocoapods。

二、进入正题

1、安装Homebrew

首先打开终端输入下面命令检测是否已经安装了 Homebrew ：

 

brew list

如果终端有输出一些文件名，证明已经安装过了Homebrew这个时候你可以直接跳到第2步，如果显示 brew not Fond 之类的提示就需要安装Homebrew。Homebrew安装成功如下图：

image.png

安装 Homebrew，终端输入以下命令：

 

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

这里注意最好去Homebrew官网copy命令，因为命令可能会改变，官网地址：https://brew.sh

2、安装 Rvm

如果 Homebrew 已经安装成功，接下来安装Rvm，首先检查是否已安装过Rvm，输入下面命令：

 

rvm -v

如果提示 rvm 1.29.9 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io] 证明已经安装了Rvm可以直接进行第3步，否则需要安装Rvm。本文遇到“-bash: rvm: command not found”，证明rvm 并未安装。

安装 Rvm，终端输入以下命令：

 

curl -L get.rvm.io | bash -s stable
//执行以上命令后，出现curl: (7) Failed to connect to raw.githubusercontent.com port 443: 
//Connection refused
//则修改host文件，重新执行curl -L get.rvm.io | bash -s stable命令，反之直接执行指定源的命令。

修改host 文件，终端输入以下命令行：sudo vi /etc/hosts,在host文件中加入以下的IP地址配置，如下所示：

 

sudo vi /etc/hosts

 

52.74.223.119 github.com
192.30.253.119 gist.github.com
54.169.195.247 api.github.com
185.199.111.153 assets-cdn.github.com
151.101.76.133 raw.githubusercontent.com
151.101.108.133 user-images.githubusercontent.com
151.101.76.133 gist.githubusercontent.com
151.101.76.133 cloud.githubusercontent.com
151.101.76.133 camo.githubusercontent.com
151.101.76.133 avatars0.githubusercontent.com
151.101.76.133 avatars1.githubusercontent.com
151.101.76.133 avatars2.githubusercontent.com
151.101.76.133 avatars3.githubusercontent.com
151.101.76.133 avatars4.githubusercontent.com
151.101.76.133 avatars5.githubusercontent.com
151.101.76.133 avatars6.githubusercontent.com
151.101.76.133 avatars7.githubusercontent.com
151.101.76.133 avatars8.githubusercontent.com

（1）输入本机密码后，打开hosts文件，键盘输入 i （插入），修改hosts文件后，按 esc 键退出,再按shift+：键，再输入w和q，保存退出

（2）不保存退出，则按q和!键
指定源：

 

source ~/.rvm/scripts/rvm

检查安装是否成功：

 

rvm -v
// 安装成功
// rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]

3、安装 Ruby

在确保已经安装了 Rvm 之后，利用 Rvm 安装 Ruby：

 

rvm list known           // 查看ruby版本列表 最好更新到最新的
rvm install 2.6.3        // 安装2.6.3版本（安装最新的或者次新的版本即可）

执行后，可能会出现（1)、（2）问题按照对应方式解决即可
（1）错误：Error running 'requirements_osx_brew_libs_install autoconf automake libtool pkg-config libyaml readline libksba openssl',如图：

image.png

 

　这个时候不要慌，上面提示的大概意思是在安装autoconf、automake、libtool、。。。、openssl时出现了错误，因为这些依赖文件有的比较大其中最大的大概有300M左右，所以如果你的网络不好下载很容易超时，这里建议电脑连接手机热点下载，亲测可行速度比较快。接下来我们就手动一步一步来安装这些依赖文件。终端依次执行：

 

brew install autoconf
brew install automake
brew install libtool
brew install libyaml
brew install libxslt
brew install libksba
brew install openssl

执行完这些命令，该下的依赖已经下载的差不多了，然后再执行一次 rvm install 2.7.0，如果有没下载到的依赖文件也不要担心，当再次执行 rvm install 2.7.0 时系统会自动检测你缺少哪些依赖会自动下载的。然后你就会发现终端开始自动跑命令行，这时候是不是很开心，终于要成功了，内心一阵笑嘻嘻，然而现实总是让人忍不住来一句MMP，在最后关头又特么出了差错啦，啊啊啊啊啊啊。。。

报错显示：Error running '__rvm_make -j 1

不要慌，兵来将挡水来土掩嘛。接着往下看，一般出现这种情况是因为你的 xcode command line 出了问题，要么没有安装要么版本不对。知道问题了就解决呗，终端输入：

 

xcode-select --install

然后再执行 rvm install 2.7.0，这个时候随着终端里代码不断跑动，终于看到了一片祥和的绿色（从来没有像现在这样喜欢这个颜色 =_=）。

(2)错误：Error running './configure --prefix=/Users/celery/.rvm/rubies/ruby-2.7.0 --with-opt-dir=/usr/local/opt/libyaml:/usr/local/opt/libksba:/usr/local/opt/readline:/usr/local/opt/zlib:/usr/local/opt/openssl@1.1 --disable-install-doc --enable-shared',
please read /Users/celery/.rvm/log/1600842732_ruby-2.7.0/configure.log
There has been an error while running configure. Halting the installation.

image.png

解决方式：终端输入

 

xcode-select --install
//有可能会安装失败，服务器找不到这个command line developer tools 工具包，这是就得去开发者中心下载了
//具体参照https://blog.csdn.net/wenyicodedog/article/details/96195353

 

image.png

 

下载安装command line developer tools后，终端输入:

 

rvm install 2.7.0

成功如下图：

image.png

最后说一下安装 Ruby 时一定要沉得住气，终端在下载资源或者提示你 please wait 时，一定要耐心等待，而且一定不能让电脑自动休眠，不能让电脑自动休眠，不能让电脑自动休眠！

如果做了这么多你发现还是有错误就是安装不成功Ruby，没关系那就回到最初的起点（又回到最初的起点，记忆中你青涩的脸。。。），卸载RVM，重新安装!

记得要关闭终端重新打开，输入以下命令卸载 Rvm：

 

sudo rm -rf .rvm .rvmrc   /etc/rvmrc ;gem uninstall rvm

卸载完之后，按照上面的步骤从第2步开始再来一遍。
4、安装 Cocoapods
接下来一定要注意！注意！注意！

如果你的 Mac系统是 10.11 之前，输入：

 

sudo gem install cocoapods

如果你的 Mac系统是 10.11 之后，输入：

 

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

这篇教程说的是 MacOS 10.15.6的系统当然要选择：sudo gem install -n /usr/local/bin cocoapods 了。

等待终端跑完，你是不是迫不及待的想看看你的 pods 安装成功了没，所以你迅速的输入了 pod search AFNetworking，看看是不是成功了，如若不成功，看下是否出现以下错误，报错如下：对应解决。

 

pod search AFNetworking
//[!] Unable to find a pod with name, author, summary, or description matching `AFNetworking`

这是因为虽然你 pods 是安装成功了，但是 .cocoapods/repos 库本地还没有，当然搜索不到了，所以需要执行最后一步：

 

git clone https://git.coding.net/CocoaPods/Specs.git ~/.cocoapods/repos/master

耐心等待终端下载完成，再试试 pod search AFNetworking 。perfect！！！