組件化之路(-)私有庫制作

項(xiàng)目更新到一定的階段录淡,工程越來越大,編譯時間越來越長庸论,我們一般會將項(xiàng)目抽取成一個個的組件职辅,組件一般都會使用cocoaPods 來制作成私有庫來相互引用,話不多說聂示,第一次的制作域携,真是一步一個坑,這里做個總結(jié):

制作私有庫鱼喉,一定要創(chuàng)建兩個倉庫 一個存放私有的PodSpesc ,另一個倉庫存放私有的組件代碼秀鞭。


這個很重要 ,扛禽,很重要锋边,, 很重要编曼。豆巨。


(一開始不知道,被坑了好久掐场。往扔。)默認(rèn)的podSpesc是放在官方倉庫的,我們是私有庫熊户,不想被別人使用萍膛,所以需要單獨(dú)創(chuàng)建一個podSpesc倉庫

1, 先創(chuàng)建podSpesc倉庫,因?yàn)槭撬接械娜卤ぃ覀円话氵x擇 coding, 碼云蝗罗,gitLab等git倉庫。因?yàn)樗接械拿赓M(fèi)麦到。绿饵。 我們公司選擇的是gitLab ,所以這里以GitLab 做示例;

B2120B72-F09E-49BD-83B2-1E5A34060A5E.png

將私有的這個podSpesc 關(guān)聯(lián)到本地瓶颠,
// 我們先查詢當(dāng)前本地的pod 庫,一般會有一個master 這個是cocoaPods官方的repo
$ pod repo

將我們創(chuàng)建的倉庫添加到本地?zé)醨epo里刺桃,
$ pod repo add QFPodSpec http://xxxxx.com/xxxt/QFPodSpec.git

3E86F43E-33C9-446F-A3AC-B726DA0BFA54.png

$ pod repo
可以發(fā)現(xiàn)我們本地的repo里多了個QFPodSpec

QQ20180804-114719@2x.png

至此粹淋,我們第一步,創(chuàng)建私有的spec倉庫算是完成瑟慈,現(xiàn)在開始創(chuàng)建私有的組件工程桃移。

使用 pod 命令創(chuàng)建一個模板工程。
$ pod lib create 項(xiàng)目名稱
在創(chuàng)建的過程中會詢問你四個問題葛碧,
What platform do you want to use?? [ iOS / macOS ]
iOS
What language do you want to use?? [ Swift / ObjC ]
ObjC
Would you like to include a demo application with your library? [ Yes / No ]
Which testing frameworks will you use? [ Specta / Kiwi / None ]
What is your class prefix?
看自己需求回答借杰。
克隆完成之后,會自動打開工程进泼。

工程結(jié)構(gòu)如下:


QQ20180804-115937@2x.png

我們的項(xiàng)目文件需要放在蔗衡,Classes 文件夾下纤虽;
這里我添加了一些項(xiàng)目中常用的小工具

QQ20180804-120226@2x.png

進(jìn)入到 Example 文件夾路徑下, 執(zhí)行
$ pod update

執(zhí)行完畢后打開 Example 工程绞惦。編譯運(yùn)行逼纸,如果存在錯誤,需要解決掉济蝉。
可以發(fā)現(xiàn)我們添加的文件被放在了Development Pods 文件下

QQ20180804-120759@2x.png

確認(rèn)編譯通過后杰刽,開始修改工程的,.podspec文件
podspec是我們私有庫的描述文件王滤,

QQ20180804-121149@2x.png

注意:s.verison 必須要跟我們私有庫的tag 保持一致贺嫂。
s.description 必須要修改
s.source 修改成私有庫的地址。


由于podspec需要填寫私有庫的地址雁乡,這里我們創(chuàng)建一個私有庫倉庫第喳。

QQ20180804-121737@2x.png

將倉庫地址替換掉s.source 路徑,pod 是根據(jù)這個地址來索引我們的私有庫的蔗怠。


所有的修改完畢之后墩弯,我們將修改提交到代碼倉庫。

