亲身经历一步步教你发布开源框架到cocoapods

Cocoapods是什么?

CocoaPods是一个用来帮助我们管理第三方依赖库的工具,用它可以解决库与库的依赖,下载库的源代码,同时通过创建一个Xcode的workspace来将这些三方库和我们的工程连接起来,供我们开发使用。使用CocoaPods的目的是让我们能自动化的、集中的、直观的管理第三方开源库。

最近闲来无事,想制作自己的一个框架上传到cocoapods,但是确没有制作成可以通过pods导入的库,此乃一大憾事,后来跟着网上很多教程在那里捣鼓了半天,真的是半天时间,压根没用,今天无意间看到一篇博客,http://www.jianshu.com/p/489520b69d8b,参考了一下,有用,但并不是最正确的,里面有许多你不知道的坑等着你在跳,按照上面的步骤,基本和我以前看的一样,最后还是不行,经过1天的摸索,根据一些报错来查找原因,最后终于解决了这个问题,下面是博主刚刚创建的库:

3D05B875-F973-4315-A1D2-BF621A7F43D3.png

在看这个功能之前,确定你会上传自己的项目代码到github,不会的可以看一遍文章,非常的详细[http://blog.csdn.net/codingfire/article/details/50387183 ] 下来来介绍一下如何吧自己的库制作成可以通过pod导入的库。

  1. 用户名邮箱注册,为github的用户名和绑定邮箱:

pod trunk register 你的邮箱 '用户名' --verbose

如果报错,一般是pod版本低或者ruby的版本低,这里不再说明解决办法,自行百度。
注册之后你会搜到一封邮件,点击链接激活即可。
2.查看是否注册成功

pod trunk me

查看是否注册成功.png

这样的就代表已经注册成功。

  1. 创建 .podspec 文件

1).$ cd 到当前文件目录下

2). $ pod spec create 你的podsepc文件名

之后文件里就会出现一个 xx.podspec 文件,通过 Xcode 或者 Sublime 来打开编辑,如下:


podspec描述文件.png

由于只是演练,因为这里没有第三方库和系统库的引用,博主就把一些没用的删除掉了,留下一些基本的。

  1. 设置 tag 版本号,然后推送到git

$ git tag 0.0.1 // tag 和上面你设定的一样 一般tag号和版本号一致
$ git push --tags
$ git push origin master
$ git status //查看文件状态 如果有红色的,说明未添加或修改了未见,需要执行
$ git add .
$git commit -m "说明"
这时候可以再次 git status 查看文件状态

之后查看GitHub


00F02CC2-F6CF-4538-85E8-11AFBAC73824.png

这里会多一个 版本记录了。

  1. 验证编辑是否通过

$ pod lib lint SunImageTouchEvents.podspec --allow-warnings

通过之后你可以看到这个 xxxxxx passed validation

08281916-3B69-4928-B29B-733746292C2F.png
说明我们的这个配置文件是没问题的。
在验证通过后我们需要将代码提交到cocoapods

$ pod trunk push 你的podspec名字.podspec --allow-warnings

如果代码编译不通过 也会报错,所以记得检查代码。
通过pod search "项目名"去搜索你的第三方库吧。

最后
将我们的gitHub仓库代码配置CocoPods支持的时候

如报错如下:
[!] You need to register a session first.
解决方案命令如下:
pod trunk register 电子邮箱 '您的姓名' --description='macbook pro'
相信我们第一步做好之后 不会出现这样的报错的。

当你看到这里,大功告成。


9D956C6D-172E-478E-807D-F443783C7D96.png

赶紧 $ pod search 试一试吧。

可能需要等一段时间,这里说不准 然后就可以 查询 和 pod install 了 ,当你还是搜索不到的时候, 清除本地搜索库的索引缓存就行了。

~/Library/Caches/CocoaPods/search_index.json

前往文件夹,删除之后再pod search XXX,就会重新生成search_index.json文件,这里重新生成json文件可能需要七八分钟的样子,然后就可以搜索的你自己的框架了。

总结:要把自己的库制作成通过pods导入还是有一定难度的,网上很多方法看着跟博主这里差不多,其实命令都一样,但是却有明显的不同,那就是细节部分,代码有报错,目录结构等等,稍有不慎就可能通不过编辑,就说这么多,如果遇到问题,欢迎讨论。

参考文章
http://blog.csdn.net/codingfire/article/details/52470802

推荐阅读更多精彩内容