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

問題記錄:隨著項目的越來越多業務,急需把一些模塊整理,打包弄成SDK的形式,通過Cocoapods導入到工程,同時也對工程進行組件化考慮,但是問題就來了,有一部分代碼屬于核心部分,不適合開源,同時很多業務邏輯需要依賴第三方的開源框架來完成。,而且后期可能要給合作的公司調用SDK來展開合作
然后就查看網上資料,老實說,雖然網上的感覺就那些步驟,很簡單的樣子,但自己走出來的坑,只有自己最清楚,各種心累...,現在總算摸著門檻了,死也要記錄一下。

我要處理大概什么步驟呢?

1、需要把工程里面的業務邏輯代碼和相關工具類抽出來??。(急不來,細心,而且業務流程要熟悉,最好是先在原來工程中整理好,然后把方法和屬性命名風格統一,需要考慮暴露什么接口出去給外部調用)

2、好了,花了很大力氣把源碼都抽出來了,問題來了,接下來該怎么處理了呢?然后就參考網上的各種博文。
想想需求,就是pod xxx,就導入了xxx,和第三方庫FMDB等,其中xxx中包括一個xxx.framework和一些.h,.m文件(基本就參考了Pod進來的高德地圖的SDK的方式)
1、【一個不可泄露的核心源碼的.Framework】
2、【業務邏輯:包括{.h,.m}文件,另外依賴一些第三方框架,如FMDB等】
3、【Pod方式導入】

1、【一個不可泄露的核心源碼的.Framework】

iOS 高級篇 - 《SDK-framework篇》

framework總結思考??:

制作這個Framework,假如需要依賴一些第三方庫,如AFNetworking,導入頭文件的時候,但是Framework中肯定是沒有AFNetworking源碼的,有人介紹說直接改類前綴,但感覺肯定不是這樣的(但時間確實緊時,老是說,假如還沒找到合適的方式來處理這個問題,這樣也是一個很笨的方法,至少行得通)

再后來我參考別人的博客,成功弄好Framework之后,回頭再看其實就是依賴就是依賴,理解依賴的含義,不是要你打包進去Framework中的,在制作Framework時那個文件需要,就直接導入頭文件,如< AFNetworking/AFNetworking.h>
然后打包好之后,假如是直接Framework給別人使用的話,直接在使用說明文檔中指明要依賴AFNetworking框架,這個很笨拙,但也是一個方案。
另外一個方案就是不用叫別人手動依賴AFNetworking框架,這個步驟就由自己自動給他依賴就行了,想想平時Pod導入一些開放平臺的SDK時,假如Pod A,執行之后,發現A是pod進來了,但同時也Pod進來了B和C等等,這不正是我也需要的嗎?
別急請接著往下看...

2、【業務依賴一些第三方框架,如FMDB等】

平時都是在工程中使用別人的開源框架,如FMDB,老實說,集成通過Pod方式來集成,就是舒服。在現在我需要我很多業務邏輯也需要依賴這些,我也想這樣處理這一步。
現在Framework我制作好了。我要將Framework與AFNetworking/FMDB等,同時和我業務邏輯代碼結合在一起。
我是需要把這些如FMDB等都下載下來,然后把業務邏輯結合嗎??,后面假如別人使用你的代碼,他的工程中也有FMDB呢,不就沖突了嗎?發現有人說Xcode全局修改FMDB前綴等,要死的節奏嗎??

大概的步驟:

這一步我們就可以在終端命令行中下載一個模板工程
然后把上面制作好的Framework文件和業務邏輯文件{.h和.m}文件添加到工程中,等等,AFNetworking/FMDB等第三方庫咋辦呢?
其實吧,模板工程中,有一個xxx.podspec的文件,在這個配置文件中,可以配置你的系統依賴庫和第三方依賴框架的??,配置好之后,就基本完成了。剩下的就是需要將這個文件push到一個遠程服務器。然后就可以通過pod search xxx查找到了。

創建一個模板工程

pod lib create xxx   
模板工程創建過程

模板工程結構如下:

文件目錄結構

1、刪除ReplaceMe.m,替換成自己的代碼【用上面的Framework文件和其他代碼替換掉】

替換文件

