前言
每種語言發展到一個階段,就會出現相應的依賴管理工具, 或者是中央程式碼倉庫。比如
- Java: maven,Ivy
- Ruby: gems
- Python: pip, easy_install
- Nodejs: npm
隨著iOS開發者的增多,業界也出現了為iOS程式提供依賴管理的工具,這個工具叫:CocoaPods。
CocoaPods簡介
CocoaPods是一個負責管理iOS專案中第三方開原始碼的工具。CocoaPods專案的原始碼在Github上管理。該專案開始於2011年8月12日,經過一年多的發展,現在已經超過1000次提交,並且持續保持活躍更新。開發iOS專案不可避免地要使用第三方開源庫,CocoaPods的出現使得我們可以節省設定和更新第三方開源庫的時間。
拿我之前開發的粉筆網iPhone客戶端為例,其使用了14個第三方開源庫。在沒有使用CocoaPods以前,我需要:
- 把這些第三方開源庫的相關檔案複製到專案中,或者設定成git的submodule,然後這些開源庫通常需要依賴系統的一些framework,我需要手工地將這些framework一一增加到專案依賴中,比如ASI網路庫就需要增加以下framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics and zlib。
- 對於RegexKitLite這個正規表示式庫,我還需要設定-licucore的編譯引數
- 手工管理這些依賴包的更新。
這些體力活雖然簡單,但毫無技術含量並且浪費時間。在使用CocoaPods之後,我只需要將用到的第三方開源庫放到一個名為Podfile的檔案中,然後執行pod install。CocoaPods就會自動將這些第三方開源庫的原始碼下載下來,並且為我的工程設定好相應的系統依賴和編譯引數。
CocoaPods的安裝和使用介紹
安裝
安裝方式異常簡單, Mac下都自帶ruby,使用ruby的gem命令即可下載安裝:
- $ gem install cocoapods
- $ pod setup
使用
使用時需要新建一個名為Podfile的檔案,以如下格式,將依賴的庫名字依次列在檔案中即可
- platform :ios
- pod 'JSONKit', '~> 1.4'
- pod 'Reachability', '~> 3.0.0'
- pod 'ASIHTTPRequest'
- pod 'RegexKitLite'
然後你將編輯好的Podfile檔案放到你的專案根目錄中,執行如下命令即可:
- cd "your project home"
- pod install
現在,你的所有第三方庫都已經下載完成並且設定好了編譯引數和依賴,你只需要記住如下2點即可:
- 使用CocoaPods生成的 .xcworkspace 檔案來開啟工程,而不是以前的 .xcodeproj 檔案。
- 每次更改了Podfile檔案,你需要重新執行一次pod install命令。
查詢第三方庫
你如果不知道cocoaPods管理的庫中,是否有你想要的庫,那麼你可以通過pod search命令進行查詢,以下是我用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]
- -> MTJSONDictionary (0.0.4)
- An NSDictionary category for when you're working with it converting to/from JSON. DEPRECATED, use MTJSONUtils
- instead.
- - Homepage: https://github.com/mysterioustrousers/MTJSONDictionary.git
- - Source: https://github.com/mysterioustrousers/MTJSONDictionary.git
- - Versions: 0.0.4, 0.0.3, 0.0.2 [master repo]
- -> MTJSONUtils (0.1.0)
- An NSObject category for working with JSON.
- - Homepage: https://github.com/mysterioustrousers/MTJSONUtils.git
- - Source: https://github.com/mysterioustrousers/MTJSONUtils.git
- - Versions: 0.1.0, 0.0.1 [master repo]
- -> SBJson (3.1.1)
- This library implements strict JSON parsing and generation in Objective-C.
- - Homepage: http://stig.github.com/json-framework/
- - Source: https://github.com/stig/json-framework.git
- - Versions: 3.1.1, 3.1, 3.0.4, 2.2.3 [master repo]
- -> TouchJSON (1.0)
- TouchJSON is an Objective-C based parser and generator for JSON encoded data.
- - Homepage: https://github.com/TouchCode/TouchJSON
- - Source: https://github.com/TouchCode/TouchJSON.git
- - Versions: 1.0 [master repo]
生成第三方庫的幫助文件
如果你想讓CococaPods幫你生成第三方庫的幫助文件,並整合到XCode中,那麼用brew安裝appledoc即可:
- brew install appledoc
關於appledoc,我在今年初的另一篇部落格《使用Objective-C的文件生成工具:appledoc》中有專門介紹。它最大的優點是可以將幫助文件整合到XCode中,這樣你在敲程式碼的時候,按住opt鍵單擊類名或方法名,就可以顯示出相應的幫助文件。
原理
大概研究了一下CocoaPods的原理,它是將所有的依賴庫都放到另一個名為Pods專案中,然後讓主專案依賴Pods專案,這樣,原始碼管理工作都從主專案移到了Pods專案中。發現的一些技術細節有:
- Pods專案最終會編譯成一個名為libPods.a的檔案,主專案只需要依賴這個.a檔案即可。
- 對於資原始檔,CocoaPods提供了一個名為Pods-resources.sh的bash指令碼,該指令碼在每次專案編譯的時候都會執行,將第三方庫的各種資原始檔複製到目標目錄中。
- CocoaPods通過一個名為Pods.xcconfig的檔案來在編譯時設定所有的依賴和引數。
轉自:http://blog.csdn.net/chengyakun11/article/details/9309715