問題記錄:隨著項目的越來越多業(yè)務(wù),急需把一些模塊整理最域,打包弄成SDK的形式谴分,通過Cocoapods導(dǎo)入到工程,同時也對工程進(jìn)行組件化考慮镀脂,但是問題就來了牺蹄,有一部分代碼屬于核心部分,不適合開源薄翅,同時很多業(yè)務(wù)邏輯需要依賴第三方的開源框架來完成沙兰。,而且后期可能要給合作的公司調(diào)用SDK來展開合作翘魄。
然后就查看網(wǎng)上資料僧凰,老實說,雖然網(wǎng)上的感覺就那些步驟熟丸,很簡單的樣子训措,但自己走出來的坑,只有自己最清楚光羞,各種心累...绩鸣,現(xiàn)在總算摸著門檻了,死也要記錄一下纱兑。
我要處理大概什么步驟呢呀闻?
1、需要把工程里面的業(yè)務(wù)邏輯代碼和相關(guān)工具類抽出來??潜慎。(急不來捡多,細(xì)心蓖康,而且業(yè)務(wù)流程要熟悉,最好是先在原來工程中整理好,然后把方法和屬性命名風(fēng)格統(tǒng)一垒手,需要考慮暴露什么接口出去給外部調(diào)用)
2蒜焊、好了,花了很大力氣把源碼都抽出來了科贬,問題來了泳梆,接下來該怎么處理了呢?然后就參考網(wǎng)上的各種博文榜掌。
想想需求优妙,就是pod xxx,就導(dǎo)入了xxx,和第三方庫FMDB等,其中xxx中包括一個xxx.framework和一些.h,.m文件(基本就參考了Pod進(jìn)來的高德地圖的SDK的方式)
1、【一個不可泄露的核心源碼的.Framework】
2憎账、【業(yè)務(wù)邏輯:包括{.h,.m}文件套硼,另外依賴一些第三方框架,如FMDB等】
3胞皱、【Pod方式導(dǎo)入】
1邪意、【一個不可泄露的核心源碼的.Framework】
framework總結(jié)思考??:
制作這個Framework,假如需要依賴一些第三方庫朴恳,如AFNetworking,導(dǎo)入頭文件的時候,但是Framework中肯定是沒有AFNetworking源碼的允蚣,有人介紹說直接改類前綴于颖,但感覺肯定不是這樣的(但時間確實緊時,老是說嚷兔,假如還沒找到合適的方式來處理這個問題森渐,這樣也是一個很笨的方法,至少行得通)
再后來我參考別人的博客冒晰,成功弄好Framework之后同衣,回頭再看其實就是依賴就是依賴,理解依賴的含義壶运,不是要你打包進(jìn)去Framework中的耐齐,在制作Framework時那個文件需要,就直接導(dǎo)入頭文件蒋情,如< AFNetworking/AFNetworking.h>
然后打包好之后埠况,假如是直接Framework給別人使用的話,直接在使用說明文檔中指明要依賴AFNetworking框架棵癣,這個很笨拙辕翰,但也是一個方案。
另外一個方案就是不用叫別人手動依賴AFNetworking框架狈谊,這個步驟就由自己自動給他依賴就行了喜命,想想平時Pod導(dǎo)入一些開放平臺的SDK時沟沙,假如Pod A,執(zhí)行之后恋追,發(fā)現(xiàn)A是pod進(jìn)來了舆声,但同時也Pod進(jìn)來了B和C等等秧荆,這不正是我也需要的嗎怔毛?
別急請接著往下看...
2蚀狰、【業(yè)務(wù)依賴一些第三方框架浑厚,如FMDB等】
平時都是在工程中使用別人的開源框架矾瘾,如FMDB姥闭,老實說二庵,集成通過Pod方式來集成贪染,就是舒服。在現(xiàn)在我需要我很多業(yè)務(wù)邏輯也需要依賴這些催享,我也想這樣處理這一步杭隙。
現(xiàn)在Framework我制作好了。我要將Framework與AFNetworking/FMDB等因妙,同時和我業(yè)務(wù)邏輯代碼結(jié)合在一起痰憎。
我是需要把這些如FMDB等都下載下來,然后把業(yè)務(wù)邏輯結(jié)合嗎??攀涵,后面假如別人使用你的代碼铣耘,他的工程中也有FMDB呢,不就沖突了嗎以故?發(fā)現(xiàn)有人說Xcode全局修改FMDB前綴等蜗细,要死的節(jié)奏嗎??
大概的步驟:
這一步我們就可以在終端命令行中下載一個模板工程
然后把上面制作好的Framework文件和業(yè)務(wù)邏輯文件{.h和.m}文件添加到工程中,等等怒详,AFNetworking/FMDB等第三方庫咋辦呢炉媒?
其實吧,模板工程中昆烁,有一個xxx.podspec的文件吊骤,在這個配置文件中,可以配置你的系統(tǒng)依賴庫和第三方依賴框架的??静尼,配置好之后白粉,就基本完成了。剩下的就是需要將這個文件push到一個遠(yuǎn)程服務(wù)器鼠渺。然后就可以通過pod search xxx查找到了蜗元。
創(chuàng)建一個模板工程
pod lib create xxx
模板工程結(jié)構(gòu)如下:
1、刪除ReplaceMe.m,替換成自己的代碼【用上面的Framework文件和其他代碼替換掉】
2系冗、然后修改podspec文件奕扣,這個文件就是配置著你這個工程中需要開源出去的代碼位置以及依賴系統(tǒng)庫和第三方庫的信息。所需要第三方依賴就是通過這個文件來配置的掌敬。
剛剛接觸惯豆,我也不信池磁,我配置了,但怎么知道就是我想要的那種Pod A 就導(dǎo)入 A 楷兽、B地熄、C框架的形式呢,畢竟這些都是別人博客寫著的芯杀,實際效果怎么樣端考,假如沒有試過的話,心虛虛的揭厚,老是覺得是不是錯了却特,沒有信心往下一個步驟進(jìn)行了,畢竟剛剛接觸筛圆,遇到了很多莫名其妙的異常裂明,反正讓你煩躁就是了
這個是我工程中的podspec文件,模板工程中有太援,自行修改一下
#
# Be sure to run `pod lib lint OMCDriveHelper.podspec' to ensure this is a
# valid spec before submitting.
Pod::Spec.new do |s|
s.name = 'DemoSDKSample'
s.version = '0.1.4'
s.summary = 'A short description of DemoSDKSample.'
s.description = <<-DESC
TODO: Add long description of the pod here闽晦,Add long description of the pod here.
DESC
s.homepage = 'https://github.com/baiwulong/DemoSDKSample'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'baiwulong' => '1204803180@qq.com' }
s.source = { :git => 'https://github.com/baiwulong/DemoSDKSample.git', :tag => s.version.to_s }
s.ios.deployment_target = '8.0'
#自己的邏輯代碼
s.source_files = "DemoSDKSample/Classes/**/*.{h,m}"
#依賴自己的或別人的Framework文件
s.vendored_frameworks = 'DemoSDKSample/Classes/*.framework'
#系統(tǒng)依賴庫
s.frameworks = 'UIKit', 'CoreLocation','Foundation'
#依賴第三方框架
s.dependency 'AFNetworking'
s.dependency 'Qiniu'
s.dependency 'FMDB'
end
修改好了之后呢,別急提岔,終端前往Example文件仙蛉,cd 模板工程中的Example
中執(zhí)行Pod install
命令
看到?jīng)]有,是不是和平時常見的一樣熟悉呢碱蒙,原來依賴真是這樣的添加的荠瘪,畢竟以前沒接觸過,看別人的和自己親自操作過一次振亮,感覺不一樣巧还,??(修改了podspec文件鞭莽,假如需要看效果坊秸,就需要到Example中Pod install
一下,和個人感覺是和修改了podfile文件差不多)
此時工程中的結(jié)構(gòu)發(fā)生改變了澎怒,pod install就根據(jù).podspec配置來給demo添加依賴褒搔,并且把配置目錄中的代碼制作成pod庫目錄,通過pod方式加載進(jìn)入工程喷面。
關(guān)于頭文件調(diào)用的注意事項??:
注意??:Framework的代碼星瘾,和一些{h.m}文件的頭文件引用
假如是第三方
#import <xxx/xxx.h>,否者就是#import "xxx.h"
另外xxxFramework:
xxxFramework中的xxxFramework.h頭文件中的暴露頭文件的話,需要使用
#import < xxxFramework/A.h>
#import < xxxFramework/B.h>
#import < xxxFramework/C.h>
完成到這一步后惧辈,大部分工作都做好了琳状,但還得繼續(xù)...
為了能讓代碼和Framework可以pod方式導(dǎo)入到工程,還需要那幾個步驟呢盒齿?
1念逞、在GitHub上創(chuàng)建一個遠(yuǎn)程倉庫困食,如我創(chuàng)建了一個DemoSDKSample的倉庫
下面基本是引用優(yōu)秀博客的
創(chuàng)建好倉庫后,就進(jìn)行g(shù)it操作就行了
把工程添加到倉庫翎承,打上標(biāo)簽tag 硕盹,這個tag對應(yīng)podspec文件中的
如s.version = '0.1.0'
,那代碼就需要打上一個tag為0.1.0
的標(biāo)簽tag,然后推送到遠(yuǎn)程倉庫(終端自己使用git 命令來操作或使用sourcetree軟件來操作都可以)
注意:遠(yuǎn)程倉庫不需要創(chuàng)建gitignore文件叨咖,因為pod lib創(chuàng)建了
提交自己倉庫代碼到遠(yuǎn)程倉庫
git init :初始化git
git status : 查看狀態(tài)瘩例,如果有不想要的文件,可以用gitignore忽略掉
提交到本地緩存區(qū) `git add .``
提交到本地倉庫 git commit -m ''
查看遠(yuǎn)程倉庫地址 git remote(查看有沒有遠(yuǎn)程地址)
綁定遠(yuǎn)程地址 git remote add origin 遠(yuǎn)程倉庫地址
推送自己代碼到遠(yuǎn)程倉庫 git push origin master
git tag -a 0.0.1 -m '0.0.1' :添加標(biāo)簽tag
git push --tags:推送本地標(biāo)簽到遠(yuǎn)程倉庫中
注冊trunk
* 注冊trunk甸各,不是任何人都能推送垛贤,因為cocoapods依賴trunk服務(wù)器管理,所以需要通過trunk推送自己的podspec([cocoapods官網(wǎng)](https://link.jianshu.com?t=https://blog.cocoapods.org/CocoaPods-Trunk/))
* 命令:`pod trunk register EMAIL [NAME]`
* pod trunk register [58999050@qq.com](https://link.jianshu.com?t=mailto:58999050@qq.com) yuanzheng
* 驗證成功后痴晦,點擊郵箱就好了南吮,打開會有點慢.
推送自己的podspec到cocoapods的索引庫
pod trunk push HttpManager.podspec --allow-warnings
- 注意:必須cd 進(jìn)入到podspec目錄下,才能執(zhí)行這個代碼
- 注意:podspec文件中的s.version版本號要跟最新Tag一致
- 注意:podspec文件中的s.source倉庫地址也不能寫錯
測試能否索引到
pod search 自己倉庫
發(fā)現(xiàn)索引不到誊酌,其實已經(jīng)上傳到cocoapods上了部凑,只不過需要重新更新索引文件
怎么更新pod索引文件?
原理:pod setup成功后會生成~/Library/Caches/CocoaPods/search_index.json文件
把search_index.json文件文件刪除碧浊,重新執(zhí)行pod search涂邀,就會重新更新索引.
終端執(zhí)行:
rm ~/Library/Caches/CocoaPods/search_index.json
pod search xxx
報錯?:
處理方法:pod trunk push DemoSDKSample.podspec --allow-warnings --use-libraries
(有引用框架時,需加入 --use-libraries)
- ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.
報錯?:遠(yuǎn)程沒有創(chuàng)建對應(yīng)的tag標(biāo)簽
處理方法箱锐,添加遠(yuǎn)程對應(yīng)的tag比勉,然后重新執(zhí)行
warning: Could not find remote branch 0.1.0 to clone.
fatal: Remote branch 0.1.0 not found in upstream origin
反正就是需要細(xì)心,需要耐性驹止,有問題就網(wǎng)上找解決方法浩聋,
成功后的截圖:
好多好文章,推薦:
教你如何從0到1實現(xiàn)組件化架構(gòu)
SDK制作專題