組件化系列傳送門
iOS組件化(一)----- 創(chuàng)建私有組件庫(在碼云上操作)
iOS組件化(二)----- 組件的更新
iOS組件化(三)----- 加載圖片等資源文件
一、遠(yuǎn)程私有索引庫創(chuàng)建(Spec)
A、創(chuàng)建遠(yuǎn)程私有索引庫MyTestSpec(和創(chuàng)建遠(yuǎn)程工程一樣),復(fù)制倉庫地址(點(diǎn)擊克隆/下載)
B、打開終端,將遠(yuǎn)程私有庫關(guān)聯(lián)到本地
cd /Users/hf/.cocoapods/repos
pod repo add MyTestSpec https://gitee.com/CuteHf/MyTestSpec.git
https://gitee.com/CuteHf/MyTestSpec.git為上面點(diǎn)擊克隆/下載復(fù)制的鏈接
這個(gè)時(shí)候/Users/hf/.cocoapods/repos目錄下面多了個(gè)MyTestSpec目錄
二、私有代碼倉庫
A、創(chuàng)建文件夾MyTest
B、本地私有代碼庫
# cd到指定的目錄,這個(gè)MyTest是自己創(chuàng)建的一個(gè)文件目錄
cd /Users/hf/MyTest
# 這里的HFMyTest代表想要封裝的組件名稱, 這個(gè)根據(jù)自己的需求而定
pod lib create HFMyTest
可能之后出現(xiàn)登錄碼云的需求,按照要求登錄碼云賬號即可:
Cloning `https://github.com/CocoaPods/pod-template.git` >into `HFMyTestNew`. Configuring HFMyTestNew template. ! Before you can create a new library we need to setup >your git credentials. security: SecKeychainSearchCopyNext: The specified item >could not be found in the keychain. What is your name? > What is your email? >
1. 在輸入之后會有一些對組件工程的設(shè)置,具體如下:
What platform do you want to use?? [ iOS / macOS ]
>iOS
//開發(fā)語言設(shè)置,根據(jù)自己而定,這里為ObjC
What language do you want to use?? [ Swift / ObjC ]
>ObjC
//是否需要?jiǎng)?chuàng)建一個(gè)demo用來測試你的組件,這里選擇Yes,是為了之后對寫好的組件進(jìn)行測試
Would you like to include a demo application with your library? [ Yes / No ]
>Yes
//測試框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
>None
//是否要做基礎(chǔ)的視圖測試
Would you like to do view based testing? [ Yes / No ]
>No
//文件前綴
What is your class prefix?
>FF
2. 創(chuàng)建完成過后,我們的工程會自動打開,創(chuàng)建完成后,工程的目錄如下

可以發(fā)現(xiàn)在
Pods文件下面現(xiàn)在有一個(gè)HFMyTest的文件夾,就是我們上面pod lib create HFMyTest時(shí)候創(chuàng)建的文件夾名
3. 添加功能的代碼copy到Classes 目錄中新建的MyView目錄下,如下圖所示
4. 前往碼云https://gitee.com創(chuàng)建項(xiàng)目HFMyTest
5. 創(chuàng)建成功后配置HFMyTest項(xiàng)目的.podspec文件,文件位置
6. 在配置.podspec文件時(shí),需要修改的地方有如下幾處:
7. 經(jīng)過前6步,接下來將這個(gè)組件提交到碼云上
C、遠(yuǎn)程私有代碼倉庫
1. 把本地的代碼提交到遠(yuǎn)程倉庫(注意要cd到工程目錄下)
cd /Users/hf/MyTest/HFMyTest
git remote add origin https://gitee.com/CuteHf/HFMyTest.git #添加遠(yuǎn)程倉庫
git push -u origin master #第一次可能會報(bào)錯(cuò)可嘗試用 git push -u origin master -f 可能會覆蓋遠(yuǎn)程的修改
git add . #記得后面一定要有 .
git commit -m "創(chuàng)建我的組件"
git push -u origin master
git tag '0.1.0' #注意:這里的tag號必須和.podSpec文件的版本號一致
git push --tags
- 上面
git remote add origin https://gitee.com/CuteHf/HFMyTest.git可能出現(xiàn)問題:fatal: not a git repository (or any of the parent directories): >.git表示在當(dāng)前指向的文件夾里找不到庫(.git文件夾)
解決辦法是對目錄進(jìn)行初始化git init
git push -u origin master可能會出現(xiàn)error: src refspec master does not match any. error: failed to push some refs to >'https://gitee.com/CuteHf/HFMyTestNew.git'出現(xiàn)錯(cuò)誤的主要原因是碼云中的
README.md文件不在本地代碼目錄中,可以通過如下命令進(jìn)行代碼合并[注:pull=fetch+merge]git pull --rebase origin master
經(jīng)過上面一步會發(fā)現(xiàn)本地的代碼已經(jīng)提交到碼云的HFMyTest上面去了
D、對文件進(jìn)行本地驗(yàn)證和遠(yuǎn)程驗(yàn)證(在工程目錄下)
1. 從本地驗(yàn)證你的pod能否通過驗(yàn)證
pod lib lint --use-libraries --allow-warnings
--verbose:有些非語法錯(cuò)誤是不會給出錯(cuò)誤原因的,這個(gè)時(shí)候可以使用--verbose來查看詳細(xì)的驗(yàn)證過程來幫助定位錯(cuò)誤。
--use-libraries:表示使用靜態(tài)庫或者是framework,這里主要是解決當(dāng)我們依賴一些framework庫后校驗(yàn)提示找不到庫的時(shí)候用到。
--allow-warnings:表示允許警告。
2. 從本地和遠(yuǎn)程驗(yàn)證的pod能否通過驗(yàn)證
pod spec lint --use-libraries --allow-warnings
3. 將spec 文件提交到本地的私有倉庫,然后再push到遠(yuǎn)程倉庫
pod repo push MyTestSpec HFMyTest.podspec --use-libraries --allow-warnings
E、此時(shí)打開/Users/hf/.cocoapods/repos/MyTestSpec,發(fā)現(xiàn)下面多出HFMyTest文件
F、查看遠(yuǎn)程私有索引庫
G、使用終端查看自己的私有組件
pod search HFMyTest
如果提示
[!] Unable to find a pod with name, author, summary, or description matching HFMyTest
沒有找到的話可以刪除search_index.json
終端輸入:
rm ~/Library/Caches/CocoaPods/search_index.json
此時(shí)再
pod search HFMyTest
三、在新的項(xiàng)目中引用這個(gè)組件
新建一個(gè)項(xiàng)目MyTest,添加Podfile文件,格式如下
其中的資源庫地址指定去哪個(gè)資源去搜索資源