手動管理第三方函式庫是件痛苦的事:要下載原始碼、拖進專案、設定 header search path、處理系統框架相依、更新時還得重來一遍。CocoaPods 把這一切都自動化了。
它是一個專門管理 iOS / macOS 專案中第三方開源程式碼的相依性工具,原始碼在 GitHub 上開源。你只要在一個文字檔裡寫清楚要哪些套件、哪些版本,執行一道指令,它就會幫你下載、配置專案設定、處理套件之間的相依關係。省下的時間與避免的人為錯誤相當可觀。
CocoaPods 以 Ruby gem 形式發布,在終端機依序執行:
sudo gem install cocoapods pod setup
pod setup 會把 spec 索引庫 clone 到本機,第一次執行需要等候一段時間。若你的網路環境無法順利存取 GitHub,可以先換用鏡像來源:
gem sources -a https://ruby.taobao.org/
第一步,在 Xcode 建立專案(例如 PodsDemo),完成後關閉 Xcode。
第二步,在終端機 cd 進入專案所在目錄,建立配置檔:
vi Podfile
內容可以寫成:
platform :ios, '7.0' pod 'AFNetworking'
除了宣告要用的套件,platform 這行同時指定了專案支援的最低系統版本。
第三步,存檔退出(:wq),然後安裝:
pod install
第四步,從此之後請改用 Finder 打開 PodsDemo.xcworkspace,而不是原本的 .xcodeproj。CocoaPods 建立的 workspace 同時包含了你的專案與 Pods 專案,直接開 xcodeproj 會找不到標頭檔。
小提醒:在較舊的 Xcode 版本中,#import 時可能沒有自動補全提示,但手動輸入完整名稱仍能正常編譯,不必誤以為設定有錯。
搜尋可用的第三方套件:
pod search json
可以輸入完整套件名稱,也可以只用關鍵字模糊搜尋。
更新相依:編輯 Podfile 增減套件後存檔,執行:
pod update # 或 pod install
兩者的差異值得記住:pod install 只會安裝 Podfile 中新增的套件,並嚴格遵守 Podfile.lock 中鎖定的版本,適合日常開發與多人協作;pod update 會忽略 lock 檔重新解析並升級到符合 Podfile 約束的最新版本,適合明確想升級時使用。提交原始碼時,Podfile.lock 一定要進版控,這樣團隊成員才會拿到完全一致的版本。
更多資訊可參考官方文件:https://docs.cocoapods.org/guides/getting_started.html
由於 CocoaPods 以 gem 發布,順手整理幾個常用指令:
gem sources -a https://ruby.taobao.org/ # 加入套件來源 gem sources --list # 列出目前來源 sudo gem update --system # 升級 gem 本身 gem --version # 查看版本 gem cleanup # 清除過舊版本 gem install <name> # 安裝 gem uninstall <name> # 移除 gem update # 更新所有已安裝套件 gem list # 列出已安裝套件
最後補充一個實務建議:Podfile 中盡量鎖定版本(例如 pod 'AFNetworking', '~> 3.0'),避免團隊不同成員在不同時間執行 pod install 拿到不同版本,這是多人協作最常見的踩坑來源。