在之前的一个项目安装过CocoaPods，当时使用的Xcode 7，Mac系统为OS X 10.11，安装流程顺利，可是在Xcode 8.0和macOS 10.12上安装遇到了一些问题，然后网上查询了一些相关资料，自己整理了一下新的安装步骤和流程。
众所周知，CocoaPods是iOS项目类库的管理工具，可以让开发者很方便集成各种第三方库，而不用去网站上逐一下载，再逐一将文件夹拖进项目中，还得添加相关的系统依赖库。开发iOS项目不可避免地要使用第三方开源库，CocoaPods的出现使得我们可以节省配置开源库的时间。
1. CocoaPods的安装步骤
在安装CocoaPods之前，首先要在本地安装好Ruby环境，默认情况下，Mac自带Ruby环境。因为Ruby的默认源rubygems.org使用的是亚马逊的云服务，在国内使用会被墙，所以需要更换一下Ruby的源。
- 2018.8.28 https://gems.ruby-china.org域名更新为https://gems.ruby-china.com
有时我们下载别人的代码运行时会报
diff: /../Podfile.lock: No such file or directory
diff: Manifest.lock: No such file or directory
error: The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.`
看到这个简直要崩溃了，那这个怎么解决呢，下面我给大家说下自己爬过的坑，
关闭当前的工作空间，删除掉文件夹中的workspace cd 到自己当前项目中，终端进行一下：
rm -rf GZDemo.xcworkspace
pod install
最后通过workspace打开工作空间，完美！
1.1 首先打开终端，输入以下命令符检查Ruby源
$ gem sources - l
如果你的镜像地址是如下图1-1所示：
图1-1
那么就需要替换Ruby源。
1.2 替换Ruby源，输入以下命令符，删除目前的Ruby源
gem sources --remove https://rubygems.org/
1.3 添加新的Ruby源，输入以下命令符：
gem sources -a http://rubygems-china.oss.aliyuncs.com
之前使用的是以下这个
gem sources -a https://ruby.taobao.org/
但是这个已经不维护了，请查看相关信息。
**1.4 添加新的Ruby源之后，可以查看是否替换成功 **
** **$ gem sources -l
成功就如图1-2所示：
到这里就算已经成功配置完环境了，下一步就是安装了。
1.5 安装CocoaPods，继续在终端输入命令：
macOS 10.12以下使用的是
sudo gem install -n /usr/local/bin/ cocoapods
OS X 10.11以上使用的是
sudo gem install cocoapods
1.6 等待以上命令符执行完毕，继续输入以下命令：
pod setup
出现如图1-3所示：
图1-3
出现Setting up CocoaPods master repo 后会卡住一段时间，
可以在新开一个终端的窗口，输入以下的命令，查看下载文件的大小。
du -sh
下载完毕后，所占磁盘的大小在894M左右。
1.7 下载成功，输入以下命令：
$ pod --version
可以看到安装成功cocoapods的版本。
当然我们也可以对cocoapods卸载重新安装**，输入以下命令：
sudo gem install -n /usr/local/bin cocoapods //安装
或者 $ sudo gem install cocoapods
cocoapods卸载重装的例子参考。如果升级已有的cocoapods，则输入以下命令：
$ sudo gem update cocoapods //升级cocoapods
查看本地安装过的cocoapods相关东西，命令如下：
$ gem list --local | grep cocoapods
- CocoaPods的使用
需要查看一下CocoaPods是否安装成功，这时只需在终端输入 *pod search +开源类库的名字 *回车即可。例如：
$ pod search AFNetworking
安装成功就会显示出相关的所有第三方开源类库。
2.1 怎么在项目中使用呢，首先需要在终端里面cd到项目文件夹里面，如下所示：
$ cd 项目文件夹路径 （可以直接把拖动项目文件夹到终端光标处，系统自动生成路径）
2.2 创建Podfile 文件
$ touch Podfile
2.3 编辑Podfile文件
$ vim Podfile
接下来，在Podfile文件里面进行书写
cocoapods版本1.0.1之前的：
pod 'AFNetworking','~>2.6.0' #设置框架的名称和版本号
cocoapods版本是1.0.1之后的：
platform :ios, '8.0' #用来设置所有第三方库所支持的iOS最低版本
target 'MyApp' do #MyApp 就是你的项目名
pod 'AFNetworking', '~> 3.1.0'
end
(版本号的规则：
'>1.0' 可以安装任何高于1.0的版本
'>=1.0' 可以安装任何高于或等于1.0的版本
'<1.0' 任何低于1.0的版本
'<=1.0' 任何低于或等于1.0的版本
'~>0.1' 任何高于或等于0.1的版本，但是不包含高于0.1的版本
'~>0' 任何版本，相当于不指定版本，默认采用最新版本号)
编辑Podfile文件之后， 按 i 可编辑 ，esc 退出编辑，:wq 可保存退出,:q 不保存退出。扩展Podfile语法参考
2.4 安装第三方开源类库
编辑Podfile文件之后,保存退出，然后终端输入命令：
$ pod install
等命令运行完，项目就已经是添加了cocoapods管理，启动项目就是点击.xcworkspace后缀的文件，在iOS项目中，导入头文件就能调用第三方库了。
2.5 更新第三方开源类库
以后需要添加、更新、删除某个第三方库，只要编写好Podfile文件，在终端输入：
$ pod update
之后运行就OK了。
如果升级某一个指定的第三方库，则输入以下命令：
$ pod update 第三方库名称
- CocoaPods安装失败问题总结
安装不成功的解决办法之前，先解释几个名词
Ruby 是一种面向对象、命令式、函数式、动态的通用编程语言。可运行于多种平台，如 Windows、MAC OS 和 UNIX 的各种版本。且和Apple系列的程序员最直接关联的就是Mac的开发环境，直接关联于Cocoapods工具。但是，cocoapods工具与Ruby的版本有一定的关联性，难免不涉及到升级。
gem是基于Ruby的一些开发工具包，不同的Gem可能会依赖不同的Ruby版本，通常来讲，新版本特性更多，用起来更便利。
**rails **是一个基于Ruby的网页服务器的架构，rails也算是一组gem，专门用来做网站的。 当然它们三个各自有各自的版本。
rvm是什么？rvm是Ruby版本管理器。为什么要安装rvm呢？因为rvm可以让你拥有多个版本的Ruby，并且可以在多个版本之间自由切换。
3.1 错误提示一
如果提示下面的错误提示，则需要安装高版本ruby，需要在终端进行升级，升级之前先安装rvm。
ERROR: Error installing cocoapods:
activesupport requires Ruby version >= 2.2.2.
第一步：安装rvm
$ curl -L get.rvm.io | bash -s stable
$ source ~/.profile
等待终端加载完毕后输入：
$ rvm -v
如果能显示版本号,则安装成功。
第二步：安装ruby
列出ruby可安装的版本信息
$ rvm list known
安装一个ruby版本
$ rvm install 2.2
如果想设置为默认版本，可以用这条命令来完成
$ rvm use 2.0.0 --default
查看已安装的ruby
$ rvm list
卸载一个已安装ruby版本
$ rvm remove 2.2
3.2 错误提示二
如果在终端安装过程中出现以下错误提示：
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.
解决办法升级gem，在终端输入：
$ sudo gem update --system
输入上面的后如果出现ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/update_rubygems这样的报错 就在终端输入：
sudo gem install -n /usr/local/bin cocoapods
问题迎难而解
注意rvm、ruby、gem是顺序更新的。
查看已安装的gem，输入：
$ gem -v
则可以看到gem的安装版本号。
3.3 错误提示三
pod setup之后，出现Setting up CocoaPods master repo，在等待过程中，可能出现下面错误：
[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master
Cloning into 'master'...
fatal: unable to access 'https://github.com/CocoaPods/Specs.git/': SSLRead() return error -9806
推测可能是网络带宽问题，git下载速度比较慢，所以会出现这种错误。
失败的解决办法,可以手动去克隆一份到repos目录下面:
通过终端，进入到
$ cd ~/.cocoapods/repos
然后通过终端
$ git clone https://github.com/CocoaPods/Specs.git
成功后通过finder的前往文件夹进行查看 ~/.cocoapods/repos
将clone的Specs项目的文件夹改名为master, 然后执行命令：
$ pod setup
更新：最近发现CocoaPods无法从Github上clone下来。解决办法是使用国内的镜像地址（https://coding.net/u/hging/p/Specs/git），然后在从前往文件夹的方式进入~/.cocoapods/repos目录下，再将文件夹重命名为master。然后执行命令：
$ pod setup
3.4 错误提示四
有的情况下搜索第三方库，例如搜索AFNetworking，也就是在执行以下命令符之后，
$ pod search AFNetworking
会出现以下错误“：
[!] Unable to find a pod with name, author, summary, or description matching AFNetworking
解决办法，就是清除搜索的缓存，执行以下命令就可以搜索出来想要搜索的第三方库了。
$ rm ~/Library/Caches/CocoaPods/search_index.json
3.5 补充一些终端命令
rvm list #查看已安装ruby
rvm list known #列出ruby可安装版本信息
rvm remove 2.2.2 #卸载一个已安装的ruby版本
gem source #查看已有源
gem list #查看local gems
which pod #查看pod 的本地地址
总结：
有不足之处还望谅解和指点，另给出参考的博客链接。
Xcode8 macOS Sierra 10.12 安装 CocoaPods
最新的 cocoapods 安装与使用（2016.11）
Mac上更新Ruby
Mac 如何升级 Ruby 版本
cocoapods:安装/更新Ruby环境教程
使用CocoaPods时提示安装高版本ruby遇到的坑。
使用CocoaPods时遇到pod setup失败的解决办法
CocoaPods错误
CocoaPods安装最详细教程