如果你對(duì)pods還不是很了解蔗崎，建議先閱讀一下同系列的上篇文章酵幕，先對(duì)pods有一個(gè)較為清晰全面的認(rèn)識(shí)。如果你已經(jīng)具備了一定的了解缓苛，并試圖創(chuàng)建自己的私有庫(kù)或者內(nèi)部使用的內(nèi)部庫(kù)芳撒，那么本篇文章能有效與你進(jìn)行溝通交流。話不多說(shuō)未桥，我們還是即刻出發(fā)吧笔刹！
pod系列文章
Cocoapods，讓iOS開(kāi)發(fā)更簡(jiǎn)單（一）：走近Cocoapods
Cocoapods钢属，讓iOS開(kāi)發(fā)更簡(jiǎn)單（二）：創(chuàng)建私有庫(kù)
Cocoapods徘熔，讓iOS開(kāi)發(fā)更簡(jiǎn)單（三）：實(shí)踐經(jīng)驗(yàn)匯總
一文帶你快速分清靜態(tài)庫(kù)-動(dòng)態(tài)庫(kù)-Framework
如何創(chuàng)建私有庫(kù)
要?jiǎng)?chuàng)建私有Pod，首先我們需要兩個(gè)私有倉(cāng)庫(kù)淆党，code repo放私有Pod源碼，spec repo放私有Pod的說(shuō)明書(shū)（類似公有Pod的CocoaPods/Specs）讶凉。
repo簡(jiǎn)介
- code repository：代碼倉(cāng)庫(kù)染乌，我們把項(xiàng)目代碼上傳到這個(gè)倉(cāng)庫(kù)。
- spec repository：配置倉(cāng)庫(kù)懂讯，所有的配置按照包名荷憋、版本號(hào)分門(mén)別類的存放在這個(gè)倉(cāng)庫(kù)。這個(gè)倉(cāng)庫(kù)只用來(lái)存放.Podspec文件褐望，不存放代碼勒庄。
步驟
- 如果之前已經(jīng)有私有spec repo，無(wú)需再建瘫里。如果沒(méi)有实蔽，需要新建。創(chuàng)建一個(gè)私有的Spec Repo谨读，添加其到本地
pod repo add [Private Repo Name] [your_privateSpecs.git]
如果執(zhí)行成功局装，之后便可以通過(guò)pod repo list命令查看本地Spec倉(cāng)庫(kù)列表，正常情況下會(huì)有一個(gè)公有的CocoaPods官方的master repo 和你的 privateSpecs repo，并可以看到它們?cè)诒镜氐拇娣怕窂剑ㄆ鋵?shí)在~/.cocoapods/repos目錄下）铐尚。
-
在想要?jiǎng)?chuàng)建的目錄文件夾下拨脉，創(chuàng)建Pod私有庫(kù)
pod lib create TestPodlib目錄結(jié)構(gòu)如下：
├── Example #demo APP
│ ├── TestPodlib
│ ├── TestPodlib.xcodeproj
│ ├── TestPodlib.xcworkspace
│ ├── Podfile #demo APP 的依賴描述文件
│ ├── Pods #demo APP 的依賴文件
│ └── Tests
├── TestPodlib #庫(kù)目錄
│ ├── Assets #資源文件
│ └── Classes #類文件
├── TestPodlib.podspec #podspec文件
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj
主要有兩部分組成:
* TestPodlib: 組件源碼
* Example：Demo 工程，會(huì)依賴 TestPodlib 庫(kù)到此 demo 工程宣增，方便調(diào)試
pod lib會(huì)從 github 下載模版工程玫膀，創(chuàng)建完成會(huì)自動(dòng)打開(kāi) Example 下的TestPodlib.xcworkspace，在 pod 的工程下有一個(gè)Development Pods目錄爹脾，pod 把我們的源碼做為 Demo 工程的一個(gè) pod 庫(kù)匆骗，這跟實(shí)際使用是一樣的了，只不過(guò)我們要改源碼誉简。
gitlab新建倉(cāng)庫(kù)碉就；
將本地代碼上傳到gitlab
- 首先進(jìn)入剛才創(chuàng)建的倉(cāng)庫(kù)，即要上傳代碼的目錄
cd TestPodlib
- 執(zhí)行g(shù)it命令闷串，此命令會(huì)在當(dāng)前目錄下創(chuàng)建一個(gè).git文件夾
git init
- 將本地的倉(cāng)庫(kù)關(guān)聯(lián)到gitlab上
git remote add origin https://github.corp.XXXX.com/ios/TestPodlib.git
- 將項(xiàng)目的所有文件添加到倉(cāng)庫(kù)中
//這個(gè)命令會(huì)把當(dāng)前路徑下的所有文件瓮钥，添加到待上傳的文件列表中。如果想添加某個(gè)特定的文件烹吵，只需把.換成特定的文件名即可.
git add .
- 將add的文件commit到倉(cāng)庫(kù)
git commit -m "注釋語(yǔ)句"
- 上傳代碼到gitlab遠(yuǎn)程倉(cāng)庫(kù)
git push -u origin master
- 如果不小心將git遠(yuǎn)程地址配錯(cuò)了碉熄，再次配置提示錯(cuò)誤：fatal: 遠(yuǎn)程 origin 已經(jīng)存在。此時(shí)只需要將遠(yuǎn)程配置刪除肋拔，重新添加即可:
git remote rm origin
git remote add origin https://github.corp.XXXX.com/ios/TestPodlib.git
git push -u origin master
- 如果遠(yuǎn)程倉(cāng)庫(kù)已經(jīng)有提交或者改動(dòng)锈津，本地倉(cāng)庫(kù)沒(méi)有更新遠(yuǎn)程倉(cāng)庫(kù)的內(nèi)容，需要將遠(yuǎn)程代碼庫(kù)與本地代碼庫(kù)同步一下
git pull origin master
但是可能會(huì)出現(xiàn)“fatal：拒絕合并無(wú)關(guān)歷史凉蜂∏戆穑”的錯(cuò)誤 ，需要用
git pull origin master --allow-unrelated-histories
- 修改podspec文件的內(nèi)容
除了采用pod 自動(dòng)從 github 下載pod模版工程的方法窿吩，同樣也可以基于原有的項(xiàng)目工程文件建立pod庫(kù)茎杂。
操作方式：
在私有Pod代碼所在文件夾下執(zhí)行pod spec create your_podName，則就會(huì)在該目錄下創(chuàng)建一個(gè)your_podName.podspec說(shuō)明書(shū)文件纫雁，之后便可以編輯這個(gè)說(shuō)明書(shū)文件了煌往。
- 進(jìn)入podfile目錄，pod install檢測(cè)demo的有效性
pod庫(kù)的開(kāi)發(fā)過(guò)程中轧邪，向Pod文件夾中添加庫(kù)文件和資源刽脖，然后進(jìn)入podfile文件所在的目錄下執(zhí)行pod install命令，pod組件已經(jīng)在Pods子工程下Development Pods/目錄中了忌愚，然后編輯demo工程曲管，測(cè)試組件。新建的pod庫(kù)沒(méi)有在Pods目錄下是因?yàn)楸镜販y(cè)試的緣故菜循。
- 提交源代碼并打tag翘地，檢測(cè)podspec文件的有效性
pod spec lint TestPodlib.podspec --allow-warnings
git tag -m "first release" 0.0.1
git push --tags #推送tag到遠(yuǎn)端倉(cāng)庫(kù)
因?yàn)閜odspec文件中獲取Git版本控制的項(xiàng)目需要tag號(hào)申尤，所以我們要打上一個(gè)tag。
注意:這里tag必須跟podspec文件中的tag保持一致衙耕，因?yàn)镃ocoaPods是通過(guò)podspec文件中的tag去找源文件的昧穿，如果tag對(duì)應(yīng)不起來(lái)就會(huì)驗(yàn)證失敗。
-
驗(yàn)證podspec文件有效性
有兩種驗(yàn)證方式:
- 本地驗(yàn)證:pod lib lint your_podName.podspec
- 聯(lián)網(wǎng)驗(yàn)證:pod spec lint your_podName.podspec
pod lib lint //pod lib lint 如果有警告橙喘，會(huì)導(dǎo)致無(wú)法通過(guò)时鸵，需要添加--allow-warnings，允許警告 //如果使用了c函數(shù)或靜態(tài)庫(kù)厅瞎，需要添加--use-libraries //如果同時(shí)依賴了公有庫(kù)和私有庫(kù)饰潜，你必須指定源才行，因?yàn)槟J(rèn)只會(huì)去公有源中查找對(duì)應(yīng)的依賴和簸，需要添加庫(kù)的源--sources='https://xxxx'驗(yàn)證通過(guò)后彭雾，代表這個(gè)podspec文件是合格的。
向Spec Repo提交podspec（提交說(shuō)明書(shū)文件到私有說(shuō)明書(shū)庫(kù)）
pod repo push specRepo TestPodlib.podspec
#前面是本地Repo名字 后面是podspec名字
#同樣的加上上面驗(yàn)證時(shí)使用到的可選參數(shù)
- 私有組件庫(kù)制作完成后锁保，可以使用pod search命令驗(yàn)證一下薯酝。
