原文：http://www.cocoachina.com/articles/896368?filter=ios
安裝CocoaPods涉及三方面：CocoaPods本身、Ruby環(huán)境、Ruby管理工具。原因：

1. CocoaPods是用Ruby實現(xiàn)的，所以，使用CocoaPods的前提是處于Ruby環(huán)境下。
2. 需要用到Ruby管理工具來安裝Ruby。管理Ruby的工具有很多，rvm就是其中一個，它提供一個便捷的多版本 Ruby 環(huán)境的管理和切換。

安裝步驟

最重要的： 保證iOS 系統(tǒng)版本為最新，XCode的版本也是最新。否則會有情況不明的問題。

1. Ruby管理工具rvm的安裝

首先檢測rvm是否安裝：

rvm -v

安裝過程：

    1\. curl -L https://get.rvm.io | bash -s stable   // 安裝rvm
    2\. source ~/.rvm/scripts/rvm                         //載入rvm環(huán)境
    3\. rvm -v ／／驗證rvm是否正常安裝

2. 安裝Ruby

雖然Mac都自帶Ruby，但是CocoaPods的安裝需要特定版本的Ruby。而Mac自帶的Ruby的版本可能不合適。選哪個版本比較好呢？一般來說，用最新版本的Ruby是最保險的。

安裝過程： 1.首先，查看目前的所有Ruby版本。找到最新的版本號。

rvm list known

2.安裝最新版本的Ruby

rvm install ruby-xx.xx(xx.xx表示版本號)

3.更改Ruby的軟件源。 Ruby的軟件源用的是亞馬遜的云服務(wù)，訪問不了。所以，在安裝CocoaPods前，需要更改該軟件源為我們可以訪問的源。修改方式如下。

Ruby源更改動態(tài)：
2018.3月以前的時候，Ruby源要更改為：https://gems.ruby-china.org
2018.3月后，Ruby源變了，要更改為：https://gems.ruby-china.com 

可以先用【gem sources -l】命令查看源是否為最新的Ruby源（目前是https://gems.ruby-china.com ） 。不是的話再按照3.1的方法把源改為最新的Buby源。

3.1 更改Ruby源
gem sources --remove https://rubygems.org/  (移除https://rubygems.org/下載地址)
gem sources -a  https://gems.ruby-china.com （添加https://gems.ruby-china.org/為下載地址）
注意：gem sources -a 后面的這個地址，要用https，而不是http
3.2 檢查更改是否成功**
gem sources -l
如果結(jié)果顯示只有 https://ruby.taobao.org/ 這個下載地址。則表示我們的更改操作正確。

3.安裝CocoaPods

1.安裝CocoaPods

    sudo gem install cocoapods

2.檢測安裝是否正確

which pod (which命令：查看可執(zhí)行文件的位置)

3 pod setup（這個步驟，請直接看下面的Tips）

**Tips： 下載速度太慢解決辦法 ****備注：以下的（1）－（3）步驟，也可以簡化為，拷貝同事的本地的/.cocoapods/repos/下的master文件，放到自己本機的/.cocoapods/repos目錄下。

(1.) 進入本機目錄：
/.cocoapods/repos
(2.) 終端進入到目錄/.cocoapods/repos，然后執(zhí)行clone Specs項目的語句：  git clone https://github.com/CocoaPods/Specs.git 等待其clone完成。終端會顯示有clone的進度，比直接執(zhí)行po d setup更直觀。
(3\. )將clone的Specs項目的文件夾改名為master，然后拖到/Users/用戶名/.cocoapods/repos目錄下。
(4.) 運行 pod install --verbose --no-repo-update   或  pod setup （推薦使用pod install --verbose --no-repo-update。因為--no-repo-update參數(shù)禁止了pod setup默認執(zhí)行的更新spec文件的行為）

所有的項目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次執(zhí)行pod setup時，CocoaPods 會將這些podspec索引文件更新到本地的 ~/.cocoapods/repos目錄下，這個索引文件比較大。所以第一次更新時非常慢。 pod setup在執(zhí)行時，會輸出Setting up CocoaPods master repo，但是會等待比較久的時間。這步其實是 Cocoapods 在將它的信息下載到 ~/.cocoapods/repos目錄下，如果你等太久，可以試著 cd 到那個目錄，用du -sh *來查看下載進度。

遇到的問題

【問題1】 pod install 的時候，總是install openssl 失敗。沒有什么信息提示，只是有一大板的紅色openssl 的配置文件信息。 【解決】 (1)用openssl-universal（修改podfile文件)。這個辦法有點不好的是，有可能引入的其他庫也引入了openssl。 (2)有可能是xcode不是最新版本所致(我就是這個問題，當(dāng)時iOS 系統(tǒng)為10.1.6，xcode的版本為8--最新版本為10.13.2，xcode為9)

【問題2】 Failed to connect to raw.githubusercontent.com port 443: Connection refused 【解決】 這是由于該網(wǎng)址的域名解析被污染的緣故。通過修改hosts可以解決這個問題： 打開/etc/hosts 文件，添加語句：

199.232.4.133 raw.githubusercontent.com

參考文檔

1.https://blog.csdn.net/fengsh998/article/details/52172741 2.https://www.cnblogs.com/jiang-xiao-yan/p/5229608.html