2、然后修改podspec文件,這個文件就是配置著你這個工程中需要開源出去的代碼位置以及依賴系統庫和第三方庫的信息。所需要第三方依賴就是通過這個文件來配置的。

剛剛接觸,我也不信,我配置了,但怎么知道就是我想要的那種Pod A 就導入 A 、B、C框架的形式呢,畢竟這些都是別人博客寫著的,實際效果怎么樣,假如沒有試過的話,心虛虛的,老是覺得是不是錯了,沒有信心往下一個步驟進行了,畢竟剛剛接觸,遇到了很多莫名其妙的異常,反正讓你煩躁就是了

這個是我工程中的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'
  #系統依賴庫
  s.frameworks = 'UIKit', 'CoreLocation','Foundation'  
  #依賴第三方框架
  s.dependency 'AFNetworking'
  s.dependency 'Qiniu'
  s.dependency 'FMDB'
  
end

修改好了之后呢,別急,終端前往Example文件,cd 模板工程中的Example中執行Pod install命令

cd 模板工程中的Example,Pod install

看到沒有,是不是和平時常見的一樣熟悉呢,原來依賴真是這樣的添加的,畢竟以前沒接觸過,看別人的和自己親自操作過一次,感覺不一樣,??(修改了podspec文件,假如需要看效果,就需要到Example中Pod install一下,和個人感覺是和修改了podfile文件差不多)
pod install會自動導入相關的依賴

此時工程中的結構發生改變了,pod install就根據.podspec配置來給demo添加依賴,并且把配置目錄中的代碼制作成pod庫目錄,通過pod方式加載進入工程。

工程結構發生變化了

關于頭文件調用的注意事項??:

注意??: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>

完成到這一步后,大部分工作都做好了,但還得繼續...

為了能讓代碼和Framework可以pod方式導入到工程,還需要那幾個步驟呢?

1、在GitHub上創建一個遠程倉庫,如我創建了一個DemoSDKSample的倉庫


GitHub上創建倉庫

下面基本是引用優秀博客的

創建好倉庫后,就進行git操作就行了
把工程添加到倉庫,打上標簽tag ,這個tag對應podspec文件中的
s.version = '0.1.0',那代碼就需要打上一個tag為0.1.0的標簽tag,然后推送到遠程倉庫(終端自己使用git 命令來操作或使用sourcetree軟件來操作都可以)

注意:遠程倉庫不需要創建gitignore文件,因為pod lib創建了
提交自己倉庫代碼到遠程倉庫
git init :初始化git
git status : 查看狀態,如果有不想要的文件,可以用gitignore忽略掉
提交到本地緩存區 `git add .``
提交到本地倉庫 git commit -m ''
查看遠程倉庫地址 git remote(查看有沒有遠程地址)
綁定遠程地址 git remote add origin 遠程倉庫地址
推送自己代碼到遠程倉庫 git push origin master
git tag -a 0.0.1 -m '0.0.1' :添加標簽tag
git push --tags:推送本地標簽到遠程倉庫中

注冊trunk

*   注冊trunk,不是任何人都能推送,因為cocoapods依賴trunk服務器管理,所以需要通過trunk推送自己的podspec([cocoapods官網](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 進入到podspec目錄下,才能執行這個代碼
  • 注意:podspec文件中的s.version版本號要跟最新Tag一致
  • 注意:podspec文件中的s.source倉庫地址也不能寫錯

測試能否索引到

pod search 自己倉庫
發現索引不到,其實已經上傳到cocoapods上了,只不過需要重新更新索引文件

怎么更新pod索引文件?

原理:pod setup成功后會生成~/Library/Caches/CocoaPods/search_index.json文件
把search_index.json文件文件刪除,重新執行pod search,就會重新更新索引.
終端執行:
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.

報錯?:遠程沒有創建對應的tag標簽
處理方法,添加遠程對應的tag,然后重新執行

warning: Could not find remote branch 0.1.0 to clone.
fatal: Remote branch 0.1.0 not found in upstream origin

反正就是需要細心,需要耐性,有問題就網上找解決方法,


成功后的截圖:

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

好多好文章,推薦:
教你如何從0到1實現組件化架構
SDK制作專題

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