CocoaPods 是 iOS/macOS 上最普及的相依性管理工具。它的安裝過程對新手來說不算直覺,尤其是 Ruby 環境這一段,因此這裡把整個流程從頭走一遍。
$ source ~/.rvm/scripts/rvm $ rvm --version # 查看版本,確認 rvm 是否安裝正確
接著用 rvm 安裝 Ruby:
$ rvm install 2.0.0 # 過程中需按 Enter 輸入管理員密碼 $ rvm 2.0.0 --default # 把剛才安裝的版本設為系統預設 $ ruby --version # 確認 Ruby 版本
1. 切換 Ruby 鏡像
由於國外 gem 來源連線速度往往不理想,可以改用鏡像:
$ gem sources --remove https://rubygems.org/ $ gem sources -a https://ruby.taobao.org/ $ gem sources -l # 確認目前的來源已是鏡像
2. 安裝 CocoaPods
$ sudo gem install cocoapods # 需輸入管理員密碼
3. 驗證
$ pod
能印出說明訊息就代表安裝成功。
1. 查詢第三方庫是否支援
$ pod search SDWebImage
清單會列出所有與關鍵字相關、且支援 CocoaPods 的框架及版本號。
2. 在專案中啟用 CocoaPods
以桌面上名為 test 的專案為例,進入專案所在目錄後建立 Podfile:
zhangcandeiMac:Desktop pican$ cd podsTest/ $ vim Podfile
在 Podfile 中輸入:
platform :ios, '6.1' pod 'SDWebImage', '~>3.6'
存檔退出(Esc 後輸入 :wq)。這兩行的寫法通常可以直接從第三方庫的 GitHub 說明文件中複製,文件裡都會註明該如何加入。
3. 安裝相依庫
$ pod install # 依 Podfile 內容下載安裝
安裝時間取決於網路狀況。完成後請特別注意最後一行提示:from now on use 'podsTest.xcworkspace'。
此時目錄中會多出幾個檔案:
Podfile.lock 對團隊開發格外重要。某位成員 checkout 之後執行 pod install,取得的會是與其他成員完全一致的版本;若少了這個檔案,每個人可能都裝到當時的最新版,版本不一致所帶來的問題會非常棘手。因此 Podfile.lock 應該要進版控。
4. 更新相依庫
若某個第三方庫本身又相依於其他以 CocoaPods 管理的庫,直接執行:
$ pod update # 把 Podfile 中的所有庫更新到最新版