原文地址：http://www.itdecent.cn/p/b64b4fd08d3c
一、什么是CocoaPods
每種語言發(fā)展到一個階段，就會出現(xiàn)相應(yīng)的依賴管理工具，例如 Java 語言的 Maven，nodejs 的 npm。隨著 iOS 開發(fā)者的增多，業(yè)界也出現(xiàn)了為 iOS 程序提供依賴管理的工具，它的名字叫做：CocoaPods。
CocoaPods項目的源碼
在 Github 上管理。該項目開始于 2011 年 8 月 12 日，經(jīng)過多年發(fā)展，現(xiàn)在已經(jīng)成為 iOS 開發(fā)事實上的依賴管理標(biāo)準(zhǔn)工具。開發(fā)
iOS 項目不可避免地要使用第三方開源庫，CocoaPods 的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時間。
二、為什么要使用CocoaPods
在使用CocoaPods之前，開發(fā)項目需要用到第三方開源庫的時候，我們需要
1.把開源庫的源代碼復(fù)制到項目中
2.添加一些依賴框架和動態(tài)庫
3.設(shè)置-ObjC，-fno-objc-arc等參數(shù)
4.管理他們的更新
在使用CocoaPods后，我們只需要把用到的開源庫放到一個名為Podfile的文件中，然后執(zhí)行pod install就可以了，Cocoapods就會自動將這些第三方開源庫的源碼下載下來，并且為我們的工程設(shè)置好響應(yīng)的系統(tǒng)依賴和編譯參數(shù)。
三、CocoaPods的原理
CocoaPods的原理是將所有的依賴庫都放到另一個名為Pods的項目中，然后讓主項目依賴Pods項目，這樣，源碼管理工作都從主項目移到了Pods項目中。Pods項目最終會編譯成一個名為libPods.a的文件，主項目只需要依賴這個.a文件即可。
四、CocoaPods的安裝
CocoaPods可以方便地通過Mac自帶的RubyGems安裝。
打開Terminal（Mac電腦自帶的終端），然后按照以下提示操作即可：
1.設(shè)置ruby的軟件源
這是因為ruby的軟件源rubygems.org因為使用亞馬遜的云服務(wù)，被我天朝屏蔽了，需要更新一下ruby的源，過程如下：
gem sources -l #(查看當(dāng)前ruby的源)
gem sources --remove https://rubygems.org/ #(移除當(dāng)前ruby的源)
gem sources -a https://ruby.taobao.org/ #(設(shè)置當(dāng)前ruby的源為我天朝的)
gem sources -l #(再次查看當(dāng)前ruby的源)
如果Terminal輸出：
*** CURRENT SOURCES ***
https://ruby.taobao.org/
就證明ruby的軟件源已經(jīng)設(shè)置OK了。
2.設(shè)置gem為最新版本
如果gem太老，可以嘗試用如下命令升級gem：
在Terminal輸入以下命令：
sudo gem update --system
升級成功后會提示: Latest version currently installed. Aborting.
3.執(zhí)行安裝CocoaPods命令
注意：OS X 10.11 升級，雖然官方聲稱只是一個小的升級，但對于開發(fā)者而言，cocoapods需要重新安裝，但按照以前的安裝方式，在Terminal輸入以下命令：
sudo gem install? cocoapods
如果報以下錯誤：
ERROR:? While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解決方案1：
執(zhí)行下面的命令并重啟
sudo nvram boot-args="rootless=0"
sudo reboot
重啟之后, 執(zhí)行這個命令檢查
sudo gem install cocoapods -V
如果依舊有錯誤，使用第二個方案
解決方案2：
sudo gem install -n /usr/local/bin cocoapods
pod setup
還有一點需要注意，pod setup在執(zhí)行時，會輸出Setting up CocoaPods master repo，但是會等待比較久的時間。這步其實是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下，如果你等太久，可以試著 cd 到那個目錄，用du -sh *來查看下載進度。
安裝成功后,你會看到:Setup completed
五、Cocoapods的使用
隨便以一種方式新建一個名為Podfile的文件放到你的工程根目錄下（不能寫成別的名字，也可以自己在工程根目錄里面直接新建）
Podfile文件內(nèi)容的格式應(yīng)該如下：
platform :ios, '8.0' #(注明你的開發(fā)平臺以及版本，'8.0'忽略不寫即為最新版本)
pod 'AFNetworking', '~> 2.5.3' #('~> 2.5.3'為版本號，忽略不寫即為最新版本)
pod 'SDWebImage', '~> 3.7.2'
然后在Terminal進入工程所在的根目錄（工程根目錄）中執(zhí)行 ：
pod install
這樣，AFNetworking和SDWebImage就已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴，以后使用的時候切記如下兩點：
1.從此以后需要使用Cocoapods生成的 .xcworkspace文件來打開工程，而不是使用以前的.xcodeproj文件
2.每次更改了Podfile文件，都需要重新執(zhí)行一次pod update命令
查找第三方庫：
你如果不知道 cocoaPods 管理的庫中，是否有你想要的庫，那么你可以通過 pod search 命令進行查找，以下是我用 pod search json 查找到的所有可用的庫：
可以在Terminal中輸入：
pod search AFNetworking
回車之后就可以看到和你搜索的關(guān)鍵字相關(guān)的一些庫類，如圖：
關(guān)于 Podfile.lock
當(dāng)你執(zhí)行pod install之后，除了 Podfile 外，CocoaPods
還會生成一個名為Podfile.lock的文件，Podfile.lock
應(yīng)該加入到版本控制里面，不應(yīng)該把這個文件加入到.gitignore中。因為Podfile.lock會鎖定當(dāng)前各依賴庫的版本，之后如果多次執(zhí)行pod
install 不會更改版本，要pod
update才會改Podfile.lock了。這樣多人協(xié)作的時候，可以防止第三方庫升級時造成大家各自的第三方庫版本不一致
附：如何使用CocoaPods的鏡像索引:
所有項目的Podspec文件都托管在https://github.com/CocoaPods/Specs,
第一次執(zhí)行pod setup時,CocoaPods會將這些podspec索引文件更新到本地的~/.cocoapods目錄下,
這個索引文件比較大,所以第一次更新時非常慢.
友好人士在國內(nèi)的服務(wù)器建立了Cocoapods索引庫的鏡像,
所以執(zhí)行索引跟新操作時候會快很多.具體操作方法如下:
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
這是使用gitcafe上的鏡像,將以上代碼中的 https://gitcafe.com/akuandev/Specs.git
替換成 http://git.oschina.net/akuandev/Specs.git 即可使用oschina上的鏡像。
推薦閱讀：
2016-10-8號更新
六、刪除不用的庫
在項目的目錄里面找到并打開Podfile文件，
刪除選中的JSONKit
刪除
2.打開終端 cd 到當(dāng)前項目目錄下，重新執(zhí)行pod install命令。
別人的問題集合：
1.最近使用CocoaPods來添加第三方類庫，無論是執(zhí)行pod install還是pod update都卡在了Analyzing dependencies不動
原因在于當(dāng)執(zhí)行以上兩個命令的時候會升級CocoaPods的spec倉庫，加一個參數(shù)可以省略這一步，然后速度就會提升不少。加參數(shù)的命令如下：
pod install --verbose --no-repo-update
pod update --verbose --no-repo-update
2.問題描述：要集成騰訊Bugly，用的CocoaPods 集成方式安裝的是1.4的，手動下載的SDK是2.4，由于2.0以后有重大更新，必須用2.0以上的而又不想手動集成，就查找為啥CocoaPods不能安裝到最新版。
解決方案：雖然使用CocoaPods很長時間了，其實對它理解不深，平時由于pod install 慢，就換成pod install —verbose —no-repo-update, 這也就意味著沒有升級CocoaPods 的spec倉庫，CocoaPods中沒有2.4的Bugly, 最新的就是1.4，所以需要升級執(zhí)行 pod repo update，看情況通常很慢，我大概用了二十分鐘左右，pod search Bugly 后就有2.4的了。
雖然應(yīng)用主要是install/update，再說幾個通常容易誤解的地方：
1. 第一次添加三方，不用說肯定是 pod install, 以后添加了新的三方不是用update, 還是要用install, 同理 Podfile 中刪除一個三方后也需要install而不是update;
2. 什么時候用update, 就是你已經(jīng)安裝了某個三方，更新到新的版本時用，直接用pod update ?這樣所有安裝的三方都更新了，這通常不是我們所期望的，新的三方引起的問題多的是，我們希望更新某個庫如：pod
update AFNetworking
, 這樣就好了? 通常很慢， pod update AFNetworking —verbose —no-repo-update
很快，但是有時你就會遇到我上面遇到的問題，所有建議先 search 一下，如果沒有就要更新spec倉庫, 有就用上面快的方法來。
