
本文投稿文章,作者:skytoup(Github)
CocoaPods 是一個管理 Swift 與 Objective-C Cocoa 項目依賴的工具,目前庫數量已超過一萬八千個。簡單說,它替你完成第三方庫的引入、版本管理與工程配置,省去手工拖文件、手動配 link flag 的麻煩。
官網地址:https://cocoapods.org/
macOS 自帶 Ruby,通常不需要另外安裝(除非你卸載過)。
打開 Terminal,依次輸入以下命令(第二條可能需要稍等一會兒):
gem sources --remove https://rubygems.org/ gem source -a https://gems.ruby-china.org
第一條移除官方源,因為不翻牆時訪問較慢;第二條添加 ruby-china 的 RubyGems 鏡像。注意:很多舊教程讓你用 taobao 的 gem 源,但該源已停止維護,請改用 ruby-china(原文見 https://ruby-china.org/topics/29250)。
接著確認鏡像是否添加成功:
gem source
輸出中出現 ruby-china 的鏡像地址,說明配置完成。
然後正式安裝 CocoaPods:
sudo gem install cocoapods
等待片刻即可裝好。安裝結束後執行一次初始化:
pod setup
沒有報錯,整個安裝流程就結束了。
cd 到你的工程目錄,執行:
pod init
執行完畢後,該目錄下會生成一個 Podfile。用文本編輯器(vim、Sublime Text 等)打開,大致會看到:
platform :ios, 'xxx' # 目標平台及版本
use_frameworks! # Swift 項目需要這句,Objective-C 項目請在前面加 # 註釋掉
target 'xxxx' do
# 在這裡添加依賴庫,例如:
pod 'Alamofire', '~> 3.1'
end
編輯完 Podfile 後,cd 到 Podfile 所在目錄,執行其中之一:
pod install --no-repo-update # 或 pod install
第一條不更新本地庫信息,速度更快,但遇到剛發布的新庫時可能裝不上。若不嫌麻煩,可以定時執行一次:
pod repo update
之後再用第一條命令安裝即可。
安裝完成後,打開項目要打開 xxx.xcworkspace,而不是 xxx.xcodeproj,這一點經常被忽略。
如果之後修改了 Podfile,執行以下命令之一更新依賴(兩者區同上):
pod update --no-repo-update # 或 pod update
最常見的是 gem 版本過舊。先切換到 ruby-china 源,再執行:
sudo gem update
更新完成後重新安裝 CocoaPods,一般就能通過。此外,如果你之前用 sudo 安裝過舊版本,建議先卸載再重裝,避免多版本共存導致命令指向錯誤。