Cocoapods是什么?
CocoaPods是一个用来帮助我们管理第三方依赖库的工具,用它可以解决库与库的依赖,下载库的源代码,同时通过创建一个Xcode的workspace来将这些三方库和我们的工程连接起来,供我们开发使用。使用CocoaPods的目的是让我们能自动化的、集中的、直观的管理第三方开源库。
最近闲来无事,想制作自己的一个框架上传到cocoapods,但是确没有制作成可以通过pods导入的库,此乃一大憾事,后来跟着网上很多教程在那里捣鼓了半天,真的是半天时间,压根没用,今天无意间看到一篇博客,http://www.jianshu.com/p/489520b69d8b,参考了一下,有用,但并不是最正确的,里面有许多你不知道的坑等着你在跳,按照上面的步骤,基本和我以前看的一样,最后还是不行,经过1天的摸索,根据一些报错来查找原因,最后终于解决了这个问题,下面是博主刚刚创建的库:
在看这个功能之前,确定你会上传自己的项目代码到github,不会的可以看一遍文章,非常的详细[http://blog.csdn.net/codingfire/article/details/50387183 ] 下来来介绍一下如何吧自己的库制作成可以通过pod导入的库。
- 用户名邮箱注册,为github的用户名和绑定邮箱:
pod trunk register 你的邮箱 '用户名' --verbose
如果报错,一般是pod版本低或者ruby的版本低,这里不再说明解决办法,自行百度。
注册之后你会搜到一封邮件,点击链接激活即可。
2.查看是否注册成功
pod trunk me
这样的就代表已经注册成功。
- 创建 .podspec 文件
1).$ cd 到当前文件目录下
2). $ pod spec create 你的podsepc文件名
之后文件里就会出现一个 xx.podspec 文件,通过 Xcode 或者 Sublime 来打开编辑,如下:
由于只是演练,因为这里没有第三方库和系统库的引用,博主就把一些没用的删除掉了,留下一些基本的。
- 设置 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
这里会多一个 版本记录了。
- 验证编辑是否通过
$ pod lib lint SunImageTouchEvents.podspec --allow-warnings
通过之后你可以看到这个 xxxxxx passed validation
在验证通过后我们需要将代码提交到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'
相信我们第一步做好之后 不会出现这样的报错的。
当你看到这里,大功告成。
赶紧 $ 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