iOS 高級篇 - 《SDK制作完整篇》

問題記錄:隨著項目的越來越多業(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】

iOS 高級篇 - 《SDK-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   
模板工程創(chuàng)建過程

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

文件目錄結(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命令

cd 模板工程中的Example,Pod install

看到?jīng)]有,是不是和平時常見的一樣熟悉呢碱蒙,原來依賴真是這樣的添加的荠瘪,畢竟以前沒接觸過,看別人的和自己親自操作過一次振亮,感覺不一樣巧还,??(修改了podspec文件鞭莽,假如需要看效果坊秸,就需要到Example中Pod install一下,和個人感覺是和修改了podfile文件差不多)
pod install會自動導(dǎo)入相關(guān)的依賴

此時工程中的結(jié)構(gòu)發(fā)生改變了澎怒,pod install就根據(jù).podspec配置來給demo添加依賴褒搔,并且把配置目錄中的代碼制作成pod庫目錄,通過pod方式加載進(jìn)入工程喷面。

工程結(jié)構(gòu)發(fā)生變化了

關(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的倉庫


GitHub上創(chuàng)建倉庫

下面基本是引用優(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)上找解決方法浩聋,


成功后的截圖:

屏幕快照 2018-04-12 上午11.17.53.png
屏幕快照 2018-04-12 上午11.19.56.png

好多好文章,推薦:
教你如何從0到1實現(xiàn)組件化架構(gòu)
SDK制作專題

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市臊恋,隨后出現(xiàn)的幾起案子衣洁,更是在濱河造成了極大的恐慌,老刑警劉巖抖仅,帶你破解...
    沈念sama閱讀 217,406評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件坊夫,死亡現(xiàn)場離奇詭異,居然都是意外死亡撤卢,警方通過查閱死者的電腦和手機环凿,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,732評論 3 393
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來放吩,“玉大人智听,你說我怎么就攤上這事。” “怎么了到推?”我有些...
    開封第一講書人閱讀 163,711評論 0 353
  • 文/不壞的土叔 我叫張陵忽洛,是天一觀的道長。 經(jīng)常有香客問我环肘,道長欲虚,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,380評論 1 293
  • 正文 為了忘掉前任悔雹,我火速辦了婚禮复哆,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘腌零。我一直安慰自己梯找,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 67,432評論 6 392
  • 文/花漫 我一把揭開白布益涧。 她就那樣靜靜地躺著锈锤,像睡著了一般。 火紅的嫁衣襯著肌膚如雪闲询。 梳的紋絲不亂的頭發(fā)上久免,一...
    開封第一講書人閱讀 51,301評論 1 301
  • 那天,我揣著相機與錄音扭弧,去河邊找鬼阎姥。 笑死,一個胖子當(dāng)著我的面吹牛鸽捻,可吹牛的內(nèi)容都是我干的呼巴。 我是一名探鬼主播,決...
    沈念sama閱讀 40,145評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼御蒲,長吁一口氣:“原來是場噩夢啊……” “哼衣赶!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起厚满,我...
    開封第一講書人閱讀 39,008評論 0 276
  • 序言:老撾萬榮一對情侶失蹤府瞄,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后痰滋,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體摘能,經(jīng)...
    沈念sama閱讀 45,443評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡续崖,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,649評論 3 334
  • 正文 我和宋清朗相戀三年敲街,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片严望。...
    茶點故事閱讀 39,795評論 1 347
  • 序言:一個原本活蹦亂跳的男人離奇死亡多艇,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出像吻,到底是詐尸還是另有隱情峻黍,我是刑警寧澤复隆,帶...
    沈念sama閱讀 35,501評論 5 345
  • 正文 年R本政府宣布,位于F島的核電站姆涩,受9級特大地震影響挽拂,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜骨饿,卻給世界環(huán)境...
    茶點故事閱讀 41,119評論 3 328
  • 文/蒙蒙 一亏栈、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧宏赘,春花似錦绒北、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,731評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至贴汪,卻和暖如春脐往,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背扳埂。 一陣腳步聲響...
    開封第一講書人閱讀 32,865評論 1 269
  • 我被黑心中介騙來泰國打工钙勃, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人聂喇。 一個月前我還...
    沈念sama閱讀 47,899評論 2 370
  • 正文 我出身青樓辖源,卻偏偏與公主長得像,于是被迫代替她去往敵國和親希太。 傳聞我的和親對象是個殘疾皇子克饶,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,724評論 2 354