前言
CocoaPods 三方庫(kù)管理工具相信大家都不會(huì)陌生犁钟,開(kāi)發(fā)工程中多多少少都有過(guò)接觸振峻,一方面它能夠幫我們管理依賴庫(kù)糕伐,三方庫(kù)忍啸,另一方面仰坦,我們可以將自己的代碼庫(kù)提交給 CocoaPods 分享給他人,也能為自己的其他項(xiàng)目提供便捷的支持计雌。那么悄晃,今天就簡(jiǎn)單介紹一下如何讓自己的工具庫(kù)支持 Cocoa Pods 集成。
必要條件
我們要先準(zhǔn)備幾項(xiàng)必要得東西凿滤。
- 代碼庫(kù)
可以是 Git 項(xiàng)目妈橄,也可以是其他如碼云,Coding 等其他平臺(tái)得項(xiàng)目鸭巴。
- podspec 配置文件
這份文件用來(lái)描述你的項(xiàng)目信息眷细,如項(xiàng)目名稱、項(xiàng)目版本鹃祖、項(xiàng)目地址溪椎、作者、資源文件等信息恬口,它具有一定的語(yǔ)法規(guī)則校读,你可以通過(guò) 官方指導(dǎo)文件 了解更多信息。
- CocoaPods 賬號(hào)
賬號(hào)記錄了你在 CocoaPods 上所有發(fā)布的工具庫(kù)信息祖能,該賬號(hào)可以在終端使用命令進(jìn)行注冊(cè)歉秫,后續(xù)會(huì)提到如何進(jìn)行注冊(cè)。
1. 代碼庫(kù)
本文以 Github 項(xiàng)目為例养铸。先來(lái)創(chuàng)建一個(gè)自己的項(xiàng)目雁芙。關(guān)于如何使用 Github 你可以參考其他網(wǎng)絡(luò)文章,這里不做過(guò)多的演示钞螟。
登錄到 Github 上兔甘,創(chuàng)建你的項(xiàng)目,如果已經(jīng)有了項(xiàng)目鳞滨,可以跳過(guò)這個(gè)步驟
-
創(chuàng)建項(xiàng)目
- 創(chuàng)建測(cè)試文件并提交到遠(yuǎn)程 Git
將創(chuàng)建的項(xiàng)目 clone
到本地洞焙,使用的工具,方式都不限。為了測(cè)試工具的使用澡匪,你可以任意創(chuàng)建一個(gè)工具類熔任,內(nèi)容不限,最后將該文件提交至遠(yuǎn)程 Git 唁情。
- 發(fā)布項(xiàng)目
到代碼庫(kù)中構(gòu)建 release
發(fā)布版本疑苔。你也可以在本地項(xiàng)目上打上 tag
推送到遠(yuǎn)程 Git,方式不限甸鸟,我們只需要保證 Github 上有可以的發(fā)布版本就可以夯巷。
為你的發(fā)布版本填寫(xiě)一些相關(guān)信息。
2. podspec 配置文件
進(jìn)入到項(xiàng)目文件夾哀墓。創(chuàng)建 podspec
文件忘苛。
我這里使用終端進(jìn)行文件的創(chuàng)建麦锯。
$ touch yourProjectName.podspec
創(chuàng)建完成之后,我們來(lái)編輯這份文件镇眷。你可以在項(xiàng)目文件夾中找到這份文件季惯,手動(dòng)打開(kāi)進(jìn)行編輯即可吠各。我這里依舊使用終端命令進(jìn)行編輯。
$ vim yourProjectName.podspec
podspec
文件主要涉及到你項(xiàng)目名稱勉抓、版本贾漏、簡(jiǎn)介、資源藕筋、平臺(tái)等等信息
使用 i
進(jìn)入編輯模式纵散,編輯完成,點(diǎn)擊 esc
,然后 shift+zz
退出編輯
該文件大體如下:
這里需要提到的就是資源文件的設(shè)置隐圾,你可以為你共享的資源文件創(chuàng)建一個(gè)單獨(dú)的文件夾伍掀,將這些需要共享的文件都放在這個(gè)文件下。CocoaPods 會(huì)去下載你所設(shè)置的資源路徑下的文件暇藏。
你可以通過(guò) 官方指導(dǎo)文件 了解更多關(guān)于 podspec
配置文件的語(yǔ)法信息蜜笤。
3. 注冊(cè)賬號(hào)并上傳 podspec
配置文件
現(xiàn)在我們已經(jīng)發(fā)布的自己的項(xiàng)目,并且已經(jīng)寫(xiě)好對(duì)應(yīng)的 podspec
配置文件了盐碱,往事俱備把兔,只欠東風(fēng)。接下來(lái)瓮顽,我們要把這份配置文件提交給 CocoaPods 即可县好。
- 注冊(cè) CocoaPods 賬號(hào)
如果你沒(méi)有 CocoaPods 賬號(hào),或者你在新的環(huán)境中沒(méi)有連接過(guò)賬號(hào)趣倾,你可以終端注冊(cè)一個(gè)聘惦。
通過(guò)下面的命令來(lái)注冊(cè)賬號(hào)。
$ pod trunk register 郵箱地址 用戶名 --description=描述信息
根據(jù)提示登錄你所注冊(cè)的郵件進(jìn)行激活即可。激活成功就會(huì)出現(xiàn)下面的提示善绎。
可通過(guò)下面的命令查看當(dāng)前的 CocoaPods 賬號(hào)信息黔漂。
$ pod trunk me
- 上傳
podspec
配置文件
接下來(lái),我們需要將本地的這份項(xiàng)目配置文件推送給 CocoaPods 服務(wù)器禀酱。
上傳之前炬守,最好先驗(yàn)證一下你的 podspec
文件格式是否通過(guò)校驗(yàn)。進(jìn)入該文件所在的文件夾下剂跟,輸入驗(yàn)證命令减途,無(wú)需指定文件名稱即可校驗(yàn) podspec
后綴的文件。
$ pod spec lint
如果發(fā)生錯(cuò)誤曹洽,即 ERROR
提示鳍置,找到問(wèn)題所在進(jìn)行改正即可。
如果驗(yàn)證通過(guò)送淆,輸入下面命令將文件上傳税产。
$ pod trunk push yourProjectName.podspec --allow-warnings
上傳成功后,更新你本地的 repos
然后再搜索你的庫(kù)偷崩。
$ pod repo update
$ pod search yourProject
如果依舊搜索不到辟拷,那么需要?jiǎng)h除掉本地緩存的搜索索引文件,再重新執(zhí)行搜索操作阐斜。
$ rm ~/Library/Caches/CocoaPods/search_index.json
$ pod search yourProject
也可以去官網(wǎng)搜索衫冻。
- 更新框架版本
當(dāng)你需要更新你的工具庫(kù)時(shí),你需要:
重新發(fā)布版本 -> 修改 podspec
文件信息 -> 上傳 CocoaPods
是不是異常簡(jiǎn)單呢谒出?快去試試吧隅俘。
總結(jié)
CocoaPods 工具極大提高了我們的開(kāi)發(fā)效率,我們無(wú)需花費(fèi)過(guò)多精力去管理依賴庫(kù)和三方庫(kù)笤喳。通過(guò) CocoaPods 我們可以方便的將自己的工具庫(kù)分享給他人使用考赛。分享工具庫(kù)只需要準(zhǔn)備三個(gè)必要條件,一份代碼庫(kù)莉测,一份配置文件颜骤,一個(gè) CocoaPods 賬號(hào),有了這些準(zhǔn)備捣卤,我們分享自己的工具僅僅需要花幾分鐘的時(shí)間而已忍抽。通過(guò) CocoaPods 工具,我們可以隨心所欲的分享董朝、使用庫(kù)鸠项。