在之前的一個項目安裝過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的源。
1.1 首先打開終端，輸入以下命令符檢查Ruby源
$ gem sources - l
如果你的鏡像地址是如下圖1-1所示：
那么就需要替換Ruby源。
1.2 替換Ruby源，輸入以下命令符，刪除目前的Ruby源
$ gem sources --remove https://rubygems.org/
1.3 添加新的Ruby源，輸入以下命令符：
$ gem sources -a https://gems.ruby-china.org/
之前使用的是以下這個
$ gem sources -a https://ruby.taobao.org/
但是這個已經不維護了，請查看相關信息。
再次更新：
https://gems.ruby-china.org
改為：
https://gems.ruby-china.com
.com?代替?.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所示：
出現Setting up CocoaPods master repo 后會卡住一段時間，
可以在新開一個終端的窗口，輸入以下的命令，查看下載文件的大小。
$ cd ~/.cocoapods
$ du -sh?
下載完畢后，所占磁盤的大小在894M左右。
1.7 下載成功，輸入以下命令：
$ pod --version
可以看到安裝成功cocoapods的版本。
當然我們也可以對cocoapods卸載重新安裝，輸入以下命令：
$ sudo gem uninstall 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
2. 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.1），但是不包含高于1.0的版本，相當于1.0以下(不含1.0)。
'~>0' 任何版本，相當于不指定版本，默認采用最新版本號 。
編輯Podfile文件之后，?
按 i 可編輯?
esc 退出編輯
:wq? 可保存退出
:q 不保存退出
2.4 安裝第三方開源類庫
編輯Podfile文件之后,保存退出，然后終端輸入命令：
$ pod install
等命令運行完，項目就已經是添加了cocoapods管理，啟動項目就是點擊.xcworkspace后綴的文件，在iOS項目中，導入頭文件就能調用第三方庫了。
2.5 更新第三方開源類庫
以后需要添加、更新、刪除某個第三方庫，只要編寫好Podfile文件，在終端輸入：
$ pod update
之后運行就OK了。
如果升級某一個指定的第三方庫，則輸入以下命令：
$ pod update 第三方庫名稱
3. 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
如下圖3-1所示：
這一步需要下載資源包一段時間，稍等片刻，下載完畢后再輸入以下命令：
$ source ~/.profile?
等待終端加載完畢后輸入：
$ rvm -v
如下圖3-2所示：
如果能顯示版本號,則安裝成功。
第二步：安裝ruby
列出ruby可安裝的版本信息
$ rvm list known
如下圖3-3所示：
安裝一個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
注意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://github.com/CocoaPods/Specs.git 國內鏡像 停止更新。解決辦法是使用國內的鏡像地址（https://gitclub.cn/CocoaPods/Specs.git），具體詳見說明。然后在從前往文件夾的方式進入~/.cocoapods/repos目錄下，再將文件夾重命名為master。然后執行命令：
$ pod setup
以下方式也可以：
該過程作用與 pod setup作用相同。
$ git clone https://github.cn/CocoaPods/Specs.git? ~/.cocoapods/repos/master
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 錯誤提示五
Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master`.
You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.
解決辦法：
$ pod repo add master https://github.cn/CocoaPods/Specs.git
接下來提示執行 ’ pod setup ’，如果出現以下警告提示：
[!] The`master`repo isnotagit repo.
則從前往文件夾的方式進入~/.cocoapods/repos目錄下，然后刪除master文件夾
再執行以下命令：
$ pod setup
3.6 補充一些終端命令
rvm list? #查看已安裝ruby
rvm list known? #列出ruby可安裝版本信息
rvm remove 2.2.2? #卸載一個已安裝的ruby版本
gem source? #查看已有源
gem list? #查看local gems
gem list --local | grep cocoapods #查看本地電腦上安裝了哪些版本的CocoaPods
which pod? #查看pod 的本地地址
快捷鍵ctrl + c? 前臺進程的終止
快捷鍵 ctrl + z 前臺進程的掛起，可以將一個正在前臺執行的命令放到后臺，并且處于暫停狀態，不可執行
總結：
有不足之處還望諒解和指點，另給出參考的博客鏈接。
Xcode8 macOS Sierra 10.12 安裝 CocoaPods
