CocoaPods開源庫的搭建

前言

如果你看了我之前寫的文章《CocoaPods私有庫的搭建》,而且有過實戰,你會發現《CocoaPods開源庫的搭建》簡單了很多。

文章目錄

一、寫好代碼,上傳到github

二、將自己的項目打tag;

三、注冊CocoaPods

四、創建.podspec;

五、編輯.podspec;

六、驗證.podspec

七、發布;

八、測試自己CocoaPods;

九、開源庫的使用;

具體步驟

一、寫好代碼,上傳到github

github上創建項目倉庫的時候記得創建LICENSE(許可證/授權)文件,此文件必須要有。

image

二、將自己的項目打tag;

因為CocoaPods是依賴tag版本的,所以必須打tag,終端命令如下:

git tag 1.0.0
git push --tags

注:以后再次更新自己的開源庫時,只需要把你的項目打一個tag,然后修改.podspec文件中的版本接著提交到CocoaPods官方就可以了,提交命令如上。

三、注冊CocoaPods

查看自己有沒有注冊過CocoaPods,終端命令如下:

pod trunk me

如果你已經注冊過,結果如下圖:

image

若未注冊,執行以下命令注冊:

// 注:郵箱和用戶名隨意
pod trunk register 郵箱 用戶名

// 加上--verbose可以輸出詳細的錯誤信息,方便出錯時查看
pod trunk register 郵箱 用戶名 --verbose

終端命令示例如下:

pod trunk register 821385843@qq.com 'Wade' --verbose

注冊完成之后會給你的郵箱發個郵件,進入郵箱郵件里面有個鏈接,需要點擊確認一下。注冊完成后使用pod trunk me檢驗注冊是否成功。

四、創建.podspec;

cd到本地項目目錄,執行終端命令,創建.podspec文件,終端命令:

pod spec create XWCountDownButton_OC
image

五、編輯.podspec;

創建好后,打開.podspec,前面有#的為注釋,也可以用以下代碼替換,然后編輯自己的庫信息。

  • s.name:名稱,pod search搜索的關鍵詞,注意這里一定要和.podspec的名稱一樣,否則報錯

  • s.version:版本號,to_s:返回一個字符串

  • s.author:作者

  • s.homepage:項目主頁地址

  • s.summary:項目簡介

  • s.source:項目源碼所在地址

  • s.license:許可證

  • s.platform:項目支持平臺

  • s.requires_arc:是否支持ARC

  • s.source_files:需要包含的源文件

  • s.public_header_files:需要包含的頭文件

  • s.ios.deployment_target:支持的pod最低版本

其他一些非必要字段

  • s.social_media_url:社交網址

  • s.resources:資源文件

  • s.dependency:依賴庫,不能依賴未發布的庫

  • s.vendored_frameworks = 'XXX/x.framework', 'XXX/y.framework'
    注:這是當前組件依賴的三方framework,示意圖如下:


  • s.license= { :type => "MIT", :file => "LICENSE" }
    注:這里建議這樣寫,如果寫別的會報警告,導致后面一直提交失敗。

source_files寫法及含義

"XXX/*"
"XXX/XXX/*.{h,m}"
"XXX/**/*.h"

* :表示匹配所有文件
*.{h,m} :表示匹配所有以.h.m結尾的文件
** :表示匹配所有子目錄

s.source常見寫法

s.source       = { :git => "https://github.com/821385843/XWCountDownButtonDemo.git", :tag => "68defea" }
s.source       = { :git => "https://github.com/821385843/XWCountDownButtonDemo.git", :tag => 1.0.0 }
s.source       = { :git => "https://github.com/821385843/XWCountDownButtonDemo.git", :tag => "#{s.version}" }
  • commit => "68defea" :表示將這個Pod版本與Git倉庫中某個commit綁定
  • tag => 1.0.0 :表示將這個Pod版本與Git倉庫中某個版本的comit綁定
  • tag => s.version :表示將這個Pod版本與Git倉庫中相同版本的comit綁定

六、驗證.podspec

到此檢查一下工程中有以下文件:

  • 項目文件

  • LICENSE

  • .podspec文件

測試本地.podspec文件是否存在語法錯誤,終端命令如下:

pod spec lint XWCountDownButton_OC.podspec

pod spec lint XWCountDownButton_OC.podspec --verbose

注:如果有警告驗證會通不過,需要使用命令忽略警告即可,終端命令如下:

pod spec lint XWCountDownButton_OC.podspec --allow-warnings

七、發布;

發布的終端命令如下:

pod trunk push XWCountDownButton_OC.podspec

注:如果有警告發布會通不過,需要使用命令忽略警告即可,終端命令如下:

pod trunk push XWCountDownButton_OC.podspec --allow-warnings

發布成功后會有以下提示:

八、測試自己CocoaPods;

使用pod search搜索的話會提示搜索不到,可以執行以下命令更新本地search_index.json文件,終端命令如下:

rm ~/Library/Caches/CocoaPods/search_index.json

然后

pod search XWCountDownButton_OC

搜索結果如下圖:


九、開源庫的使用;

新建測試項目(項目名稱為TestPod),在項目TestPod目錄下新建Podfile文件,編輯Podfile文件如下,使用pod install安裝之后即可使用作者開源的框架XWCountDownButton_OC了。

更多文章

CocoaPods開源庫的搭建
CocoaPods搭建私有庫
CocoaPods搭建私有庫遇到問題
CocoaPods私有庫的升級維護
SKStoreReviewController之程序內評價
App應用程序圖標的動態更換
開源框架 MGJRouter_Swift
iOS的MVP設計模式
iOS插件化
iOS FMDB的使用
Swift之ReactiveSwift
OC之ReactiveCocoa
OC之ReactiveCocoa進階
iOS 性能考慮

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

推薦閱讀更多精彩內容