简介
在开发过程中,经常会使用到第三框架,我们通过一个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