開發 iOS 應用時,幾乎一定會用到第三方開源庫,例如 JSONKit、AFNetworking 等。有些庫又依賴其他庫,為了用它你得先補齊一長串依賴;更麻煩的是,當某個庫有了新版本,你還得重新下載、重新加入專案,過程瑣碎又容易出錯。
CocoaPods 正是為了解決這些惱人之事而生,而且它應該是 iOS 生態中最常見、最有名的類別庫管理工具。上述兩個問題,只要一行命令就能搞定(前提是環境設定正確)。更關鍵的是,絕大多數知名開源庫都支援 CocoaPods,因此把它學會算是 iOS 開發者的基本功。
安裝前,本機必須先有 Ruby 環境。Mac 上的 Ruby 環境建置方式這裡不展開。
若 Ruby 已就緒,安裝只需一行命令,在終端機輸入:
sudo gem install cocoapods
但在某些網路環境下,你會發現指令敲完之後老半天沒反應——因為預設的 gem 來源被牆住了。
解法是改用鏡像來源。依序在終端機執行:
gem sources --remove https://rubygems.org/ // 等上面這個有反應之後,再執行下一行 gem sources -a https://ruby.taobao.org/
接著驗證來源是否已只剩鏡像:
gem sources -l
只有輸出下面這段,才代表前面的步驟成功:
*** CURRENT SOURCES *** https://ruby.taobao.org/
完成上述設定後,終端機上的畫面大致如下:

此時再執行一次安裝指令:
sudo gem install cocoapods
等十幾秒,CocoaPods 就裝好了,不需要其他設定。

好消息是,使用它同樣簡單。下面用兩個常見場景說明。
AFNetworking 的 GitHub 位址是 https://github.com/AFNetworking/AFNetworking 。動手前可以先確認它是否支援 CocoaPods:
pod search AFNetworking
幾秒後終端機會列出相關資訊,能搜到就代表支援。

接著用 Xcode 建一個名為 CocoaPodsDemo 的專案。先看一下尚未支援 CocoaPods 時的目錄結構,稍後好做對比:

你可能會好奇:CocoaPods 怎麼知道該下載哪些庫?答案是靠一個名為 Podfile 的檔案(檔名必須精確,而且沒有副檔名)。你在裡面寫上要下載的庫,等於告訴 CocoaPods「就是這些,快到碗裡來」。每個專案只需要一個 Podfile。
在終端機中切換到專案目錄,用 vim 建立 Podfile:
vim Podfile
寫入以下內容:
platform :ios, '7.0' pod "AFNetworking", "~> 2.0"
這兩行並非憑空而來,通常可以在該庫的 GitHub 頁面找到。意思是:支援的 iOS 平台版本為 7.0,要下載的 AFNetworking 版本為 2.0 以上。
存檔退出(vim 下輸入 :wq)。此時專案目錄中會出現一個 Podfile,位置必須和 .xcodeproj 同一層。
接著在同一個目錄執行:
pod install
之所以要在專案目錄下執行,就是因為這是把庫安裝進「這個專案」。
終端機大致會輸出:
EricmatoMacBook-Pro:CocoaPodsDemo ericwang$ pod install Analyzing dependencies Downloading dependencies Installing AFNetworking (2.0.2) Generating Pods project Integrating client project [!] From now on use `CocoaPodsDemo.xcworkspace`.
最後一句很關鍵:以後請用 CocoaPodsDemo.xcworkspace 開啟專案,而不是原本的 .xcodeproj。
.xcworkspace 正是 pod install 產生的。此外還會多出 Podfile.lock 與一個 Pods 目錄。打開 workspace 後,目錄結構如下:

AFNetworking 已經成功進到專案裡(紅框處)。現在你可以直接:
#import <AFNetworking.h> // 或 #import "AFNetworking.h"
編譯看看,若前面步驟無誤是不會出錯的。
小結一下,導入流程就兩步:建立 Podfile(內容通常是原作者在 README 中提供的寫法),然後執行 pod install。
新手常遇到這種情況:在 GitHub 找到一份符合需求的程式碼,興沖沖下載回來一編譯,滿屏都是找不到某個 header 的錯誤。先別慌,仔細看會發現專案裡有 Podfile——這代表你可以用 CocoaPods 輕鬆補齊依賴。
以 UAAppReviewManager 為例(它能幫你把「提醒使用者評分」的功能加入 App)。下載後打開 Example 專案編譯,會看到一堆找不到頭檔案的錯誤;同時你會在 UAAppReviewManagerExample 目錄下發現三個與 CocoaPods 相關的項目:Podfile、Podfile.lock 與 Pods。

打開終端機,切到與 Podfile 同一層的目錄,執行(因為已有 Podfile,不必再建立):
pod update
稍等片刻,終端機輸出:
Analyzing dependencies Fetching podspec for `UAAppReviewManager` from `../` Downloading dependencies Installing UAAppReviewManager (0.1.6) Generating Pods project Integrating client project [!] From now on use `UAAppReviewManagerExample.xcworkspace`.
回到目錄會看到多出一個 UAAppReviewManagerExample.xcworkspace:

之後就用這個 workspace 開啟並執行:

這裡有個容易踩的坑:如果你改用 pod install,可能會失敗並出現:
[!] Required version (UAAppReviewManager (from `../`)) not found for `UAAppReviewManager`. Available versions: 0.1.6
意思是 Podfile 裡指定的版本已過期,與實際可用版本不符。pod install 只會照 Podfile 的要求去抓,版本對不上就失敗;而 pod update 會更新所有庫到最新版。實測時用過 pod update 之後再跑 pod install 也會成功。
那到底何時該用哪一個?如果你不確定庫有沒有出新版,最省事的策略是:先試 pod install,失敗再換 pod update。