cd 到當(dāng)前項(xiàng)目路徑
// 查看當(dāng)前文件狀態(tài)
git status
// 提交修改文件
git add .
git commit -m '修改說明'
// 查看當(dāng)前遠(yuǎn)程倉庫
git remote // 當(dāng)前我們還沒有添加寞射,所有是空的渔工,
// 添加遠(yuǎn)程倉庫
git remote add origin 倉庫地址,//(我們剛創(chuàng)建的QFCommon的倉庫地址)
// 推送到遠(yuǎn)程倉庫
git push origin master
// 給我們的修改打上tag (再說一遍這里的tag 一定要和podspec 里的s.version 保持一致)
git tag -a 0.0.1 -m '0.0.1'
// 推送tag
git push --tags

至此桥温,我們的遠(yuǎn)程倉庫里已經(jīng)有了工程并且也已經(jīng)打上了tag引矩。


image.png

下一步 我們就需要將podSpec 上傳到我們的私有倉庫里。

我們先在本地驗(yàn)證當(dāng)前的podspec 是否合法
$ pod lib lint QFCommon.podspec --allow-warnings
// --allow-warnings 忽略掉相應(yīng)的警告侵浸,
如果有錯誤旺韭,可以加上,
pod lib lint QFCommon.podspec --allow-warnings --verbose
// --verbose 查看詳細(xì)分析信息掏觉。(這里踩坑無數(shù)区端,待會再說)
// 如果當(dāng)前的私有庫依賴了其他的私有庫,需要添加私有庫的spec的地址澳腹,
pod lib lint QFCommon.podspec --sources=http://xxxx/xxx/myPodSpec.git,https://github.com/CocoaPods/Specs.git --allow-warnings --use-libraries
// 當(dāng)私有庫里引用了第三方的靜態(tài)庫织盼,需要添加 --use-libraries
當(dāng)看到 QFCommon passed validation. 表示驗(yàn)證通過。

驗(yàn)證通過后酱塔,我們開始上傳到我們的遠(yuǎn)程倉庫(驗(yàn)證通過沥邻,不代表上傳就一定能過,這里也有坑羊娃。唐全。)
// 上傳我們的podspec 到私有的倉庫
$ pod repo push QFPodSpec QFCommon.podspec --allow-warnings
// 如果依賴了私有庫,在上傳時蕊玷,同樣需要添加上--sources= 路徑

S世C直ⅰ!=堋缅糟! 這里一定要分清 QFPodSpec 是我們創(chuàng)建的私有的podspec 倉庫名稱, QFCommon.podspec 是我們組件的描述文件的podspec. 一定分清 祷愉,分清窗宦,分清,二鳄, 8昂!6┧稀K璐堋!!

如果上傳成功的話,在遠(yuǎn)程倉庫里就可以看到我們組件對應(yīng)的podspec了碗降。


image.png

在本地的repo里也能發(fā)現(xiàn)我們的spec


image.png

現(xiàn)在執(zhí)行
pod search QFCommon //應(yīng)該就可以搜索到我們的組件了,
如果搜索不到程拭,可以刪除索引,試試棍潘。
m ~/Library/Caches/CocoaPods/search_index.json


走到這里我們算是把私有庫制作完成了恃鞋,因?yàn)槭撬接袔欤谑褂玫臅r候亦歉,需要在對應(yīng)的podfile 添加上私有庫對應(yīng)的恤浪,podspec的路徑

image.png

在制作的過程中遇到的坑

1,
如果你的podspec文件里包含中文字符肴楷,那么在pod lib lint 驗(yàn)證的時候有可能會報utf8編碼錯誤水由,所以盡量不要在podspec里包含中文。
2赛蔫,在設(shè)置子組件時绷杜,如果依賴于其他庫,需要設(shè)置濒募;

image.png

其中如果A文件夾下依賴于另一個B文件夾的內(nèi)容也需要設(shè)置相應(yīng)的 依賴路徑,不然在pod repo push的時候圾结,有可能會報

xxxx.h' file not found

3, 如果私有庫里包含Xib文件 那么在加載xib是需要根據(jù)bundle加載瑰剃。

  
    NSString *className = NSStringFromClass([self class]);
    NSBundle *bundle = [NSBundle bundleForClass:self];
    NSString *bundleName = bundle.infoDictionary[@"CFBundleName"];
    NSString *nibName = [NSString stringWithFormat:@"%@.bundle/%@", bundleName, className];
    return [bundle loadNibNamed:nibName owner:nil options:nil].lastObject;

