CocoaPods 是 iOS 開發最常用的相依套件管理工具,能省下手動下載、放檔案、設定 header search path 的麻煩。以下是最基本的四步流程。
sudo gem install cocoapods
若因為預設的 gem 來源連不上而失敗,換成國內鏡像再試:
gem sources --remove https://rubygems.org/ gem sources -a https://ruby.taobao.org/ gem sources -l # 確認來源清單是否正確 sudo gem install cocoapods
切到與 .xcodeproj 同一層的目錄,建立 Podfile:
vim Podfile
寫入平台與要引入的套件:
platform :ios, '7.0' pod "AFNetworking", "~> 2.0"
存檔離開(:wq)。這裡有個小提醒:不要在最後多留空行或空白字元,否則 pod install 可能會解析失敗。
pod install
成功時會看到類似下面的輸出:

最關鍵的一步:之後一律要開啟 .xcworkspace 而不是 .xcodeproj,否則會找不到剛加入的 framework。接著在程式碼中引入即可:
#import <AFNetworking/AFNetworking.h>
Podfile 的版本語法值得記一下:"~> 2.0" 代表允許 2.x 的最新版但不跨到 3.0;寫 "2.0.0" 則鎖死該版本。團隊協作時建議搭配產生的 Podfile.lock 一起進版控,確保所有人裝到完全相同的版本。
另外, installation 過程若遇到 SSL 或權限問題,可試著更新 RubyGems(sudo gem update --system)或改用 sudo gem install -n /usr/local/bin cocoapods。新版 macOS 系統 Ruby 環境限制較多,許多人會改用 rbenv 管理 Ruby 版本,或用 Homebrew 安裝 cocoapods 來避開這個問題。