最近在做利用pod進(jìn)行組件化重構(gòu)箫荡,因?yàn)闆](méi)什么經(jīng)驗(yàn)魁亦,也是一邊學(xué)著,一邊做著羔挡,然后這里將我遇到的問(wèn)題整理了下來(lái)
踩坑點(diǎn) 持續(xù)更新洁奈。。绞灼。
1利术、利用pod lib create 開(kāi)發(fā),添加podspec 的 resources低矮,寫(xiě)法都對(duì)但是pod install后印叁,圖片資源在,就是不顯示(不使用bundle方式調(diào)用圖片)
解決:pod lib create 的 自動(dòng)生成的 podfile 帶有 use_frameworks!
刪除即可 (使用bundle方式不需要?jiǎng)h除use_frameworks!)
關(guān)于 use_frameworks! 點(diǎn)擊傳送門(mén)
s.resources = 'sqbj-common-kit/Assets/**/*.{png}'
若是不使用use_frameworks! 但是運(yùn)行時(shí)發(fā)現(xiàn)報(bào)錯(cuò)轮蜕,xxx.framework找不到昨悼,直接刪除DerivedData或者Xcode->Product->clean
原因:use_frameworks\!打的是 lib.framework跃洛,不使用打的是 lib.a 率触,不使用use_frameworks也就是用.a,那么自然是需要清除framework緩存汇竭,來(lái)處理緩存給我們帶來(lái)的系列問(wèn)題
我們?cè)谑褂煤筒皇褂胾se_frameworks!的兩種情況下可以看Pods下的Products 文件夾葱蝗,他里邊就是依賴庫(kù)經(jīng)過(guò)pod自動(dòng)生成的framework或者 lib.a 文件,我們?cè)谑褂?use_frameworks! 的時(shí)候韩玩,這個(gè)文件夾下是 framework垒玲,反之是 lib.a
2、關(guān)于 subspec 找颓,每一個(gè) spec或subspec 都需要有一個(gè) end 對(duì)應(yīng)合愈,并且 subspec 之間的相互引用需要做依賴,否則會(huì)報(bào)找不到文件击狮,示例代碼
Pod::Spec.new do |s|
s.name = 'sqbj-common-kit'
s.version = '0.0.1'
s.summary = '公共庫(kù)'
s.description = <<-DESC
社區(qū)半徑公共庫(kù)
DESC
s.homepage = 'https://xxxt/ios-common-kit'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'blackstar_lang@163.com' => 'langzq@sqbj.com' }
s.source = { :git => 'https://xxx/ios-common-kit.git', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.resources = 'sqbj-common-kit/Assets/**/*.{png}'
s.subspec 'SQSystem' do |sss|
sss.source_files = 'sqbj-common-kit/Classes/SQSystem/*.{h,m}'
sss.public_header_files = 'sqbj-common-kit/Classes/SQSystem/*.h'
sss.dependency 'sqbj-common-kit/SQBaseObject'
end
s.subspec 'SQBaseUI' do |sss|
sss.source_files = 'sqbj-common-kit/Classes/SQBaseUI/*.{h,m}'
sss.public_header_files = 'sqbj-common-kit/Classes/SQBaseUI/*.h'
sss.dependency 'Masonry'
sss.dependency 'sqbj-common-kit/SQCategory'
sss.dependency 'sqbj-common-kit/SQBaseObject'
end
s.subspec 'SQBaseObject' do |sss|
sss.source_files = 'sqbj-common-kit/Classes/SQBaseObject/*.{h,m}'
sss.public_header_files = 'sqbj-common-kit/Classes/SQBaseObject/*.h'
sss.dependency 'YYModel'
end
s.subspec 'SQCategory' do |sss|
sss.source_files = 'sqbj-common-kit/Classes/SQCategory/*.{h,m}'
sss.public_header_files = 'sqbj-common-kit/Classes/SQCategory/*.h'
end
s.frameworks = 'UIKit', 'Foundation'
end
3佛析、我們?cè)趐od install 后可能會(huì)出現(xiàn) 找不到文件的報(bào)錯(cuò),退出此工程彪蓬,重新打開(kāi)即可(Xcode或者Cocoapods的 Bug寸莫,執(zhí)行pod install 后不刷新 pod 庫(kù))
4、s.license 設(shè)置后档冬,發(fā)布pod庫(kù)報(bào)找不到LICENSE的警告膘茎,對(duì)于LICENSE可以使用 pod lib create 自動(dòng)生成或者 我們?cè)谛陆ㄒ粋€(gè)網(wǎng)絡(luò)代碼倉(cāng)庫(kù)可以直接創(chuàng)建LICENSE,這兩個(gè)LICENSE是不會(huì)報(bào)警告的(我之前自己創(chuàng)建的LICENSE)
5酷誓、私有庫(kù)和公共庫(kù) 發(fā)布的組件一個(gè)名字披坏,但是找組件的時(shí)候會(huì)優(yōu)先找master的倉(cāng)庫(kù),辦法就是干掉master(不想用的倉(cāng)庫(kù))上發(fā)的組件盐数,可以delete 或者 deprecate(廢棄) 某一版本(所有版本都干掉)棒拂,千萬(wàn)別 移除自己倉(cāng)庫(kù)權(quán)限(remove-owner),找不回來(lái)玫氢,我命令弄錯(cuò)了帚屉,公共庫(kù)組件一直占用我的名字,因?yàn)槲颐际且?guī)范-強(qiáng)制漾峡,就很難受攻旦,我就把本地master倉(cāng)庫(kù)中的組件podspec刪了,這樣就只能找我需要用的repo了
可能用到的命令
pod trunk me //查看我自己發(fā)布的公共庫(kù)組件
pod repo //查看本地repo庫(kù)
pod trunk delete 組件名稱 版本號(hào)
pod trunk deprecate 組件名稱 版本號(hào)
pod trunk info 組件名稱 查看組件信息(發(fā)布時(shí)間生逸,組件擁有人)
6敬特、我們使用pod lib create 創(chuàng)建的項(xiàng)目掰邢,發(fā)現(xiàn)在pod下的組件斷點(diǎn)debug不起作用牺陶,我們需要設(shè)置組件的調(diào)試編譯策略
有關(guān)編譯策略 Optimization Level 介紹點(diǎn)擊編譯策略
7伟阔、pod spec lint common-kit.podspec 或者push發(fā)布組件庫(kù)的時(shí)候報(bào)錯(cuò)找不到依賴庫(kù):
- ERROR | [iOS] unknown: Encountered an unknown error (Unable to find a specification for ` common-kit` depended upon by `login-kit`
原因:我的 login-kit 依賴于 common-kit ,但是 common-kit 是私有庫(kù)組件掰伸,我們?cè)趐odfile里可以聲明source皱炉,但是podspec文件是不能聲明依賴組件的代碼地址庫(kù)的,所以需要我們?cè)趌int或者push的時(shí)候加入source 聲明
pod spec lint login-kit.podspec --sources='自己的私有庫(kù)地址,https://github.com/CocoaPods/Specs' --allow-warnings
8狮鸭、pod spec lint 的時(shí)候報(bào)錯(cuò)
[-Werror,-Wnon-modular-include-in-framework-module]
原因:沒(méi)搞懂合搅,大概就是組件引用相關(guān)問(wèn)題
解決辦法:在 pod spec lint 的時(shí)候加入?yún)?shù) --use-libraries
pod spec lint sqbj-login-kit.podspec --sources='私有庫(kù)地址,https://github.com/CocoaPods/Specs' --allow-warnings --use-libraries
9、在使用pod repo push 倉(cāng)庫(kù)地址 xxx.podspec 發(fā)布私有庫(kù)的時(shí)候歧蕉,為了方便灾部,我們可以將repo遠(yuǎn)程倉(cāng)庫(kù)地址改成repo倉(cāng)庫(kù)名稱,比如說(shuō)惯退,我的倉(cāng)庫(kù)地址是https://jlkdfjlasdjkdaejf.com 你能記得住嗎赌髓,用起來(lái)多不方便,所以我們就可以這樣做:
pod repo add 自定義倉(cāng)庫(kù)名稱 倉(cāng)庫(kù)地址
然后我們發(fā)布私有庫(kù)
pod repo push 自定義倉(cāng)庫(kù)名稱 xxx.podspec
示例
pod repo push sqbj-ios login-kit.podspec --allow-warnings --use-libraries
10催跪、pod repo push的時(shí)候可能報(bào)錯(cuò)锁蠕,說(shuō)找不到分支,這個(gè)問(wèn)題挺有意思的懊蒸,我們自己搭建的gitlab服務(wù)器荣倾,代碼都在這托管,我創(chuàng)建了管理 podspec 的倉(cāng)庫(kù)(即創(chuàng)建一個(gè)project)骑丸,然后我執(zhí)行 pod repo add sqbj-ios 倉(cāng)庫(kù)地址舌仍,顯示clone xxx。通危。铸豁。。黄鳍,也就是說(shuō)倉(cāng)庫(kù)已經(jīng)克隆下來(lái)了推姻,cd到這個(gè)repo倉(cāng)庫(kù),顯示分支master 框沟,但是執(zhí)行pod repo push 非說(shuō)沒(méi)分支藏古,不能push 。我們?cè)谶h(yuǎn)端新建一個(gè)project 什么都不能看忍燥,是沒(méi)有分支拧晕、提交信息的,我沒(méi)辦法梅垄,按理來(lái)說(shuō)是有個(gè)默認(rèn)的master分支的厂捞,但是非說(shuō)我沒(méi)有,很無(wú)奈,我就在遠(yuǎn)端直接創(chuàng)建了一個(gè)README靡馁,然后回到repo倉(cāng)庫(kù)欲鹏,pull了一下,README下載下來(lái)了臭墨,然后回到代碼工程目錄赔嚎,執(zhí)行pod repo push 發(fā)現(xiàn)好了,很奇葩胧弛。
11尤误、文件或圖片導(dǎo)入后,發(fā)現(xiàn)后邊顯示 结缚?并且無(wú)法使用
解決辦法:選中帶問(wèn)號(hào)的文件或文件夾损晤,右鍵 -> Source Control -> add selected files (此問(wèn)題跟pod沒(méi)啥關(guān)系,應(yīng)該是Xcode的問(wèn)題红竭,但是因?yàn)殚_(kāi)發(fā)組件時(shí)遇到的尤勋,就也記下來(lái)了)