简介
该文章我会通过一个LPProgressHUD的开源框架来讲解整个发布过程。
发布开源框架到CocoaPods
1.把项目发布到Github,并且打上tag。
Git相关操作这里就不在赘述了,如果有什么问题可以参照【Git一个先进的分布式版本控制系统】
2.创建.podspec描述文件:
$ pod spec create LPProgressHUD # 初始化一个Podspec文件。注意:将LPProgressHUD替换成你自己的项目名
#注意:该命令需要在工程根目录中执行,它会生成一个LPProgressHUD.podspec文件。
3.了解.podspec文件(文件里已经有非常详细的注释了,这里就简单描述下)
Pod::Spec.new do |s|
#你的库名称
s.name = "LPProgressHUD"
#库原代码版本号
s.version = "1.0.1"
#对库的一个简单的介绍
s.summary = "LPProgressHUD is a Swift version of the HUD that mimics MBProgressHUD."
#声明库的主页,一般为github地址就行
s.homepage = "https://github.com/leo-lp/LPProgressHUD"
#采用的授权版本:一般为 MIT
s.license = "MIT"
#库的作者:{ "作者名" => "邮箱" }
s.author = { "leo-lp" => "lipengmjy@163.com" }
#库所支持的软件平台,这在我们最后提交进行编译时有用。
s.platform = :ios, "8.0"
#声明代码的地址,也就是你github上的地址
s.source = { :git => "https://github.com/leo-lp/LPProgressHUD.git", :tag => "#{s.version}" }
#库的源代码的路径
s.source_files = "LPProgressHUD/Sources/*.swift"
end
4.验证.podspec文件是否可用
$ pod spec lint LPProgressHUD.podspec
#注意:如果有任何warning或者error都是不可以的,它将不能被添加到`Spec Repo`中。如果验证通过会提示`LPProgressHUD passed validation.`
5.CocoaPods Trunk发布自己的Pods
(1)注册Trunk:
$ pod trunk register 你的邮箱 '你的用户名' --description='你的描述'
e.g.:
$ pod trunk register lipengmjy@163.com 'leo-lp' --description='LPProgressHUD de description.'
成功的话就会收到一份邮件,点击邮件中的链接后验证一下,之后再到终端输入以下命令:
$ pod trunk me
#成功的话会返回以下类似字段:
- Name: leo-lp
- Email: lipengmjy@163.com
- Since: June 16th, 3:58
- Pods: None
- Sessions:
- June 16th, 3:38 - July 22nd, 3:40. IP: 192.168.5.101
如果你的pod是由多人维护的,你也可以添加其他维护者:
$ pod trunk add-owner POD OWNER-EMAIL
e.g.:
$ pod trunk add-owner LPProgressHUD lipengmjy_123@163.com
(2)Trunk push
$ pod trunk push
#注意:该命令会首先验证你本地的podspec文件是否有错误,如果没有错误会上传spec文件到trunk,最后会将你上传的podspec文件转换为需要的json文件。
如果报错了,仔细查看一下错误信息。如果上传成功了,到此整个制作过程就完成了。
注意:以后有新版本只需要修改工程根目录下的.podspec文件,然后重新执行pod trunk push
命令。
6.补充:
如果pod trunk push
成功后无法pod search
到自己的库,可执行以下命令。
$ pod setup #更新pod库
如果pod setup
成功后还是无法pod search
到自己的库,可执行以下命令。
$ cd ~/Library/Caches/CocoaPods/ #进入CocoaPods的缓存文件夹
$ rm search_index.json #删除search_index.json文件
$ pod search LPProgressHUD #执行搜索命令,并重新生成search_index.json文件