作为一个 iOS 开发者,Cocoapods 是我们再熟悉不过的了。pods 上有很多优秀的第三方库,一行代码就可以很方便地使用。既然它这么方便,我们何不上传自己的开源库上去跟大家分享呢?所以,这篇我们来学习下如何把自己的开源库上传到 Cocoapods 供其他 Developer 使用。
另外:如果你还不会使用 Cocoapods,推荐你看一看我的另一篇文章: cocoapods 第三方库管理工具
#Podspec 描述文件
假设你已经把项目开源到了 Git 上,记得打上 tag(这里是为了方便以后配置描述文件,不强制,但是强烈建议这样做)。
通过下面的命令生成一个 spec 文件:
- pod spec create ZXDatePicker
** 注意:** 这个描述文件放在哪里都可以不必放在 git 库中上传
这个文件的主要内容就在下面:
- Pod::Spec.new do |s|
- s.name = "ZXDatePicker"
- #name:"你的库的名字"
- s.version = "0.0.6"
- #s.version: "版本号tag"
- s.summary = "A sample datePicker."
- #s.summary : "该开源库的简单介绍描述"
- s.homepage = "https://github.com/Goyakod/ZXDatePicker"
- #s.homepage: "你的git主页"
- s.license = "MIT"
- #s.license : "MIT许可"
- s.author = { "Goyakod" => "111111111@qq.com" }
- #s.author : { "yourName" => "your email address" }
- s.source = { :git => "https://github.com/Goyakod/ZXDatePicker.git", :tag => "0.0.6" }
- #s.source : { :git => "开源库的git地址", :tag => "tag版本" }
- s.source_files = "ZXDatePicker/**/*.{h,m}"
- #s.source_files:"源文件路径"
- s.framework = "UIKit"
- #s.framework : "依赖的框架",如果依赖多个就用s.frameworks
- s.platform = :ios, "7.0"
- #s.platform :平台
- end
* 关于上面字段填写内容的注意事项:
1.MIT 许可证,其实就是一个 txt 文件,文本内容从 mit-license.org/ 里面拷贝模板更改年份和你的名字即可。 2.Sourcefile,这个路径一定要填写正确,这个地址取决于 spec 文件的当前位置。
### 验证描述文件 填完上面所有之后,执行命令:
- pod spec lint yourPodName.podspec
命令执行完看到 yourPodName passed validation. 就证明通过了验证。验证未通过会提示有几个 Error 几个 Warnings。仅有 Warnings 也是通过不了验证的,所以尽量把所有问题解决掉然后来验证。
验证通过后,去到 ~/.cocoapods/repos/master/Specs 目录下, 创建自己的库名的文件夹,里面是版本文件夹,放入对应的描述文件。
现在你在本机上搜索已经能够找到自己的库了。
#CocoaPods Trunk 发布 为了让别人也能搜到你的库,还需要进行发布。
### 注册 trunk 执行命令:
- pod trunk register youremail@qq.com 'your name'--description = 'description'
上面命令执行完之后你的邮箱会受到验证邮件,点击验证即可。
###trunk 发布 在包含有. podspec 的目录下执行命令:
- pod trunk push
该命令会首先验证你本地的 podspec 文件,之后会上传 spec 文件到 trunk,最后会将你上传的 podspec 文件转换为需要的 json 文件。当你在目录下看到 json 文件时就意味着你的库已经成功上传到了 pod 上。
#最后 如果你觉得本文还不错,请移步 本文案例 - ZXDatePicker 给个 star(不给我也不能拿你怎么样... 看心情吧)。
来源: https://juejin.im/post/5a36313d6fb9a0452405e8af