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

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

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


這個(gè)很重要 ,,很重要,, 很重要。。


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

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

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

將私有的這個(gè)podSpesc 關(guān)聯(lián)到本地,
// 我們先查詢當(dāng)前本地的pod 庫,一般會有一個(gè)master 這個(gè)是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里多了個(gè)QFPodSpec

QQ20180804-114719@2x.png

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

使用 pod 命令創(chuàng)建一個(gè)模板工程。
$ pod lib create 項(xiàng)目名稱
在創(chuàng)建的過程中會詢問你四個(gè)問題,
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)行,如果存在錯(cuò)誤,需要解決掉。
可以發(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)建一個(gè)私有庫倉庫。

QQ20180804-121737@2x.png

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


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

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)的警告,
如果有錯(cuò)誤,可以加上,
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
// 如果依賴了私有庫,在上傳時(shí),同樣需要添加上--sources= 路徑

!!!!! 這里一定要分清 QFPodSpec 是我們創(chuàng)建的私有的podspec 倉庫名稱, QFCommon.podspec 是我們組件的描述文件的podspec. 一定分清 ,分清,分清,, !!!!!!

如果上傳成功的話,在遠(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(shí)候,需要在對應(yīng)的podfile 添加上私有庫對應(yīng)的,podspec的路徑

image.png

在制作的過程中遇到的坑

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

image.png

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

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']
  }

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

Could not load NIB in bundle:

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

image.png

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

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

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

Remote branch 0.0.1 not found in upstream origin

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

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

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