一、概述
CocoaPods是iOS,Mac下優(yōu)秀的第三方包管理工具,類似于java的maven,給我們項(xiàng)目管理帶來了極大的方便。個(gè)人或公司在開發(fā)過程中,會(huì)積累很多可以復(fù)用的代碼包,有些我們不想開源,又想像開源庫一樣在CocoaPods中管理它們,那么通過私有倉庫來管理就很必要。對(duì)于CocoaPods還不太熟悉的,建議參考一下唐巧的博客或者直接到CocoaPods的官網(wǎng)看看:https://cocoapods.org/
二、概念
大家很容易把spec repository 和 code repository弄混,我一開始就在這里掛起了好久。
1.code repository是代碼倉庫,我們把包代碼上傳到這個(gè)倉庫。
2.spec repository是配置倉庫,所有的配置按照包名、版本號(hào)分門別類的存放在這個(gè)倉庫。這個(gè)倉庫只用來存放spec文件,不存放代碼。
小結(jié):以AFNetWorking為例,如果只創(chuàng)建AFNetWorking的code repository,而不將code repository中的.Podspec文件上傳到spec repository的話,你在自己的工程引入AFN的時(shí)候壓根用不了。
三、步驟
創(chuàng)建私有的CocoaPods倉庫之前需要先制作CocoaPods依賴庫,所以步驟分兩步:
1.制作CocoaPods依賴庫,也就是代碼庫。
2.創(chuàng)建私有 CocoaPods 倉庫。
小結(jié):1.制作依賴庫也就是在自己的服務(wù)器或者github等遠(yuǎn)端第三方服務(wù)器創(chuàng)建一個(gè)倉庫,用來保存.podspec、LICENSE、README.md以及代碼文件和一些資源文件。
? ? ? ? ? 2.創(chuàng)建私有 CocoaPods 倉庫也就是在自己的服務(wù)器或者github等遠(yuǎn)端第三方服務(wù)器創(chuàng)建一個(gè)倉庫,用來接受并存放.podspec文件,來管理自己的私庫。
四、制作 CocoaPods 依賴庫
當(dāng)我們使用了類似于AFNetWorking這樣的Pods 依賴庫以后, 你一定對(duì)創(chuàng)建自己的依賴庫很有興趣吧,現(xiàn)在我們就來嘗試一下,以一個(gè)簡(jiǎn)單 caculatorMaker 為例自己創(chuàng)建一個(gè) Pods 依賴庫。
1.創(chuàng)建并設(shè)置一個(gè)私有的code Repository。
? ? ? ?因?yàn)镚itHub的私有倉庫是收費(fèi)的,我還不是GitHub的付費(fèi)用戶,所以我使用了其他Git服務(wù),我使用的是gitlab(我們公司是基于內(nèi)網(wǎng)的,當(dāng)然你也可以基于外網(wǎng)),當(dāng)然還有其他的可供選擇開源中國、CODING、Bitbucket以及CSDN Code.
2.clone 倉庫到本地
? ? ? ?為了方便向倉庫中刪減內(nèi)容,需要將倉庫 clone 到本地,這里有多種操作方式,可以選擇你喜歡的一種,但是為了方便這邊選擇使用命令行。首先需要切換到你想在本地存儲(chǔ)的目錄,然后再 clone ,假設(shè)你放在用戶的根目錄上:
cd ~
git clone http://njGitrepo/xxx/caculatemaker.git
完成后,我們進(jìn)入到 ~/caculatemaker 目錄,這時(shí)候你看到是一個(gè)空文件夾,這由于我用的是gitlab創(chuàng)建的,沒有像github網(wǎng)頁那樣在創(chuàng)建code Repository的時(shí)候可以勾選創(chuàng)建LICENSE和README.md文件。其實(shí)也不是什么都沒有,實(shí)際上是有一個(gè)隱藏的 .git 文件,后續(xù)我們的所有文件都在這個(gè)目錄下進(jìn)行。
注意:打開隱藏目錄,可以使用命令,接著需要重啟一下 Finder, 可以按住 option + 右鍵 Finder 圖標(biāo)選擇重啟。
//打開隱藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool true
//關(guān)閉隱藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool false
3.向本地倉庫中添加創(chuàng)建 Pods 依賴庫所需的文件
這個(gè)代碼庫需要手動(dòng)在外面創(chuàng)建好.podspec、LICENSE、README.md以及代碼文件和一些資源文件并拖動(dòng)到,當(dāng)然你在其他的git服務(wù)上需要?jiǎng)?chuàng)建的基本都是這幾種文件。
?1).每個(gè) Pods 依賴庫必須有且僅有一個(gè)名稱和依賴庫名保持一致,后綴名為 .podspec 的描述文件。這里我們依賴庫的描述文件名稱應(yīng)該為 caculatormaker.podspec。
?2).創(chuàng)建這個(gè).podspec 的描述文件有兩種途徑:
? ? ? ? ? ? ? ? ? a.復(fù)制已有的 podspec 文件然后修改對(duì)應(yīng)的參數(shù)。
? ? ? ? ? ? ? ? ? b.執(zhí)行命令行創(chuàng)建。
?我們使用命令行:
pod spec create caculatormaker
我們發(fā)現(xiàn)這個(gè)是ruby文件,里面有很多東西是我們不需要的,我們可以用文本編輯器打開并刪除我們不需要的內(nèi)容。
Pod::Spec.new do |s|??
s.name? ? ? ? ? ? = 'caculatemaker' ?
s.version? ? ? ? ? = '0.1.0'??
s.summary? ? ? ? ? = 'just test'? s.description? ? ? = <<-DESC? ? ? ? ? ? ? ? ? ? ?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?Testing Private Podspec.? ? ? ? ? ? ? ? ? ? ? ??
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? DESC?
?s.homepage? ? ? ? = 'http://njgitrepo/wushuanghong/caculatemaker'??
# s.screenshots? ? = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'?
?s.license? ? ? ? ? = { :type => 'MIT', :file => 'LICENSE' }??
s.author? ? ? ? ? = { 'shuanghong.wu' => 'shuanghong.wu@qq.com' }?
?s.source? ? ? ? ? = { :git => 'http://njGitrepo/wushuanghong/caculatemaker.git' ,:tag => s.version} ?
s.ios.deployment_target = '8.0'
s.source_files? = "Classes", "Classes/**/*.{h,m}", "caculator/**/*.{h,m}"
end
? ? ? ? ? 3).README.md
? ? ? ? ? ?使用 github 的人應(yīng)該都熟悉這個(gè)文件,它使一個(gè)成功的 github 倉庫必不可少的一部分,使用 markdown 對(duì)倉庫進(jìn)行詳細(xì)說明。
? ? ? ? ? 4).LICENSE 文件
? ? ? ? ? CocoaPods 強(qiáng)制要求所有的 Pods 依賴庫都必須有 license 文件,否則驗(yàn)證不會(huì)通過。 license 文件有很多中,詳情可以參考 tldrlegal。前面我們已經(jīng)選擇創(chuàng)建了一個(gè) MIT 類型的 license。
4.提交修改到code Repository
經(jīng)過前面步驟,我們已將在本地的 git 倉庫添加了不少文件,現(xiàn)在我們只要將他們提交到 gitlab上就可以。在此之前我們需要對(duì)剛才添加的 pod 進(jìn)行一下驗(yàn)證:
pod lib lint
如果你剛才沒有給caculatormaker.podspec的s.source指定tag,就有可能有warn警告,執(zhí)行下面的命令:
pod lib lint --allow-warnings
驗(yàn)證成功之后,我們只要把代碼提交到 gitlab 倉庫,就可以了,參考命令:
git add -A && git commit -m "add pod files"
git push origin master
如果以上的操作都沒有問題的話,gitlab上應(yīng)該可以看到類似下面的內(nèi)容:
到現(xiàn)在為止,我們的 CocoaPods 依賴庫就已經(jīng)準(zhǔn)備好了,但是現(xiàn)在你還不能在你的工程中使用它。如果你想成為一個(gè)真正可用的依賴庫,還需要最后一步操作:將剛才生產(chǎn)的 podspec 文件提交到 自己創(chuàng)建的私有Spec Repository上,那么繼續(xù)下面的第五步。
五、創(chuàng)建私有 CocoaPods 倉庫
1.創(chuàng)建并設(shè)置一個(gè)私有的Spec Repository。
跟第四步中的創(chuàng)建code Repository一樣,我們創(chuàng)建Spec Repository也是基于gitlab的,當(dāng)讓你也可以用其他上面我提到的方式。
如圖所示,我們?cè)?b>gitlab上創(chuàng)建一個(gè)空的倉庫,命名為wshSpecs,這個(gè)倉庫是用來存放我們自己所有的私有庫的spec文件,就如同官方的https://github.com/CocoaPods/Specs是用來存放所有官方的specs文件一樣。
終端執(zhí)行命令:
pod repo add wshSpecs http://njGitrepo/wushuanghong/wshSpecs.git
注意:上面的命令的解釋如下:
pod repo add REPO_NAME SOURCE_URL
其中的 REPO_NAME 是我們要添加的私有repo的名稱(這里我們待會(huì)填的是:wshSpecs),后面是倉庫的 gitlab 地址。這里做的其實(shí)是創(chuàng)建的工作,也就是在~/.cocoapods/repo目錄下添加了一個(gè)以你的私有repo為名的文件夾,但是并沒有添加spec文件。
這里用的是https地址,當(dāng)然你也可以用git地址,不過這樣有可能失敗。如果失敗,很大因素是你github的ssh在本地沒有配置好,配置方法可以看這里:Generating SSH keys,成功后可以看得到.cocoapods目錄如下圖所示:
至此,我們已經(jīng)在本地得到我們自己的私有倉庫 wshSpecs ,這是一個(gè)空的倉庫。
注意:這里我需要介紹一下上面的master文件夾里面到底是什么東西:
? ? ? ? ? ? a. 進(jìn)入到這個(gè)目錄
? ? ? ? ? ? ? ? 在Finger前往文件夾中輸入 ?~/.cocoapods, 顯示的內(nèi)容就是上圖的界面。
? ? ? ? ? ? b.點(diǎn)開master文件夾下面的spec目錄,其下存放的就是所有提交到 CocoaPods 的開源庫的 podspec 文件的集合。
其結(jié)構(gòu)如下圖所示:
其組成方式:
specName -- version -- specName.podspec
( master 里現(xiàn)在是 specName.podspec.json,這個(gè) .json 文件就是 podspec 文件加了個(gè)后綴。我們可以采用 pod ipc spec 這個(gè)命令來將 spec 文件轉(zhuǎn)換成 .json)
那這個(gè)文件夾是如何來得呢?其實(shí),這個(gè)文件夾是在你安裝了 CocoaPods 后,第一次執(zhí)行 pod install 時(shí), CocoaPods 通過命令 pod setup 來建立的(這條命令會(huì)自動(dòng)執(zhí)行)。
2.添加 剛才第四步創(chuàng)建的 caculatormaker.podspec 到你的 Spec Repository。
在前面驗(yàn)證通過的基礎(chǔ)上,我們接著執(zhí)行命令:
pod repo push wshSpecs caculatormaker.podspec
按照平時(shí)使用 CocoaPods 的習(xí)慣,我們添加依賴庫之前會(huì)先搜索一下庫,讓我們執(zhí)行一下命令:
pod search caculatormaker
3.在個(gè)人項(xiàng)目中的Podfile中增加剛剛制作的好的Pod并使用。
讓我們建立一個(gè)普通的工程,命名為 TestPodDemo,然后在終端 cd 到其目錄路徑下,添加一個(gè) Podfile 文件:
pod init
建立后修改 Podfile 文件內(nèi)容如下:
source 'https://github.com/CocoaPods/Specs. git'? ? ? ? #官方倉庫地址
source ‘http://njGitrepo/wushuanghong/wshSpecs.git’? ? ? ? #私有倉庫地址
use_frameworks!
target 'TestPodDemo' do
pod ‘caculatemaker’
end
執(zhí)行:
pod install
這樣一來我們就可以使用這個(gè)私有庫了!
4.更新維護(hù)podspec。
當(dāng)我們的代碼變動(dòng)時(shí),首先需要更新code Repository中的.podspec 文件的版本,然后push到 Spec Repository。