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

CocoaPods 進階實戰(下):打造並管理你的私有庫

編輯:iOS 開發基礎

本文為系列第二部分,第一部分請見 https://www.cocoachina.com/ios/20150906/13323.html 。這裡延續第一部分用 pod lib create YohunlUtilsPod 建立的 framework 工程來說明,你也可以下載作者已建好的 demo:https://github.com/yohunl/YohunlUtilsPod 。私有庫通常不會放在 GitHub,各公司多有自己的 Git 平台,但操作方式大同小異。

一、建立自己的私有 spec 倉庫

可用終端命令顯示隱藏目錄開啟 .cocoapods(位於個人目錄下,如 /Users/yohunl/.cocoapods):

defaults write com.apple.finder AppleShowAllFiles -bool TRUE; killall Finder // 關閉隱藏:defaults delete com.apple.finder AppleShowAllFiles; killall Finder

其中 repos 存放倉庫集合,master 是 CocoaPods 官方倉庫(即公共庫);specs 目錄則存放所有提交到 CocoaPods 的開源庫 podspec 檔集合,結構為:specName — 版本 version — specName.podspec(官方庫目前為 specName.podspec.json)。這個文件夾在你首次 pod install 時由 CocoaPods 自動執行 pod setup 建立,若要重建官方倉庫可執行:

pod repo remove master pod setup

官方建立私有 repo 的文檔見 https://guides.cocoapods.org/making/private-cocoapods.html 。先在 GitHub 建一個空倉庫(如 yohunlSpecs)用來存放私有庫的 specs,再以命令建立本地私有 repo:

$ pod repo add REPO_NAME SOURCE_URL

例如 pod repo add yohunlSpecs git@github.com:yohunl/yohunlSpecs.git(http 與 ssh 兩種皆可)。執行後 .cocoapods/repos 下便會出現你的私有倉庫,此時它還是空的。

二、把 YohunlUtilsPod 的 spec 檔加入 yohunlSpecs

打開工程的 podspec 檔,依需求修改(本質上是 Ruby 格式檔),完成後執行驗證:

pod spec lint // 常出現 "2 out of 2 specs failed validation" 的怪錯,可忽略 pod lib lint // 驗證由 pod lib create 建立的 lib 工程 spec,較推薦

驗證通過後,由於 CocoaPods 的 repo 基於 git tag,需為工程加上與 podspec 描述一致的 tag(版本號建議遵循 https://semver.org/lang/zh-CN/ 規範),否則他人引用時會不知道該下載哪些程式碼:

$ git tag '1.0.0' $ git push --tags $ git push origin master

最後在 podspec 所在目錄執行:

pod repo push yohunlSpecs YohunlUtilsPod.podspec

完成後即可用 pod search YohunlUtilsPod 搜到它。

三、測試是否可用

建立一個普通工程 TestPodFrameworkDemo,用 pod init 建立 Podfile,加入 pod 'YohunlUtilsPod':

target 'TestPodFrameworkDemo' do pod 'YohunlUtilsPod' end target 'TestPodFrameworkDemoTests' do end

執行 pod install 時可能會找不到——因為若不指定 source,pod install 預設只在 master 下搜尋,而我們的 spec 在 yohunlSpecs 下。解法是在 Podfile 最上方加上:

source 'https://github.com/yohunl/yohunlSpecs.git' # 自己的私有 spec 倉庫 source 'https://github.com/CocoaPods/Specs.git' # 官方倉庫

注意:一旦加了 source,系統就不再自動搜尋官方源,所以兩句都必須補上,否則其他依賴官方庫的 pod 都會失敗。再次執行 pod install 即成功。之後他人使用時,只需在 Podfile 加上這兩行 source 與 pod 'YohunlUtilsPod' 即可。

題外話

1. 查看本地 repo 數量:pod repo,會列出每個 repo 的類型與位址。

2. 統一驗證某 repo 下所有 podspec:進入該 repo 目錄執行 pod repo lint .(注意結尾的點)。

3. 常用命令:

pod list # 列出所有可用的第三方庫 pod search query # 搜尋包含 query 的庫(僅搜本地) pod lib create frameworkName # 建立 framework 工程 pod lib lint # 驗證 podspec 是否有錯 pod install --no-repo-update # 跳過更新 repo,加快安裝速度 pod init # 建立空的 Podfile pod spec create spec名字 # 建立 spec 檔

4. 使用私有 framework 的其他方式:當你在 Podfile 加上 source 並執行 pod install 後,.cocoapods 下會多出對應的 repo。也就是說,pod repo add 與 pod repo push 只是為了把 spec 檔加入 GitHub 倉庫,完成後其實可刪除本地的 repo(pod repo remove 倉庫名),之後 pod install 會依 source 自動下載。此外,也可不加入私有倉庫直接使用:

target 'TestPodFrameworkDemo' do pod 'YohunlUtilsPod' , :path => '/Users/yohunl/YohunlUtilsPod' end

此方式會把庫放在 Development Pods 下。也可用 :git 指定倉庫、:podspec 指定 podspec 檔路徑(注意 :podspec 指向本地路徑可行,指向 GitHub blob 網址則測試失敗)。若確定 podspec 正確可用,也可直接提交到私有倉庫。

5. 打包 framework 的第三方外掛:可用 cocoapods-packager(sudo gem install cocoapods-packager),其優點在於透過對引用三方庫重新命名,很好地解決了類庫命名衝突的問題。

參考文檔

  • 使用 CocoaPods 開發並打包靜態庫

  • Advanced CocoaPods 系列文章

  • 提交 framework 到 CocoaPods 官方

  • 建立私有庫相關文章

註:部分文章已不適用於新版 Xcode 與 CocoaPods,閱讀時請留意版本差異。

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