您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

CocoaPods 私有倉庫實戰:從代碼倉庫到 Spec Repo 的完整搭建流程

編輯:iOS 開發基礎

CocoaPods 是 iOS 與 macOS 開發中最主流的第三方庫管理工具,地位相當於 Java 世界裡的 Maven。它把「拉取依賴、約束版本、集成進工程」這一串繁瑣動作濃縮成幾條命令,讓團隊把精力放回業務本身。

問題往往出在項目推進一兩年之後:內部沉澱下來越來越多的可複用組件,既不方便開源,又希望能享受 CocoaPods 帶來的版本管理與一鍵集成。這時候,搭建一個私有倉庫就成為必選項。

如果你對 CocoaPods 的基礎用法還不熟,建議先讀唐巧的相關文章,或直接翻閱官網:https://cocoapods.org/。

需要提前說明兩點限制:CocoaPods 原生只支持以 git 管理的代碼,若團隊使用 SVN 或 Mercurial,需要額外安裝對應插件;本文全部步驟也以 git 為前提。

一、準備代碼倉庫

先把要複用的代碼推到 git 服務器上。如果這部分代碼未來計劃開源,放在 GitHub 上托管最省事。

二、給穩定版本打 tag

每當代碼達到一個可交付的穩定狀態,就應該打上一個 tag,慣例是直接用語義化版本號作為 tag 名:

git tag -a 1.0.2

然後把 tag 一起推送到遠端:

git push --tags

版本號規範建議遵循語義化版本(Semantic Versioning)約定,形如 1.0.2。這個 tag 稍後必須和 spec 倉庫中的版本目錄嚴格對應,是整個流程中最容易出錯的一環。

三、生成 podspec 文件

在 shell 中執行:

pod spec create 組件名

命令會在當前目錄生成一個「組件名.podspec」文件。這是一個結構完整的配置模板,絕大多數字段望文生義即可理解,遇到不確定的地方可以查閱官方文檔 Specs and Specs Repo,GitHub 上海量開源組件的 podspec 也是很好的參照。

四、校驗 podspec

配置寫完後,先本地驗證一遍:

pod spec lint 組件名.podspec

根據輸出的報錯逐條修正 spec 或代碼,直到出現通過提示為止。這一步能攔下九成以上的集成問題,不要跳過。

五、建立 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 服務器。

六、把私有 repo 掛到 CocoaPods 上

pod repo add REPO_NAME SOURCE_URL

七、驗證私有 repo

cd ~/.cocoapods/repos/REPO_NAME
pod repo lint .

此後若要往這個 repo 追加新組件,只需要:

pod repo push REPO_NAME 組件名.podspec

想移除本地私有 repo:

pod repo remove REPO_NAME

八、在 Podfile 中引用

私有源要寫在使用者工程的 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 倉庫:只放 spec 配置,按「組件名 / 版本號」分層歸類,不放任何代碼。

另外,spec 倉庫也可以完全放在本地而不依賴 git 服務器,但這個目錄必須用 git init 初始化過才能正常工作。

最後一點好消息:第 1 到第 8 步只需在你自己機器上執行一次。團隊其他成員拉取代碼後,只要更新 Podfile 就能直接引用私有倉庫裡的組件了。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved