
CocoaPods 是 iOS 與 macOS 開發中最主流的第三方庫管理工具,地位相當於 Java 世界裡的 Maven。它把「拉取依賴、約束版本、集成進工程」這一串繁瑣動作濃縮成幾條命令,讓團隊把精力放回業務本身。
問題往往出在項目推進一兩年之後:內部沉澱下來越來越多的可複用組件,既不方便開源,又希望能享受 CocoaPods 帶來的版本管理與一鍵集成。這時候,搭建一個私有倉庫就成為必選項。
如果你對 CocoaPods 的基礎用法還不熟,建議先讀唐巧的相關文章,或直接翻閱官網:https://cocoapods.org/。
需要提前說明兩點限制:CocoaPods 原生只支持以 git 管理的代碼,若團隊使用 SVN 或 Mercurial,需要額外安裝對應插件;本文全部步驟也以 git 為前提。
先把要複用的代碼推到 git 服務器上。如果這部分代碼未來計劃開源,放在 GitHub 上托管最省事。
每當代碼達到一個可交付的穩定狀態,就應該打上一個 tag,慣例是直接用語義化版本號作為 tag 名:
git tag -a 1.0.2
然後把 tag 一起推送到遠端:
git push --tags
版本號規範建議遵循語義化版本(Semantic Versioning)約定,形如 1.0.2。這個 tag 稍後必須和 spec 倉庫中的版本目錄嚴格對應,是整個流程中最容易出錯的一環。
在 shell 中執行:
pod spec create 組件名
命令會在當前目錄生成一個「組件名.podspec」文件。這是一個結構完整的配置模板,絕大多數字段望文生義即可理解,遇到不確定的地方可以查閱官方文檔 Specs and Specs Repo,GitHub 上海量開源組件的 podspec 也是很好的參照。
配置寫完後,先本地驗證一遍:
pod spec lint 組件名.podspec
根據輸出的報錯逐條修正 spec 或代碼,直到出現通過提示為止。這一步能攔下九成以上的集成問題,不要跳過。
除了存放代碼的倉庫,你還需要一個專門存放 spec 的倉庫。它的目錄結構必須符合 CocoaPods 約定:
Specs/
└── [SPEC_NAME]
└── [VERSION]
└── [SPEC_NAME].podspec
實際展開後大致如下:
Specs/
├── QueryKit/
│ ├── 0.8.0/
│ │ └── QueryKit.podspec
│ ├── 0.8.1/
│ │ └── QueryKit.podspec
│ ├── 0.8.2/
│ │ └── QueryKit.podspec
│ └── 0.8.3/
│ └── QueryKit.podspec
└── URITemplate/
├── 1.0.0/
│ └── URITemplate.podspec
└── 1.0.1/
└── URITemplate.podspec
請再次確認:這裡的版本號目錄要與代碼倉庫中的 tag 一一對應。準備好之後,同樣推送到 git 服務器。
pod repo add REPO_NAME SOURCE_URL
cd ~/.cocoapods/repos/REPO_NAME pod repo lint .
此後若要往這個 repo 追加新組件,只需要:
pod repo push REPO_NAME 組件名.podspec
想移除本地私有 repo:
pod repo remove REPO_NAME
私有源要寫在使用者工程的 Podfile 頂部,通常還會同時保留官方源:
source 'https://github.com/agdsdl/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, "7.0"
target "XXX" do
pod 'DLSlideView', '~>0.8.1'
end
到工程目錄執行:
pod update
依賴更新完成後,打開 workspace 文件,點擊 Run。搞定。
最容易犯的就是把 spec repository 和代碼 repository 混為一談,我在這裡卡了相當長一段時間。區分方式很簡單:
另外,spec 倉庫也可以完全放在本地而不依賴 git 服務器,但這個目錄必須用 git init 初始化過才能正常工作。
最後一點好消息:第 1 到第 8 步只需在你自己機器上執行一次。團隊其他成員拉取代碼後,只要更新 Podfile 就能直接引用私有倉庫裡的組件了。