問題記錄:隨著項目的越來越多業務,急需把一些模塊整理,打包弄成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】
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制作專題