使用 CocoaPods 管理依賴庫
本篇內容將介紹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下載安裝第三方庫