創(chuàng)建一個(gè)私有的podspec包括如下那么幾個(gè)步驟:
- 創(chuàng)建并設(shè)置一個(gè)私有的Spec Repo。
- 創(chuàng)建Pod的所需要的項(xiàng)目工程文件,并且有可訪問的項(xiàng)目版本控制地址。
- 創(chuàng)建Pod所對應(yīng)的podspec文件。
- 本地測試配置好的podspec文件是否可用。
- 向私有的Spec Repo中提交podspec。
- 在個(gè)人項(xiàng)目中的Podfile中增加剛剛制作的好的Pod并使用。
- 更新維護(hù)podspec。
在這一系列的步驟中需要?jiǎng)?chuàng)建兩個(gè)Git倉庫,分別是第一步和第二步(第二步不一定非要是Git倉庫,只要是可以獲取到相關(guān)代碼文件就可以,也可以是SVN的,也可以說zip包,區(qū)別就是在podspec中的source項(xiàng)填寫的內(nèi)容不同),并且第一步只是在初次創(chuàng)建私有podspec時(shí)才需要,之后在創(chuàng)建其他的只需要從第二步開始就可以。本文只介紹在Git環(huán)境下的操作,其他環(huán)境其他方式暫不說明。
-
創(chuàng)建私有Spec Repo
先來說第一步,什么是Spec Repo?它是所有的Pods的一個(gè)索引,就是一個(gè)容器,所有公開的Pods都在這個(gè)里面,它實(shí)際是一個(gè)Git倉庫remote端在GitHub上,但是當(dāng)你使用了Cocoapods后它會被clone到本地的~/.cocoapods/repos目錄下,可以進(jìn)入到這個(gè)目錄看到master文件夾就是這個(gè)官方的Spec Repo了
├── Specs └── [SPEC_NAME] └── [VERSION] └── [SPEC_NAME].podspec
因此我們需要?jiǎng)?chuàng)建一個(gè)類似于master的私有Spec Repo ,因?yàn)镚itHub的私有倉庫是收費(fèi)的,我還不是GitHub的付費(fèi)用戶,所以我使用了其他Git服務(wù),我使用的是CODING
登陸進(jìn)入coding.net 建立私有私有項(xiàng)目WMSpecs作為我們的私有 repo 倉庫然后在命令行執(zhí)行以下代碼
$ pod repo add [Private Repo Name] [GitHub HTTPS clone URL] $ pod repo add WTSpecs https://coding.net/albertjson/WMSpecs.git
此時(shí)如果成功的話進(jìn)入到~/.cocoapods/repos目錄下就可以看到WTSpecs這個(gè)目錄了。至此第一步創(chuàng)建私有Spec Repo完成。
PS:如果有其他合作人員共同使用這個(gè)私有Spec Repo的話在他有對應(yīng)Git倉庫的權(quán)限的前提下執(zhí)行相同的命令添加這個(gè)Spec Repo即可。
-
創(chuàng)建項(xiàng)目工程文件
如果項(xiàng)目已經(jīng)基于svn或者git此步驟可以省略,此處我的做法是在coding.net網(wǎng)站上又建立了一個(gè)工程,然后用xcode自帶工具建立連接之后,checkout到本地然后把所需要的文件添加到本地文件夾,并commit,同時(shí)push到master。至此已完成該步驟
接下來就是向Pod文件夾中添加庫文件和資源,并配置podspec文件,不過在這之前需要給項(xiàng)目設(shè)置tag,以備后面podspec提交的時(shí)候用
$ git tag -m "first release" "0.1.0" $ git push --tags #推送tag到遠(yuǎn)端倉庫
-
創(chuàng)建podspec文件夾,此處做法跟本地或者公共庫podspec的制作基本上差不多
pod spec create QXBModelTool $ pod spec create QXBModelTool git@coding.net:albetjson/JSONModelTest.git //兩選一,后者是checkout項(xiàng)目到本地之前在git端直接創(chuàng)建
然后用編輯器打開進(jìn)行編輯,
Pod::Spec.new do |s| s.name = "QXBModelTool" s.version = "0.0.1" s.summary = "將json輸出為model的工具." s.homepage = 'https://coding.net/albertjson/JSONModelTest' s.license = 'MIT' s.author = { "Albert" => "1300539429@qq.com" } s.platform = :ios, "7.0" s.source = { :git => "https://coding.net/albertjson/JSONModelTest.git", :tag => "0.0.1" } s.source_files = 'JSONModelMyTest/QXBModelTool/*.{h,m}' end
編輯完podspec文件后,需要驗(yàn)證一下這個(gè)文件是否可用,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不過xcode的WARNING是可以存在的,驗(yàn)證需要執(zhí)行一下命令
$ pod spec lint
如果通過驗(yàn)證,會有提示,此處通過驗(yàn)證之后最好在做一次本地pod驗(yàn)證,就是集成到項(xiàng)目里面看看是否能成功,不過該步驟不是必需的
-
向Spec Repo提交podspec
向Spec Repo提交podspec需要完成兩點(diǎn)一個(gè)是podspec必須通過驗(yàn)證無誤,在一個(gè)就是刪掉無用的注釋(這個(gè)不是必須的,為了規(guī)范還是刪掉吧)。 向我們的私有Spec Repo提交podspec只需要一個(gè)命令
$ pod repo push WMSpecs QXBModelTool.podspec #前面是本地Repo名字 后面是podspec名字
完成之后這個(gè)組件庫就添加到我們的私有Spec Repo中了,可以進(jìn)入到~/.cocoapods/repos/WMSpecs目錄下查看
再去看我們的Spec Repo遠(yuǎn)端倉庫,也有了一次提交,這個(gè)podspec也已經(jīng)被Push上去了
至此,我們的這個(gè)組件庫就已經(jīng)制作添加完成了,使用pod search命令就可以查到我們自己的庫了
這里說的是添加到私有的Repo,如果要添加到Cocoapods的官方庫了,可以使用trunk工具,具體可以查看 官方文檔. -
使用制作好的Pod
在完成這一系列步驟之后,我們就可以在正式項(xiàng)目中使用這個(gè)私有的Pod了只需要在項(xiàng)目的Podfile里增加以下一行代碼即可
pod 'QXBModelTool'
然后執(zhí)行 pod install 成功后就可以看到效果了
ps:
-
需要在Podfile文件的最前面加入
source 'https://git.coding.net/albertjson/WMSpecs.git'
source 'https://coding.net/albertjson/WMSpecs.git'<好像兩個(gè)都行,選一個(gè)就可以了> -
如果你podspec文件已經(jīng)集成到項(xiàng)目里面,那么直接采用下面方式也可以集成自制pod
pod 'QXBModelTool', :podspec => 'https://coding.net/albertjson/JSONModelTest/QXBModelTool.podspec'
如果其他人使用該pod,需要輸入賬號和密碼,因?yàn)槭撬接袀}庫!
-
-
友情鏈接: