關(guān)于創(chuàng)建私有Cocoapods倉庫和組件化項(xiàng)目的資料網(wǎng)上已經(jīng)很多了戈轿,這里我們就不再講解。這里主要是對根據(jù)各方面資料的操作的大體流程進(jìn)行記錄以及重點(diǎn)標(biāo)記一些需要注意的細(xì)節(jié)店雅。
開始正文政基,這里我們將組件化項(xiàng)目分為兩步:
- 1.生成對應(yīng)的.podspec配置文件;
- 2.將.podspec配置文件push到Cocoapods私有倉庫中闹啦;
1.創(chuàng)建pods工程 配置.podspec文件
cocoapods官方建議我們使用pods工程項(xiàng)目創(chuàng)建.podspec配置文件沮明,因?yàn)檫@樣可以讓我們在Demo中檢測.podspec文件和涉及到的class(依賴庫代碼文件)的代碼功能是否正常。
- 創(chuàng)建名字為MyLibary的pods工程項(xiàng)目
pod lib create MyLibary
中間會(huì)要求做一些命令選擇窍奋,如:是否創(chuàng)建Demo工程等荐健,具體見官方手冊這里我們沒有選擇Demo工程圣勒,生成的pods工程目錄如下:
這里每次在Class中引入或更新了代碼后,如果引入了Demo工程摧扇,要在Demo工程中使用的話,需要先cd到Demo工程中挚歧,進(jìn)行pod update 或 pod install操作扛稽。
對應(yīng)的文件夾目錄如下:
- 修改.podspec配置文件
使用了上一步創(chuàng)建pods工程,.podspec文件就自動(dòng)生成了滑负,這一點(diǎn)跟網(wǎng)上大多數(shù)直接創(chuàng)建.podspec文件略有不同在张,請注意。
首先我們打開.podspec文件:
.podspec文件使用的Ruby語言,具體的參數(shù)含義請查看官方手冊,這大部分參數(shù)已經(jīng)自動(dòng)配置好了矮慕,但是仍然需要特別小心帮匾。紅色標(biāo)注的部分代表了重點(diǎn)注意,其中s.homepage和s.source代碼了cocoapods獲取依賴庫代碼文件的路徑痴鳄,必填瘟斜。
將下方創(chuàng)建的代碼托管倉庫的gitHub地址填入s.homepage 和 s.source,如圖所示:
在自己公司的git上創(chuàng)建一個(gè)依賴庫代碼文件托管的倉庫,.podspec會(huì)根據(jù)s.source找到這個(gè)倉庫痪寻,來拉去依賴庫螺句。為了方便,這里我們選擇在gitHub上建倉庫講解橡类。但是你不能這么做蛇尚,除非你想公開公司的代碼文件。
- 創(chuàng)建名字為Components的代碼托管倉庫顾画;
- 拉取倉庫到本地取劫;
# git clone [倉庫地址]
- 制作完成后將需要托管的代碼文件拷貝到到git托管倉庫中
- ?推送托管庫:
cd到git托管庫中- 打版本號(hào)
# set the new version to 0.1.0
# set the new tag to 0.1.0
- 驗(yàn)證.podspec配置文件是否正確:必須驗(yàn)證通過
# pod lib lint
以上兩步也可在pods項(xiàng)目中進(jìn)行。 - 本地托管git庫上傳到gitHub倉庫
# git add -A && git commit -m "Release 0.1.0"
# git tag '0.1.0'
# git push --tags
# git push origin master
- 驗(yàn)證是否可以根據(jù)配置文件正確拉去依賴庫
# pod spec lint
驗(yàn)證都通過研侣,即表示我們的依賴庫已經(jīng)制作完成谱邪,接下來只要把配置文件放到我們自制的spec庫中即可。
- 打版本號(hào)
2.將.podspec文件push到私有spec庫中
接下來我們需要在自己服務(wù)器上建立類似Cocoapos官方的私有spec庫庶诡,然后給小組成員分配管理權(quán)限虾标。私有庫的建立這里不再講述,我建立的私有庫名字叫做souFunsepec:
- 根據(jù)souFunsepec倉庫初始化本地spec依賴庫
# pod repo add [Private Repo Name] [git HTTPS clone URL]
# pod repo add souFunsepec http://192.168.73.186:3500/userName/souFunSepec.git
- 向spec倉庫中添加.podspec配置文件
cd到.podspec文件所在目錄
# pod repo push [Private Repo Name] [Private podspec Path]
# pod repo push souFunsepec ./MyLibary.podspec
推送成功我們可以到souFunsepec目錄下查看
# cd ~/.cocoapods
這里我們使用pod search命令是搜索不到私有庫的灌砖,因?yàn)閜od search是在cocopods官方的本地specs庫下進(jìn)行搜索璧函。可以使用下面的方法在podfile中直接使用基显。
私有倉庫的使用
Podfile 文件中默認(rèn)情況下已經(jīng)隱式使用** source**聲明了 CocoaPods 的官方倉庫蘸吓。但使用私有組件,需要使用 source關(guān)鍵字鮮顯式聲明組件所在倉庫:
如下圖:
其中撩幽,SBJson 組件是官方倉庫的库继,F(xiàn)GMarqueeView 組件屬于我們剛創(chuàng)建的私有倉庫箩艺。
需要注意的是:
官方倉庫的顯式聲明
盡管官方倉庫會(huì)被隱式聲明,如果同時(shí)使用了官方倉庫和私有倉庫宪萄,就需要同時(shí)聲明二者艺谆。倉庫聲明順序性
先聲明的倉庫具有優(yōu)先權(quán)。當(dāng)先后引用的兩個(gè)倉庫中都包含同一個(gè)組件時(shí)拜英,會(huì)使用先引 用倉庫中的静汤,哪怕后引用的倉庫中版本號(hào)更高。
當(dāng)然我們也可以省略掉第2步居凶,如果不想創(chuàng)建私有倉庫虫给,也可以在 Podfile 里直接引用私有組件(組件可以是本地的,也可以是托管在自家公司服務(wù)器或網(wǎng)上的代碼托管平臺(tái)上的)侠碧,引用的同時(shí)還可以制定具體的 commit抹估、branch 或者 tag,比如:
# pod 'FGMarqueeView', :git => 'https://git.coding.net/foogry/FGMarqueeView.git', :commit => 'b4dc0ffee'
文中引用了Cocoapods官方的一些介紹以及王中周的cocopods更新篇中的一些步驟弄兜,開始使用中被坑了無限次药蜻,本文是在實(shí)際操作中結(jié)合以上參考文章中較容易迷糊的地方給出了操作步驟,有不全的地方替饿,可以移步參考文章谷暮。