CocoaPods簡介
當你開發(fā)iOS應(yīng)用時隆箩,會經(jīng)常使用到很多第三方開源類庫,比如JSONKit琼梆,AFNetWorking等等性誉×裕可能某個類庫又用到其他類庫,所以要使用它错览,必須得另外下載其他類庫纫雁,而其他類庫又用到其他類庫,“子子孫孫無窮盡也”倾哺,這也許是比較特殊的情況轧邪。另外一種常見情況是,你項目中用到的類庫有更新羞海,你必須得重新下載新版本忌愚,重新加入到項目中,十分麻煩却邓。如果能有什么工具能解決這些惱人的問題硕糊,那將“善莫大焉”。所以腊徙,你需要 CocoaPods简十。 CocoaPods應(yīng)該是iOS最常用最有名的類庫管理工具了,上述兩個煩人的問題撬腾,通過cocoaPods螟蝙,只需要一行命令就可以完全解決,當然前提是你必須正確設(shè)置它民傻。重要的是胶逢,絕大部分有名的開源類庫,都支持CocoaPods饰潜。所以,作為iOS程序員的我們和簸,掌握CocoaPods的使用是必不可少的基本技能了彭雾。
CocoaPods 的安裝和使用介紹
安裝
安裝方式異常簡單 , Mac 下都自帶 ruby,使用 ruby 的 gem 命令即可下載安裝:
$ sudo gem install cocoapods
$ pod setup
如果你的 gem 太老锁保,可能也會有問題薯酝,可以嘗試用如下命令升級 gem:
sudo gem update --system
另外,ruby 的軟件源 https://rubygems.org 因為使用的是亞馬遜的云服務(wù)爽柒,所以被墻了吴菠,需要更新一下 ruby 的源,使用如下代碼將官方的 ruby 源替換成國內(nèi)淘寶的源:
gem sources --remove https://rubygems.org/
gem sources -a http://ruby.taobao.org/
gem sources -l
還有一點需要注意浩村,pod setup在執(zhí)行時做葵,會輸出Setting up CocoaPods master repo,但是會等待比較久的時間心墅。這步其實是 Cocoapods 在將它的信息下載到 ~/.cocoapods目錄下酿矢,如果你等太久榨乎,可以試著 cd 到那個目錄,用du -sh *來查看下載進度瘫筐。你也可以參考本文接下來的使用 cocoapods 的鏡像索引一節(jié)的內(nèi)容來提高下載速度蜜暑。
使用 CocoaPods 的鏡像索引
所有的項目的 Podspec 文件都托管在https://github.com/CocoaPods/Specs。第一次執(zhí)行pod setup時策肝,CocoaPods 會將這些podspec索引文件更新到本地的 ~/.cocoapods/目錄下肛捍,這個索引文件比較大,有 80M 左右之众。所以第一次更新時非常慢拙毫,筆者就更新了將近 1 個小時才完成。
一個叫 akinliu 的朋友在 gitcafe 和 oschina 上建立了 CocoaPods 索引庫的鏡像酝枢,因為 gitcafe 和 oschina 都是國內(nèi)的服務(wù)器恬偷,所以在執(zhí)行索引更新操作時,會快很多帘睦。如下操作可以將 CocoaPods 設(shè)置成使用 gitcafe 鏡像:
pod repo remove master
pod repo add master https://gitcafe.com/akuandev/Specs.git
pod repo update
將以上代碼中的 https://gitcafe.com/akuandev/Specs.git 替換成 http://git.oschina.net/akuandev/Specs.git 即可使用 oschina 上的鏡像袍患。
使用 CocoaPods
使用時需要新建一個名為 Podfile 的文件,以如下格式竣付,將依賴的庫名字依次列在文件中即可
platform :ios
pod 'JSONKit', '~> 1.4'
pod 'Reachability', '~> 3.0.0'
pod 'ASIHTTPRequest'
pod 'RegexKitLite'
然后你將編輯好的 Podfile 文件放到你的項目根目錄中诡延,執(zhí)行如下命令即可:
cd "your project home"
pod install
現(xiàn)在,你的所有第三方庫都已經(jīng)下載完成并且設(shè)置好了編譯參數(shù)和依賴古胆,你只需要記住如下 2 點即可:
使用 CocoaPods 生成的 .xcworkspace 文件來打開工程肆良,而不是以前的 .xcodeproj 文件。
每次更改了 Podfile 文件逸绎,你需要重新執(zhí)行一次pod update命令惹恃。
查找第三方庫
你如果不知道 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]
// ... 以下省略若干行
關(guān)于 Podfile.lock
當你執(zhí)行pod install之后,除了 Podfile 外颊乘,CocoaPods 還會生成一個名為Podfile.lock的文件参淹,Podfile.lock 應(yīng)該加入到版本控制里面,不應(yīng)該把這個文件加入到.gitignore中乏悄。因為Podfile.lock會鎖定當前各依賴庫的版本浙值,之后如果多次執(zhí)行pod install 不會更改版本,要pod update才會改Podfile.lock了檩小。這樣多人協(xié)作的時候开呐,可以防止第三方庫升級時造成大家各自的第三方庫版本不一致。
CocoaPods 的這篇 官方文檔 也在What is a Podfile.lock一節(jié)中介紹了Podfile.lock的作用,并且指出:
This file should always be kept under version control.
不更新 podspec
pod install --no-repo-update
pod update --no-repo-update