簡介
在開發過程中,經常會使用到第三框架,我們通過一個pod install
命令,很方便的就將第三方框架加到我們自己的項目中。
如果我們也想將自己寫的組件或庫開源出去,讓別人也可以通過pod install
命令安裝自己的框架該怎么做呢?下面,我就教大家一步一步的將自己的pods
發布到CocoaPods
中。如果你現在對CocoaPods
還不太了解,推薦你看一看這篇文章:CocoaPods的安裝與使用
在 GitHub 上創建一個開源項目,項目中必須包含這幾個文件
-
LICENSE
:開源許可證 -
README.md
:倉庫說明 - 開源項目
-
cocoaPodsName.podspec
:CocoaPods
的描述文件,這個文件非常重要
下面就創建 CocoaPods
公有庫做一下分享:
在 github
上創建倉庫。
Paste_Image.png
備注:
-
github
倉庫的名稱,不允許重名。 -
LICENSE
:開源許可證,默認一般選擇MIT
。
創建 *.podspec 文件
使用命令行、sourceTree
或者 GitHub Mac
將項目克隆到本地,然后 cd
進入本地項目工程中,然后創建 *.podspec
文件。例如:
pod spec create cocoaPodsName;
Paste_Image.png
當 Specification created at cocoaPodsName.podspec
說明創建 *.podspec
文件成功,這時就會在你的本地項目工程中下生成 cocoaPodsName.podspec
文件。
編輯 *.podspec 文件
使用文本編輯器或者 sublime
等編輯 *.podspec
文件。
Paste_Image.png
備注:
1、s.name:公有庫的名稱。
2、s.version:公有庫的版本。
3、s.summary:公有庫簡短介紹。
4、s.description:公有庫詳細介紹。
5、s.homepage:公有庫在GitHub上的地址。
6、s.license:開源協議。
7、s.author:作者。
8、s.source:公有庫在GitHub上的地址和版本號。
9、s.source_files:公有庫對外共享的.h和.m文件。
10、s.requires_arc:是否支持ARC。
沒有涉及到的字段可以去官方文檔查閱。
驗證 *.podspec 文件
pod lib lint cocoaPodsName.podspec --allow-warnings --verbose
注意:
-
--allow-warnings
忽略開源項目工程里面的警告; -
--verbose
在控制臺查看詳細的信息。
驗證成功會出現:
-> cocoaPodsName (0.0.1)
cocoaPodsName passed validation.
發布 *.podspec
驗證有效后,然后再將本地項目工程中得所有文件 push
到 github
上。
git add .
git commit -m "first commit"
git remote add origin https://github.com/sunjinshuai/test.git
git push -u origin master
$ git tag -m "first release" 0.0.1
$ git push --tags #推送tag到遠端倉庫
向 CocoaPods
注冊賬戶信息,例如:
pod trunk register 郵箱 ‘用戶名’ --description=‘描述’
注意:
郵箱為github
上的登錄郵箱、用戶名為github
上的用戶名。
Paste_Image.png
接收發送到郵箱的鏈接,點擊進入后注冊成功。
Paste_Image.png
查看注冊的個人信息。
pod trunk me
Paste_Image.png
驗證發布到 cocoapods
上的公有倉庫是否有效。
pod spec lint cocoaPodsName.podspec --allow-warnings --verbose
發布自己的庫的 podspec
文件給 cocoapods
pod trunk push cocoaPodsName.podspec --allow-warnings --verbose
Paste_Image.png
大功告成,使用pod search cocoaPodsName
搜索即可。
Paste_Image.png