做 iOS 開發很難不碰到第三方開源庫,SBJson、AFNetworking、Reachability 幾乎是必備。而傳統手動整合的流程大致是:
專案一大,這件事立刻就變成惡夢。CocoaPods 的出現就是為了把這些瑣事全部自動化——我們只需要寫幾行設定,剩下的交給它。
簡單說,CocoaPods 是一個用來管理第三方相依庫的工具。它能解析庫之間的相依關係、下載原始碼,並透過建立一個 Xcode workspace 把這些庫和我們的專案串接起來,讓我們可以自動化、集中且直覺地管理所有開源元件。
CocoaPods 以 Ruby 實作,因此環境需要 Ruby。好消息是 OS X 預設就能跑 Ruby,所以只要一行命令:
$ sudo gem install cocoapods
安裝過程中若詢問是否更新 rake,輸入 y 即可——rake 這個 gem 會在安裝時檢查是否有新版本。安裝結束後執行:
$ pod setup
沒有報錯就代表裝好了。
① 執行 install 後卡住沒反應。很可能是因為 Ruby 預設源是 cocoapods.org,國內存取不穩定。可以換成鏡像:
$ gem sources --remove https://rubygems.org/ // 等它回應後再執行下一行 $ gem sources -a https://ruby.taobao.org/
驗證是否成功:
$ gem sources -l
正常輸出:
*** CURRENT SOURCES *** https://ruby.taobao.org/
② gem 版本過舊。gem 是 Ruby 函式庫與程式的標準套件管理器,版本太低也會導致安裝失敗,升級即可:
$ sudo gem update --system
③ 裝完執行 pod setup 卻報找不到 cocoapods。
/Users/wangzz/.rvm/rubies/ruby-1.9.3-p448/lib/ruby/site_ruby/1.9.1/rubygems/dependency.rb:298:in `to_specs': Could not find 'cocoapods' (>= 0) among 6 total gem(s) (Gem::LoadError)
這是 RVM 的 Ruby 路徑沒切對,指定一下即可:
$ rvm use ruby-1.9.3-p448
升級 CocoaPods:重跑一次安裝命令就行。
$ sudo gem install cocoapods
要注意的是,當初安裝用了 sudo,升級也得用,否則容易出現路徑不一致的問題。
以下示範專案名為 CocoaPodsTest。
1. 建立 Podfile
CocoaPods 的一切都從這個檔案開始:
$ cd /Users/wangzz/Desktop/CocoaPodsTest $ touch Podfile
先切到專案根目錄,建立一個空白 Podfile:

(Podfile 也可以不放根目錄,只是稍麻煩,下一篇會說明。)
2. 編輯 Podfile
以 Reachability、SBJson、AFNetworking 三個庫為例:
platform :ios pod 'Reachability', '~> 3.0.0' pod 'SBJson', '~> 4.0.0' platform :ios, '7.0' pod 'AFNetworking', '~> 2.0'
3. 執行安裝
$ cd /Users/wangzz/Desktop/CocoaPodsTest $ pod install
輸出大致如下:
Analyzing dependencies Downloading dependencies Installing AFNetworking (2.1.0) Installing JSONKit (1.5pre) Installing Reachability (3.0.0) Generating Pods project Integrating client project [!] From now on use `CocoaPodsTest.xcworkspace`.
最後一行是关键:從現在起請改用 .xcworkspace 開啟專案。

根目錄多了三樣東西:CocoaPodsTest.xcworkspace、Podfile.lock 與 Pods 目錄。
整合過程中發生了什麼?
其一,第三方庫會被編譯成靜態庫。CocoaPods 把所有庫以 target 的形式組成一個名為 Pods 的工程(就在新產生的 Pods 目錄下),最終產出 libPods.a 供我們的專案使用。
其二,兩份工程由一個 workspace 共同管理。CocoaPodsTest 與 Pods 會被組織進 CocoaPodsTest.xcworkspace,方便統一檢視。
其三,原本的專案設定已被改寫,直接開 .xcodeproj 編譯會出錯,務必改用 workspace。

打開 workspace 之後,目錄結構一目了然。在專案中 import 剛才加入的第三方庫標頭檔,編譯通過——整合成功。
1、https://code4app.com/article/cocoapods-install-usage
2、https://cocoapods.org/