開發移動應用幾乎一定會用到第三方套件。由於套件種類繁多、版本各異,手動下載、手動拖進專案、手動處理衝突實在過於痛苦,這時候就需要一個套件管理工具。iOS 生態中最主流的選擇就是 CocoaPods。
順帶釐清兩個名詞:Cocoa 是開發 macOS 應用的 API 集合,Cocoa Touch 則是給 iOS 觸控設備用的 API(我們新建類別時看到的「Cocoa Touch Class」就是它)。而 CocoaPods 是建在 Ruby 之上的依賴管理工具。
官網:https://cocoapods.org/。若你的機器已具備 Ruby 環境,一行指令即可裝好:
sudo gem install cocoapods
若還沒有 Ruby 環境,則依序執行以下步驟。
1. 安裝 RVM(Ruby 版本管理器)
curl -L https://get.rvm.io | bash -s stable
2. 重新載入 RVM 設定(或乾脆重開終端機)
source ~/.rvm/scripts/rvm
3. 確認 RVM 安裝成功並查看版本
rvm -v
4. 用 RVM 安裝 Ruby
rvm install 2.0.0
ruby -v # 確認 Ruby 版本
gem -v # 確認 gem 版本(安裝 Ruby 時通常會一併裝好)
5. 更換 Ruby 鏡像源。由於官方源在部分網路環境下速度不佳,可換用國內鏡像。先移除原來源:
gem sources --remove https://rubygems.org/
再加入新的鏡像源:
gem sources -a https://ruby.taobao.org/
接著確認目前使用的鏡像:
gem sources -l
看到輸出中包含 taobao.org 就代表切換成功。
6. 正式安裝 CocoaPods
sudo gem install cocoapods
稍候片刻,終端顯示安裝完成即可。
(1)建立 iOS 專案。 這裡以 Swift 為例,專案名為 CocoapodsDemo。

(2)建立 Podfile。 在終端機中進入專案根目錄,用 vim 建立名為 Podfile 的文字檔(注意檔名沒有副檔名):

(3)在 Podfile 中宣告要用的套件。 以下以 AFNetworking 為例:
platform :ios, '8.0'
use_frameworks!
target 'CocoapodsDemo' do
pod 'AFNetworking', '~> 2.6'
end

存檔退出後,回到專案根目錄執行:
pod install

(4)改用 workspace 開啟專案。 終端會提示你以後必須用 xxx.xcworkspace 開啟。關掉原本的 Xcode 專案視窗,在根目錄打開 CocoapodsDemo.xcworkspace,此時左側結構會多出一個 Pods 專案:

Podfile.lock 搭配明確的版本約束,避免團隊成員或 CI 環境裝到不同版本。pod search 找套件、pod update 更新、pod outdated 查看可更新項目。整體流程走完,第三方庫的引入與版本維護就都交給工具處理了,比手動管理清爽太多。