創(chuàng)建私有 CocoaPods 倉庫

一、概述


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地址,不過這樣有可能失敗。如果失敗,很大因素是你githubssh在本地沒有配置好,配置方法可以看這里: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。

六、參考資料


Private Pods

Creating a Private CocoaPod

Developing Private In-House Libraries with CocoaPods

http://www.lxweimin.com/p/ddc2490bff9f

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,698評(píng)論 6 539
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,202評(píng)論 3 426
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,742評(píng)論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我,道長(zhǎng),這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,580評(píng)論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,297評(píng)論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,688評(píng)論 1 327
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,693評(píng)論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,875評(píng)論 0 289
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,438評(píng)論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,183評(píng)論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,384評(píng)論 1 372
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,931評(píng)論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,612評(píng)論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,022評(píng)論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,297評(píng)論 1 292
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 52,093評(píng)論 3 397
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,330評(píng)論 2 377

推薦閱讀更多精彩內(nèi)容