在 iOS 開發早期,整合第三方庫是件令人頭疼的事:手動下載、拖拽檔案、設定 Header Search Paths、處理依賴關係……稍有不慎就會出現編譯錯誤。CocoaPods 的出現徹底改變了這一切,它是基於 Ruby 的依賴管理工具,能自動下載、配置並連結第三方庫,讓開發者專注於業務邏輯而非專案配置。
打開終端機,執行以下指令(可能需要幾分鐘):
sudo gem install cocoapods
若希望為每個第三方庫自動產生文件,可安裝 appledoc:
brew install appledoc
若 Ruby 版本過舊,請先更新:
gem update --system
安裝完成後,終端機會顯示類似下圖的成功訊息:

想使用 JSONKit?直接搜尋:
pod search JSONKit
搜尋結果會顯示版本、來源等資訊:

在終端機 cd 到專案根目錄,執行:
pod init
執行完成後,專案目錄會多出 Podfile、*.xcworkspace 等檔案:

之後請務必打開 .xcworkspace 檔案而非 .xcodeproj,Xcode 專案導覽區會呈現 Pods 專案結構:

Podfile:vim Podfileplatform :ios, '5.0'
pod 'JSONKit'
pod update
CocoaPods 會自動下載 JSONKit 並與本地專案關聯。Xcode 可能提示更新專案設定,點選 Revert 即可:

此時 Pods 專案下已出現 JSONKit:

若在 ViewController.m 中 #import "JSONKit.h" 找不到標頭檔,需在 Target → Build Settings → Header Search Paths 新增 ${SRCROOT} 並勾選 recursive:

在 Podfile 中列出所有需要的庫,再執行 pod update:
platform :ios, '5.0'
pod 'JSONKit'
pod 'AFNetworking'
pod 'MBProgressHUD'
pod 'Reachability'
pod 'Nimbus/Core' # 僅引入 Nimbus 的 Core 子模組
CocoaPods 還支援版本鎖定、私有 Spec Repo、subspecs 選擇性引入、預編譯加速等進階功能,可依專案需求深入探索。