CocoaPods發布FrameWork公有庫

廢話不多說,開始

1.首先注冊一個CocoaPods的賬戶

pod命令:

$ pod trunk register EMAIL [YOUR_NAME]

舉個例子:

$ pod trunk register nezha@fengshen.com 'Ne Zha'


2.創建Git倉庫,需要帶上MIT許可。

Git的倉庫可以是GitHub這種公共的源,也可以是你們自己搭建的,像我這種普通玩家還是建一個GitHub的倉庫來的實在。


3.把剛剛創建的倉庫克隆到本地(高級->master)

對于Git,我還是喜歡用sourcetree,看得見的才放心。


4.把Framework拖到本地倉庫文件夾中

拖進來之后,sourcetree就會提示你本地有變動。然后就是提交(Commit)。

5.打標簽,推送到遠程倉庫

打標簽就是在push之前,用sourcetree給本次更新打一個tag。這個tag很重要,tag建議使用1.2.3這樣的版本號,因為這個tag就是CocoaPods以后需要使用的版本號。


6.創建podSpec文件

最重點的就是這個podSpec文件,這里面記錄著你Pod所有的信息。

提示:我是cd到本地倉庫文件夾做的操作。我的本地倉庫中把MIT Licence 文件也克隆了下來,所有在我的本地倉庫文件夾中是有licence文件的,如果沒有這個文件會報警告,但是不影響。

pod命令:

$ pod spec create xxx

舉個例子:

$ pod spec create NeZha

重點

podSpec文件

Pod::Spec.new do |spec|

  spec.name         = "NeZha"
  spec.version      = "1.2.3" #此處要與上傳到Git的tag一致
  spec.summary      = "This is my test pod." #摘要,隨便寫
  spec.homepage     = "https://github.com/NeZha" #主頁,隨便寫
  spec.license      = "MIT" #許可證類型,我只會MIT,其它的請自行Google
  spec.author       = { "Ne Zha" => "nezha@fengshen.com" } #作者和郵箱地址,隨便寫

  spec.platform     = :ios, "8.0" #支持的平臺,以及支持的最低系統版本
  spec.source       = { :git => "https://github.com/NeZha.git", :tag => "#{spec.version}" }
  spec.source_files = "NeZha.framework/Headers/*.{h}" #001號 坑

  spec.pod_target_xcconfig = { 'OTHER_LDFLAGS' => '-lObjC' } #002號 坑
  spec.ios.vendored_frameworks = 'NeZha.framework' #003號 坑
  spec.requires_arc = true #是否需要ARC
  spec.frameworks = "Foundation", "UIKit" #依賴多個系統framework
  spec.libraries = 'iconv', 'xml2' # 004號 坑

  spec.dependency "AFNetworking", "3.2.1" #依賴三方的庫,如果想要添加多個依賴,不可以用逗號隔開,應該依賴一個寫一句。
  spec.dependency "FMDB", "2.7.5"
end
坑點:

001號:這里要注意文件路徑層級,層級從本地倉庫內開始算為第一層,如圖:

xxoo.png

這個路徑就應該寫成:

spec.source_files = "NeZha.framework/Headers/*.{h}"



002號:我的SDK里用到了Category,所以手動集成時要在Other Linker Flags中添加-ObjC。但是我在CocoaPods中一直找不到怎么自動設置這個工程配置,后來也是在CocoaPods官網一個一個試驗出來的。

spec.pod_target_xcconfig = { 'OTHER_LDFLAGS' => '-lObjC' }



003號:這個地方就是和我以前只上傳.h .m 源碼的最大區別。Framework講到底不是文件,是一個文件夾,而且是一個特殊的文件夾。想要Framework正常使用,必須用到這句。而且這里可以用逗號隔開,添加多個Framework,比如:

spec.ios.vendored_frameworks = 'NeZha.framework', 'AoBing.framework', 'TaiYi.framework'



004號:設置依賴多個系統的library。設置library有個小坑,正常在Xcode里我們見到的一般都叫libz.tbd、libxml2.tbd,但是這里不能這么寫,lib要去掉,.tbd也要去掉,只留下 z 或者 xml2 這個名字就行。

7.驗證podspec文件語法

pod命令:

pod spec lint xxx.podspec

舉個例子:

pod spec lint NeZha.podspec

這一步,Error不能忽略(你也過不去)必須解決。Warning可忽略。如果出錯了卻看不到具體錯誤信息,可以在命令后面加--verbose,比如:

pod spec lint NeZha.podspec --verbose

這樣就會有詳細的debug信息打印出來。

8.發布到CocoaPods

pod命令:

pod trunk push xxx.podspec

舉個例子:

pod trunk push NeZha.podspec

發布成功會提示你Tell your friends,然后還有個小火箭??。

另外

有個特殊情況,比如你的Framework強依賴AFNetworking,即在文件中import了AFN的頭文件之類的操作,但是作為一個不為別人添麻煩的Framework應該學會照顧自己。也就是說當有些人的工程中采用手動方式集成了AFN,而你的Pod依賴了AFN,這樣Pod中有一份AFN,主工程中有一份AFN,就會造成重復導入的情況。

那么,如果我們不在podSpec中依賴AFN是不是就可以了呢?;卮鹗牵阂话闱闆r下不行。你會發現如果你直接pod spec lint去檢查語法,會報錯,找不到文件。也就是說當你trunk push的時候你也是push不了的。因為CocoaPods上傳時會先調用xcodebuild,檢查一遍文件是否可以正常編譯。

解決辦法就是:

pod trunk push xx.podspec --skip-import-validation

跳過import的檢查就行了

再另外

一般剛剛push到CocoaPods的新庫,此時你pod search 是搜不到的,執行下列命令:

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