并且 需要在podspec 里描述相應(yīng)的路徑。

  s.resource_bundles = {
    'QFCommon' => ['QFCommon/Classes/Tools/**/*.xib']
  }

另外在使用私有庫的時候筝野,因?yàn)榘速Y源文件晌姚,那么就需要將podfile 里面的 use_frameworks! 打開粤剧,不然會找不到資源。

Could not load NIB in bundle:

如果包含圖片挥唠,需要將圖片放在抵恋,私有庫對應(yīng)的Assets里面。

image.png

并且將路徑描述在宝磨, s.resource_bundles 的數(shù)組里 (多個路徑弧关,可以相應(yīng)的依次添加)

 s.resource_bundles = {
    'QFCommon' => ['QFCommon/Classes/Tools/**/*.xib', xxx/xxx/xxx]
  }

5, 如果確定已經(jīng)打上tag,并且在遠(yuǎn)程倉庫上也能找到tag唤锉,但是在推送podspec到遠(yuǎn)程的時候報:

Remote branch 0.0.1 not found in upstream origin

查看podspecs.source 的地址是否和遠(yuǎn)程倉庫的地址一致世囊。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市窿祥,隨后出現(xiàn)的幾起案子株憾,更是在濱河造成了極大的恐慌,老刑警劉巖晒衩,帶你破解...
    沈念sama閱讀 222,183評論 6 516
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件嗤瞎,死亡現(xiàn)場離奇詭異,居然都是意外死亡听系,警方通過查閱死者的電腦和手機(jī)贝奇,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,850評論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來跛锌,“玉大人弃秆,你說我怎么就攤上這事∷杳保” “怎么了菠赚?”我有些...
    開封第一講書人閱讀 168,766評論 0 361
  • 文/不壞的土叔 我叫張陵,是天一觀的道長郑藏。 經(jīng)常有香客問我衡查,道長,這世上最難降的妖魔是什么必盖? 我笑而不...
    開封第一講書人閱讀 59,854評論 1 299
  • 正文 為了忘掉前任拌牲,我火速辦了婚禮,結(jié)果婚禮上歌粥,老公的妹妹穿的比我還像新娘塌忽。我一直安慰自己,他們只是感情好失驶,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,871評論 6 398
  • 文/花漫 我一把揭開白布土居。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪擦耀。 梳的紋絲不亂的頭發(fā)上棉圈,一...
    開封第一講書人閱讀 52,457評論 1 311
  • 那天,我揣著相機(jī)與錄音眷蜓,去河邊找鬼分瘾。 笑死,一個胖子當(dāng)著我的面吹牛吁系,可吹牛的內(nèi)容都是我干的德召。 我是一名探鬼主播,決...
    沈念sama閱讀 40,999評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼垮抗,長吁一口氣:“原來是場噩夢啊……” “哼氏捞!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起冒版,我...
    開封第一講書人閱讀 39,914評論 0 277
  • 序言:老撾萬榮一對情侶失蹤液茎,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后辞嗡,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體捆等,經(jīng)...
    沈念sama閱讀 46,465評論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,543評論 3 342
  • 正文 我和宋清朗相戀三年续室,在試婚紗的時候發(fā)現(xiàn)自己被綠了栋烤。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,675評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡挺狰,死狀恐怖明郭,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情丰泊,我是刑警寧澤薯定,帶...
    沈念sama閱讀 36,354評論 5 351
  • 正文 年R本政府宣布,位于F島的核電站瞳购,受9級特大地震影響话侄,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜学赛,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,029評論 3 335
  • 文/蒙蒙 一年堆、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧盏浇,春花似錦变丧、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,514評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽译蒂。三九已至,卻和暖如春谊却,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背哑芹。 一陣腳步聲響...
    開封第一講書人閱讀 33,616評論 1 274
  • 我被黑心中介騙來泰國打工炎辨, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人聪姿。 一個月前我還...
    沈念sama閱讀 49,091評論 3 378
  • 正文 我出身青樓碴萧,卻偏偏與公主長得像,于是被迫代替她去往敵國和親末购。 傳聞我的和親對象是個殘疾皇子破喻,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,685評論 2 360

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