如何部署 Framework 到 CocoaPods

CocoaPodsLogo.png

iOS 中常見的第三方庫都可以通過 CocoaPods 集成到項目中,它們基本是開源的,但不妨有些商業項目,不希望源代碼公開,只以 Framework 的形式發布,這時就需要考慮如何發布 Framework 包到 pod。

本文內容主要介紹如何部署 Framework 到 CocoaPods。

準備 Framework

關于如何創建 Framework 網上的教程已經很多了,這里就不再贅述了。值得注意的是即使在 Release 模式下,運行 Xcode 都只能編譯出只支持真機或者模擬器的版本。

可通過以下兩種方式集成全平臺(Universal)版本。

手動合成

先編譯出模擬器和真機的 Framework,用以下命令合成全平臺包

lipo -create xxx/sdk-device xxx/sdk-simulator -output sdk-universal

lipo -info sdk-universal可查看支持的構架,如果為 i386, x86_64, armv7, arm64 即代表全平臺支持。

注:armv7s 是 iPhone 5 的 CPU 構架,因為設備具有向下兼容的特性,所以只需包含 armv7 即可,還能減小 fat 包的大小 :)

自動合成

Xcode 新建 Target 選擇 Cross-platform 分類中的 Aggregate, 添加依賴和腳本后能夠編譯全平臺的 Framework。

Aggregate.jpg

具體可以參考這里

部署 Framework

Framework 制作完成后,將其壓縮成 zip 包,并部署到能夠公開訪問的服務器上。可以放到自己的服務器,或者第三方服務器上,比如 GitHub release、又拍云等。只要最終能通過部署的 URL 下載該 zip 包即可。

制作 podsepc 文件

為了方便介紹將 Framework 名稱取為: MyLib

在 framework 的工程目錄下,執行 pod spec create MyLib創建 spec 文件。該目錄下會生成一個 MyLib.podspec 文件。vi MyLib.podspec查看,每一行都對應有具體的解釋。對每個條目有大致了解之后,填寫好信息,刪除所有 #注釋的內容,類似于這樣:

Pod::Spec.new do |s|
  s.authors      = "Tencent"
  s.name         = "Bugly"
  s.version      = "2.4.0"
  s.summary      = "Bugly iOS SDK"
  s.description  = "iOS library for Bugly Crash Report Service"
  s.homepage     = "http://bugly.qq.com/"
  s.license      = { :type => "Commercial", :text => "?2016 Tencent.com"}
  s.author       = { "Tencent" => "bugly@tencent.com" }
  s.source       = { :http => "http://softfile.3g.qq.com/myapp/buglysdk/Bugly-2.4.0.zip" }
  s.requires_arc = true  
  s.ios.deployment_target = '8.0'
  s.vendored_frameworks ='Bugly.framework'
  s.dependency 'Alamofire', '~> 1.0.0'
  end

詳細的介紹可以參考這里,需要注意幾點:

  1. s.version代表發布的 Framework 版本號,每次更新遞增修改。
  2. s.source字段替換成前面的 zip 地址。
  3. s.vendored_frameworks改為自己 Framework 的名稱。
  4. s.dependency代表依賴其它的庫。

至此 spec 文件制作完畢,使用 pod lib lint 命令驗證文件格式的正確性。

Framework 必須同時支持模擬器和真機否則會驗證不通過。

提交 podspec 文件

提交 podspec,需要先注冊一個 trunk 賬戶(如果提示網絡失敗,請使用梯子)

pod trunk register youremail@gmail.com 'Xiaofei Jiang' --description='macbook pro' --verbose

上面的命令郵箱和用戶名需要替換成你自己的。

注冊后 CocoaPods 會給你的郵箱發送驗證鏈接,點擊后就注冊成功了,可以用 pod trunk me 命令查看自己的注冊信息。

在提交 spec 文件前,如果發布的是 Swift 框架,需要指定 Swift 的版本,否則會報錯,執行 echo "4.0" > .swift-version 即可指定版本為 4.0

最后,執行 pod trunk push MyLib.podspec提交 spec 文件到 Cocoapods。在后面附加 --verbose 可查看詳細的進度。如果運氣好沒有報錯的話就代表部署成功啦。

pod search MyLib搜索是否有剛剛提交的版本,如果沒有,執行 rm ~/Library/Caches/CocoaPods/search_index.json刪除緩存索引再嘗試。

現在可以跟其他的第三方庫一樣,在 Podfile 文件中加入 「pod MyLib」,終端執行 pod update集成。

原理

整個過程看起來非常的簡單,僅圍繞著一個 spec 文件。那這個文件是干嘛用的呢?push trunk 又做了什么事情?

在安裝 Cocoapods 的時候,會從 GitHub clone 一個倉庫到本地目錄 ~/.cocoapods/repos/master,該倉庫維護這所有提交到 CocoaPods 的 spec 文件。

在執行 pod install時,就是從這個目錄下找到 Podflie 中指定版本的第三方庫的 spec 文件,并根據該文件中 s.source 字段為索引,找到真正的第三方庫地址。

如果該地址存的是源代碼,pod 會將代碼下載下來添加到 Pods.xcodeproj 編譯成 Framework,生成一個 target,并將這個 target 作為 Pod-xxx.framework 的依賴包。如果是 zip 包,則下載完成后直接解壓,加入 Pods 工程。下載的源代碼或者 zip 包會緩存在 ~/Library/Caches/CocoaPods目錄下,如果版本沒有更新的,下次 install 會直接從緩存獲取。

對于安裝 pods 的用戶來說,spec 文件是安裝第三方庫的索引,它對使用者來說是透明的,只需關注 Podfile 文件即可。

對于 pod 的提供者,就需要提交 spec 文件給 CocoaPods,執行pod trunk push時,會先進行 pod lib lint驗證。該驗證過程會創建一個臨時的工程文件,并使用這個 spec 文件,為其安裝 pod 依賴,其實就是 pod install 的過程,如果能夠編譯鏈接成功,代表 spec 文件驗證通過。詳細的過程都可以在命令后面附加 --verbose 查看。

驗證通過后的 spec 文件會 post 到 Trunk 服務器,Trunk 服務是 Cocoapods 團隊開發的,每個人都可以在自己的賬戶下發布 pod,其他人沒有權限修改。spec 以前以 ruby 的格式存儲,現在以 json 的格式保存在 trunk 服務器上,并同步更新到 GitHub。

pod_trunk.png

全文完。

參考鏈接:
WWDC2014之iOS使用動態庫
How to Create a Framework for iOS
Publish Your Pods on CocoaPods with Trunk
Getting setup with Trunk
CocoaPods Trunk
Cocoapods

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容