【iOS 開發】利用 Carthage 將項目打包 Framework 并依賴 CocoaPods 第三方庫的方法

最近需要將自己公司的項目的打包成 Framework 然后以 SDK 的形式來供客戶使用,但是項目中用到不少 Cocoapods 第三方的庫,怎么才能將項目打包 Framework 并依賴 CocoaPods 第三方庫呢,網上找了很久都沒有找到一篇專門說這個的,讓我走了很多的坑,手動打包 Framework 太麻煩,開始嘗試了 cocoapods-packager 方式打包,但是這個插件貌似對于 Swift 項目的支持并不是很好,嘗試很久都沒有打包成功,作者貌似也不是很活躍,無奈放棄,最后選擇用 Carthage 方式來打包 Framework ,下面就分享一下利用 Carthage 將項目打包 Framework 并依賴 CocoaPods 第三方庫的方法。


創建工程并打包 Framework

我這邊演示的是 Swift 工程,Objective-C 也是一樣的,演示Demo 我會保留,不懂的可以看一下。

1. 創建 Framework 工程

  • 新建一個工程或者在現有工程下創建一個新的 target ,類型需要選擇 Coaoa Touch Framework ,這里說一下我的 Xcode 版本是 10.0.0

    image
  • 由于 Carthagebuild 時,會自動將設置為 Sharedframework target 構建成 framework ,所以需要單擊頂部 target ,在彈出選項中選中 Manager Schemes ,將 framework targetShared 選項選中。

2. 創建 podfile 集成第三方庫

  • 假設我的代碼中要用到 Alamofire 這個第三方庫(用于演示),然后使用 CocoaPods 在工程中集成 Alamofire ,集成方法和普通項目一模一樣。

  • 創建 podfile 并加入 pod 'Alamofire' ,然后執行 pod install ,然后選擇工程下的 FrameworkDemo.xcworkspace 重新打開工程。

    image

3. 創建測試代碼

  • 我這邊創建了一個 TestAlamofire.swift 的測試文件,并在里面使用了 Alamofire 這個庫,一會打包就打包這個文件。

  • 然后編譯一下,編譯通過,測試代碼如下。

4. 構建 framework

  • 打開終端 cd 到工程目錄下,執行以下命令開始打包 framework ,執行完成后會自動將 framework 文件保存在工程的 Carthage/Build/iOS 文件夾下。

    carthage build --no-skip-current
    
  • 到此 framework 就打包完成了,想了解更多關于 Carthage 打包的詳情,可以看我另一篇文章:【iOS 開發】給自己項目添加 Carthage 支持的方法 ,方法基本一致,我這邊就不詳述了。

將 Framework 傳到 Cocoapods 倉庫

由于打包好的 framework 需要依賴 Alamofire 這個庫,單獨運行會報錯,如果直接將 framework 給客戶讓客戶自己依賴 Alamofire 的話,并不友好,所以打算將 framework 傳到 Cocoapods 倉庫,并指定 Alamofire 依賴庫,這樣客戶直接 pod 我們封裝好的庫即可。

1. 創建 Git 倉庫

  • 先創建一個 Git 倉庫,倉庫中必須包含一個 License 文件,類型為 MIT License
  • 接著 Clone 到本地,將剛才打包的 Framework 放進去,我這邊就直接將測試工程放進去了。

2. 創建 podspec 文件

  • 在倉庫目錄下新建一個 podspec 文件,文件名就是 pod 庫的名稱,我這邊叫 FrameworkDemo_Gzz.podspec ,或者使用以下命令創建。

    pod spec create FrameworkDemo_Gzz
    
  • 然后打開 podspec 文件,內容編輯如下,內容的具體意思我這邊就不詳述了。

    Pod::Spec.new do |s|
      s.name                      = 'FrameworkDemo_Gzz'
      s.version                   = '1.0.0'
      s.summary                   = '測試 Framework'
      s.homepage                  = 'https://github.com/Jonzzs/FrameworkDemo'
      s.license                   = { :type => 'MIT', :file => 'LICENSE' }
      s.author                    = { 'Jonzzs' => '292710547@qq.com' }
      s.source                    = { :git => 'https://github.com/Jonzzs/FrameworkDemo.git', :tag => s.version }
      s.platform                  = :ios
      s.ios.deployment_target     = '9.0'
      s.swift_version             = '4.0'
      s.ios.vendored_frameworks   = 'Carthage/Build/iOS/*.framework'
    
      # 依賴庫
      s.dependency 'Alamofire'
    end 
    

3. 驗證 podspec 文件

  • 編輯完成后,打開終端 cdpodspec 所在文件目錄下,輸入以下命令來驗證編譯是否通過。

    pod lib lint --allow-warnings --verbose
    
  • 驗證通過會顯示 FrameworkDemo_Gzz passed validation

4. 給項目打上 tag 并上傳

  • podspec 文件驗證成功后,先將改動后的文件 commit 提交,接著 push 推送到遠程倉庫 。

  • 因為 CocoaPods 是依賴項目的 tag 版本的,所以必須打上 tag 版本,執行以下命令打上 tag 版本,版本名必須要和之前podspec 文件中的 s.version 一致。

    git tag "1.0.0" // 為 git 提交打上 tag
    git push --tags // 將 tag 推送到遠程倉庫
    

5. 發布到 CocoaPods

  • 打開終端 cdpodspec 所在文件目錄下,輸入以下命令來發布到 CocoaPods

    pod trunk push *.podspec --allow-warnings
    
  • 發布成功會顯示 successfully published

  • 到此就發布完成了,我這邊講的比較簡單,如果發布 CocoaPods 遇到什么問題或者報錯,可以看我的另一篇文章:【iOS 開發】創建 podspec 文件,給自己寫的框架添加 CocoaPos 支持 ,我這邊就不詳述了。

測試 Framework 的 Pod 庫

  • 新建一個測試工程 Test ,然后將剛才傳到 CocoaPods 的庫引入,然后執行 pod install

  • 可以看到 pod 將我們的 frameworkAlamofire 依賴庫一起 pod 下來了。

  • 然后在控制器中 import FrameworkDemo 引入我們的庫,執行庫中用到 Alamofire 的一個方法。

  • 編譯運行成功,打印結果正常。


演示Demo 在這,有不懂的地方可以看一下,希望能夠幫助大家少走一些坑。

將來的你,一定會感激現在拼命的自己,愿自己與讀者的開發之路無限美好。

我的傳送門: 博客簡書微博GitHub

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

推薦閱讀更多精彩內容