
一、前言
这两天被cocoapods折磨的心力憔悴。看cocoapods官网的添加支持,但是介绍的(ying)比(yu)较(tai)简(cha)单,而且有的步骤也没有写上,导致看着官方文档也没有成功,后来查阅了简书、cocoachina等等,还是已经接近崩溃。没有一个完整的介绍。索性多个文档对比测试,最后终于成功的让自己github上的库成功支持cocoapods安装。
二、开始
这里我将从最初的开始进行介绍,包括github上创建项目已经上传项目,到最后的支持cocoapods。
步骤如下:
代码上传github
创建podspec文件,并验证是否通过
在github上创建release版本
注册cocoapods账号
上传代码到cocoapods
检查上传是否成功
1 代码上传github
首先我们打开github.com,然后创建自己的项目工程:
这里注意那个mit license,在后面添加cocoapods支持的时候会用到(稍后介绍)。然后点击创建即可。
然后用soucetree将代码down到本地,将自己的项目放到里面,文件夹如图所示:
这里的license就是刚才说的mit license添加的文件。rsademo是示例工程,zgrsaencryptor就是提供给他人使用的库。(zgencrptor(for java).zip是后端的代码)
然后提交到github就可以了。
2创建podspec文件
我们使用终端到工程目录下:
然后执行下面的命令:
这里的zgrsaencryptor就是pod添加市的名字(例如mbprogresshud)。执行完后的结果:
此时在工程文件夹下也会多一个zgrsaencryptor.podspec文件。这里我用sublime text打开并做了如下编辑:
name:类库的名称这里字段介绍如下:
version:库的版本
summary就是介绍语,就是:
homtepage:github上项目地址
license:许可证
author:作者
source:项目的https链接地址
source_files:要共享的代码,这里是zgrsaencryptor下面的所有代码。
接下来执行下面的命令进行验证:
结果多种多样,如果有错,则按照提示进行改错即可。在这里,我执行的结果如下图:
发现了多个警告,只要不是错误就行,警告可以直接忽略(红色也提示如何忽略):
结果如下:
当看到zgrsaencryptor passed validation之后,就说明验证通过了。
3 在github上创建release版本
打开项目的目录,然后创建release版本的类库:
点击 箭头指向开始创建release版本,(点击 create a new release):
点击publish release即可。创建完成后如图所示:
这样第三步就完成了
4 注册cocoapods账号
执行命令行:
执行完之后结果如下:
黄色提示已经发送了一个验证码到邮箱,你可以打开你的邮箱验证即可。打开邮件中的链接后如下:
这样就成功注册了cocoapods账号。
可以用
检查是否创建成功。成功的结果如下:
5 上传代码到cocoapods
首先检测文件格式的有效性:
结果如下:
没有错误,但是有警告。可以使用 —allow-warnings忽略:
出现passed validation就说明通过验证了。然后执行:
执行结果如下:(速度应该有的慢)
说明了已经上传成功。
6 检查上传是否成功
使用
ok,已经成功了。这样就可以让其他人进行搜索使用了。
三、总结
百度、google了多篇文档,然后进行总结,终于实现了构建自己的cocoapods库。在后面我将会继续学习怎么在本地进行构建、怎么在公司多人开发的时候进行构建私有库开发。
四、参考文档: