CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It has over ten thousand libraries and can help you scale your projects elegantly
以上是CocoaPods官網(wǎng)對(duì)CocoaPods給出的介紹。從這可以看出CocoaPods是一個(gè)依賴管理的Swift和Objective-C的C?ocoa項(xiàng)目。
CocoaPods項(xiàng)目的源碼 在 Github 上管理。該項(xiàng)目開始于 2011 年 8 月 12 日，經(jīng)過多年發(fā)展，現(xiàn)在已經(jīng)成為 iOS 開發(fā)事實(shí)上的依賴管理標(biāo)準(zhǔn)工具。開發(fā) iOS 項(xiàng)目不可避免地要使用第三方開源庫，CocoaPods 的出現(xiàn)使得我們可以節(jié)省設(shè)置和更新第三方開源庫的時(shí)間。
CocoaPods的安裝和使用
安裝方式異常簡(jiǎn)單 , Mac 下都自帶 ruby，使用 ruby 的 gem 命令即可下載安裝：
$ sudo gem install cocoapods$ pod setup
如果你的 gem 太老，可能也會(huì)有問題，可以嘗試用如下命令升級(jí) gem:
$ sudo gem update --system
另外，ruby 的軟件源 https://rubygems.org 因?yàn)槭褂玫氖莵嗰R遜的云服務(wù)，所以被墻了，需要更新一下 ruby 的源，使用如下代碼將官方的 ruby 源替換成國(guó)內(nèi)淘寶的源：
gem sources --remove https://rubygems.org/gem sources -a https://ruby.taobao.org/gem sources -l
還有一點(diǎn)需要注意，pod setup
在執(zhí)行時(shí)，會(huì)輸出Setting up CocoaPods master repo
，但是會(huì)等待比較久的時(shí)間。這步其實(shí)是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下，如果你等太久，可以試著 cd 到那個(gè)目錄，用
du -sh *
來查看下載進(jìn)度。你也可以參考本文接下來的使用 cocoapods 的鏡像索引
一節(jié)的內(nèi)容來提高下載速度。使用 CocoaPods 的鏡像索引所有的項(xiàng)目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次執(zhí)行pod setup時(shí)，CocoaPods 會(huì)將這些podspec索引文件更新到本地的 ~/.cocoapods/目錄下，這個(gè)索引文件比較大。所以第一次更新時(shí)非常慢。
一個(gè)叫 akinliu 的朋友在 gitcafe 和 oschina 上建立了 CocoaPods 索引庫的鏡像，因?yàn)?gitcafe 和 oschina 都是國(guó)內(nèi)的服務(wù)器，所以在執(zhí)行索引更新操作時(shí)，會(huì)快很多。如下操作可以將 CocoaPods 設(shè)置成使用 gitcafe 鏡像：
pod repo remove masterpod repo add master https://gitcafe.com/akuandev/Specs.gitpod repo update
將以上代碼中的 https://gitcafe.com/akuandev/Specs.git
替換成 http://git.oschina.net/akuandev/Specs.git
即可使用 oschina 上的鏡像。使用 CocoaPods使用時(shí)需要新建一個(gè)名為 Podfile 的文件，以如下格式，將依賴的庫名字依次列在文件中即可
platform :ios
pod 'JSONKit', '~> 1.4'
pod 'Reachability', '~> 3.0.0'
pod 'ASIHTTPRequest'
pod 'RegexKitLite'
然后你將編輯好的 Podfile 文件放到你的項(xiàng)目根目錄中，執(zhí)行如下命令即可：
cd "your project home"pod install
現(xiàn)在，你的所有第三方庫都已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴，你只需要記住如下 2 點(diǎn)即可：
使用 CocoaPods 生成的 *.xcworkspace 文件來打開工程，而不是以前的 *.xcodeproj 文件。
每次更改了 Podfile 文件，你需要重新執(zhí)行一次pod update
命令。
查找第三方庫
你如果不知道 cocoaPods 管理的庫中，是否有你想要的庫，那么你可以通過 pod search 命令進(jìn)行查找，以下是我用 pod search json 查找到的所有可用的庫：
$ pod search json
-> AnyJSON (0.0.1)
Encode / Decode JSON by any means possible.
- Homepage: https://github.com/mattt/AnyJSON
- Source: https://github.com/mattt/AnyJSON.git
- Versions: 0.0.1 [master repo]
-> JSONKit (1.5pre)
A Very High Performance Objective-C JSON Library.
- Homepage: https://github.com/johnezang/JSONKit
- Source: git://github.com/johnezang/JSONKit.git
- Versions: 1.5pre, 1.4 [master repo]// ... 以下省略若干行
關(guān)于 Podfile.lock
當(dāng)你執(zhí)行pod install
之后，除了 Podfile 外，CocoaPods 還會(huì)生成一個(gè)名為Podfile.lock
的文件，Podfile.lock 應(yīng)該加入到版本控制里面，不應(yīng)該把這個(gè)文件加入到.gitignore中。因?yàn)镻odfile.lock會(huì)鎖定當(dāng)前各依賴庫的版本，之后如果多次執(zhí)行pod install不會(huì)更改版本，要pod update才會(huì)改Podfile.lock了。這樣多人協(xié)作的時(shí)候，可以防止第三方庫升級(jí)時(shí)造成大家各自的第三方庫版本不一致。
CocoaPods 的這篇 官方文檔 也在What is a Podfile.lock一節(jié)中介紹了Podfile.lock
的作用，并且指出：
This file should always be kept under version control.
為自己的項(xiàng)目創(chuàng)建 podspec 文件我們可以為自己的開源項(xiàng)目創(chuàng)建podspec文件，首先通過如下命令初始化一個(gè)podspec文件：
pod spec create your_pod_spec_name
該命令執(zhí)行之后，CocoaPods 會(huì)生成一個(gè)名your_pod_spec_name.podspec的文件，然后我們修改其中的相關(guān)內(nèi)容即可。具體步驟可以參考這兩篇博文中的相關(guān)內(nèi)容：
《如何編寫一個(gè) CocoaPods 的 spec 文件》
《Cocoapods 入門》。
使用私有的 pods
我們可以直接指定某一個(gè)依賴的podspec，這樣就可以使用公司內(nèi)部的私有庫。該方案有利于使企業(yè)內(nèi)部的公共項(xiàng)目支持 CocoaPods。如下是一個(gè)示例：
pod 'MyCommon', :podspec => 'https://yuantiku.com/common/myCommon.podspec'
不更新 podspec CocoaPods 在執(zhí)行pod install和pod update時(shí)，會(huì)默認(rèn)先更新一次podspec索引。使用--no-repo-update參數(shù)可以禁止其做索引更新操作。如下所示：
pod install --no-repo-updatepod update --no-repo-update
生成第三方庫的幫助文檔如果你想讓 CococaPods 幫你生成第三方庫的幫助文檔，并集成到 Xcode 中，那么用 brew 安裝 appledoc 即可：
brew install appledoc
關(guān)于 appledoc.它最大的優(yōu)點(diǎn)是可以將幫助文檔集成到 Xcode 中，這樣你在敲代碼的時(shí)候，按住 opt 鍵單擊類名或方法名，就可以顯示出相應(yīng)的幫助文檔。
原理
大概研究了一下 CocoaPods 的原理，它是將所有的依賴庫都放到另一個(gè)名為 Pods 項(xiàng)目中，然后讓主項(xiàng)目依賴 Pods 項(xiàng)目，這樣，源碼管理工作都從主項(xiàng)目移到了 Pods 項(xiàng)目中。發(fā)現(xiàn)的一些技術(shù)細(xì)節(jié)有：
Pods 項(xiàng)目最終會(huì)編譯成一個(gè)名為 libPods.a 的文件，主項(xiàng)目只需要依賴這個(gè) .a 文件即可。
對(duì)于資源文件，CocoaPods 提供了一個(gè)名為 Pods-resources.sh 的 bash 腳本，該腳本在每次項(xiàng)目編譯的時(shí)候都會(huì)執(zhí)行，將第三方庫的各種資源文件復(fù)制到目標(biāo)目錄中。
CocoaPods 通過一個(gè)名為 Pods.xcconfig 的文件來在編譯時(shí)設(shè)置所有的依賴和參數(shù)。
