使用 CocoaPods 管理依賴庫

文本首發於Ryan’s Zone

本篇內容將介紹Mac和iOS開發中必備的一個依賴庫管理工具CocoaPods。

CocoaPods是什麼

在iOS開發中勢必會用到一些第三方依賴庫，好比你們都熟悉的ASIHttpRequest、AFNetworking、JSONKit等。使用這些第三方類庫能極大的方便項目的開發，可是，集成這些依賴庫須要咱們手動去配置，例如集成ASIHttpRequest庫時除了加入源碼之外還須要手動去添加一些系統框架，好比CFNetwork、MobileCoreServices等，若是這些第三方庫發生了更新，還須要手動去更新項目。這就顯得很是麻煩。有麻煩天然有解決辦法，CocoaPods就是爲了解決這個問題而生的。經過CocoaPods，咱們能夠將第三方的依賴庫統一管理起來，配置和更新只須要經過簡單的幾行命令便可完成，大大的提升了實際開發中的工做效率，使咱們的主要精力集中到更重要的事情上去。

安裝CocoaPods
個人環境爲Mac OS X 10.9.1，安裝CocoaPods以前，先確保本地有Ruby環境，由於CocoaPods運行於Ruby之上，默認狀況下，Mac是自帶了Ruby環境的，能夠經過命令行「`ruby -v「`查看當前Ruby的版本，我用的是1.9.3p448。接下來咱們就能夠經過以下命令安裝CocoaPods了。

$ sudo gem install cocoapods

輸入上述命令後可能會無響應，那是由於你身在天朝，偉大的牆攔住了你的去路，不知爲何，cocoapods.org這種無害產物也要被牆。不過不要緊，咱們能夠經過淘寶的Ruby鏡像來訪問Cocoapods，在終端輸入以下命令將Ruby鏡像替換爲淘寶的。

$ gem sources –remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/

完成後能夠經過以下命令來查看當前的Ruby鏡像是否已經指向了淘寶的。

$ gem sources -l

若是輸出結果是以下這樣，那說明這一步就成功了。

*** CURRENT SOURCES ***

http://ruby.taobao.org/

接下來就能夠從新運行安裝命令來安裝CocoaPods了，根據你的網絡狀況，幾秒或十幾秒後安裝過程就完成了，總的來講，安裝過程仍是比較簡單的。若是其中你遇到了什麼問題，請自行Google解決，都能找到你想要的答案。

使用CocoaPods
咱們經過集成JSONKit類庫來演示如何使用CocoaPods來作依賴庫管理。首先，創建一個xcode工程，命名爲CocoaPodsTest，如今的工程結構以下圖所示。

這裏咱們要集成JSONKit，能夠先經過以下命令來判斷其是否支持CocoaPods。

「`
$ pod search JSONKit
「`

執行後經過輸出結果能夠看到JSONKit是支持CocoaPods的，注意紅框標記的內容，這是待會咱們配置xcode時須要的信息，這條配置項就是告訴CocoaPods去下載和管理哪個第三方庫。

檢測完畢後咱們來到工程CocoaPodsTest的目錄下，新建一個名爲Podfile的文件（這裏經過命令行建立）

$ vim Podfile

這個Podfile文件的做用是配置依賴庫信息，就是告訴CocoaPods去下載和管理哪些依賴庫，文件建立好之後，打開文件並加入以下內容。（vim打開文件後按i進入插入模式，編輯完成後按esc退出編輯模式，接着輸入:wq保存並退出文件）

這時候，工程目錄下就會有一個Podfile文件了，注意必須和.xcodeproj在同一個目錄下。接下來就可使用CocoaPods來安裝並管理JSONKit庫了，確保命令行當前路徑是在CocoaPodsTest目錄下，運行以下命令。

$ pod install

安裝完成後會提示以下信息，而且咱們的工程目錄下會多出一個.xcworkspace結尾的文件，命令行信息綠色部分提醒咱們「今後使用CocoaPodsTest.xcworkspace來打開項目」。

經過CocoaPodsTest.xcworkspace來打開項目，這時，咱們的項目工程結構就會變成下圖這樣，多出一個名爲Pods的依賴工程，打開Pods文件夾後，發現JSONKit已經在裏面了

這時候就能夠在項目文件中引入JSONKit.h了，這時候若是你發現import的時候沒有提示JSONKit的文件，能夠在target-Build Settings下修改「User Header Search Paths」項，新增${SRCROOT}並選擇rcursive，以下圖。

設置完成後就能夠在文件中直接引用第三方庫的文件並使用了。

到此，新建工程並使用CocoaPods來管理依賴庫的過程就完成了，若是是直接使用已有CocoaPods的項目，則須要首先運行一下pod update命令來更新項，而後照樣經過.xcworkspace來打開工程。

若是須要依賴多個第三方類庫，只須要修改Podfile文件的配置，而後運行pod update命令便可，好比新增一個AFNetworking的依賴庫，首先執行pod search AFNetworking查看一下AFNetworking的配置信息，修改Podfile文件，在後面增長AFNetworking的對應配置信息，而後運行pod update命令就完成了對AFNetworking的集成。

添加AFNetworking庫後的目錄結構以下。

若是類庫有更新，查看更新配置並執行pod update便可簡單完成了，今後從手動更新繁重的體力勞動中解脫出來。

簡單小結一下：

- 安裝CocoaPods- 新建項目並在工程根目錄下新建Podfile文件，配置須要管理的第三方庫- 運行pod install下載安裝第三方庫