iOS 開發中,大多數專案都需要整合一些第三方相依庫;專案規模稍大一點,用到的庫數量就很可觀。手動管理這些庫——下載、放進專案、處理它們彼此之間的相依關係、升級、移除——是一場噩夢。
CocoaPods 是 Objective-C 生態系的事實標準相依管理工具,把這些瑣事全部自動化。
$ sudo gem install cocoapods
更新 CocoaPods:
gem update cocoapods
如果 gem 本身太舊而導致安裝失敗,先更新 gem:
sudo gem update --system
在 iOS 專案目錄下建立名為 Podfile 的文字檔(副檔名就是 Podfile,沒有額外表單格式),在裡面宣告需要的相依庫:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '8.0' pod 'AFNetworking', '~> 2.0' pod 'ARAnalytics', '~> 2.7'
不確定庫名或版本時,用搜尋指令查詢,例如尋找 MKNetworkKit:
pod search MKNetworkKit

找到後,把它寫進 Podfile:
pod 'MKNetworkKit', '~> 0.87'
或者直接寫:
pod 'MKNetworkKit'
這種寫法會自動抓取最新版本。但不建議這麼做——一旦上游庫修改了介面或推出不穩定的版本,你的專案就跟著跑不動了。強烈建議鎖定一個穩定的版本號(例如 ~> 0.87 或 0.87.1),除非你確實需要最新特性。
切換到 Podfile 所在目錄,執行:
pod install
若要更新已安裝的庫:
pod update
兩者的差別值得記住:pod install 只會安裝 Podfile 中尚未安裝或版本不符的庫,並嚴格遵守 Podfile.lock 中已鎖定的版本;pod update 則會忽略 lock 檔,把所有庫更新到符合 Podfile 條件的最高版本。日常開發請一律用 pod install,只有在你「主動想升級」時才用 pod update。
安裝完成後,不要再開 .xcodeproj,請改開 CocoaPods 產生的 (專案名稱).xcworkspace。所有相依庫都已經掛在這個 workspace 裡了。
在 .gitignore 中加入:
# Pod Pods/
這樣可以讓 Git 忽略整個 Pods 目錄,大幅精簡版本庫。其他人 clone 專案後,只要執行一次 pod install 就能還原完全相同的相依狀態。
不過要注意:Podfile.lock 必須要提交進版本庫,它是確保團隊成員裝到完全相同版本的關鍵依據,千萬不要一起忽略掉。