cocoaPods(提交自有库到pod,创建私有库)

CocoaPods Mac App的安装和使用

CocoaPods桌面应用版下载地址:https://cocoapods.org/app

打开应用会提示你是否安装命令行工具,选择install就也可以在命令行使用Pod了。省去了上面的步骤们,方便快捷的使用CocoaPods。

提交自己的iOS库到pod

1)首先我们注册trunk
$ pod trunk register 邮箱地址 'xxx(用户名)'  --verbose

填写github的账号邮箱就可以了,成功后你应该会收到一封邮件然后点进去就可以了,然后查看下你的注册信息

$ pod trunk me
cocoaPods(提交自有库到pod,创建私有库)_第1张图片
屏幕快照 2018-04-19 上午10.33.17.png
2)接下来就是配置PodSpec文件

podSpec文件是用来让cocoa pod知道你的库的位置,以及作者信息想要加入cocoapod这是关键。

因此,需要将想要传到pod 上的库先上传到github,或者其他可以访问到的git服务地址。(个人建议使用github,比较稳定,也有可持续性。另外个人还见过上传到SVN上的,这里不做介绍)。

配置PodSpec文件比较麻烦,建议直接拷贝下面的然后改参数(包括格式空格),或者从其他库拷贝一份修改参数,主要修改的是以下参数:

  • s.name 这个一定要和你的库名字一样
  • s.version 这个是你的github工程tag对应的版本号
  • s.summary 是一句话描述库
  • s.description 详细描述
  • s.homepage 这个要改为你github的地址
  • s.license 这个一般填写MIT License LICENSE这个文件是在github上创建工程的时候勾选的
  • s.requires_arc = true 是否ARC
  • s.author 作者,建议直接复制过去然后改名字
  • s.source = github上的地址以及tag(tag不能错)
  • s.source_files = 库文件路径
  • s.frameworks 所需要依赖的库

PS .Spec文件一定要用终端(vim)编辑,千万不能改为txt文件编辑完成后再改回去。这样会照成里面内容变成中文,会出现格式不对的报错
文件示例:
https://github.com/caobo56/CBImagePicker/blob/master/CBImagePicker.podspec

然cd 到当前文件目录 执行pod lib lint 检查:

$ pod lib lint CBBase58.podspec

当然检查的时候可以加上--verbose,来显示检查编译的详细信息

$ pod spec lint CBBase58.podspec --verbose

检查报错:
1)依赖错误

  • ERROR | [iOS] unknown: Encountered an unknown error (The 'Pods-App' target has transitive dependencies that include static binaries: (/private/var/folders/_r/rtmkt9590l7gkq8zscryyqz80000gn/T/CocoaPods-Lint-20180419-3650-1tkys6n-CBBase58/Pods/OpenSSL-Universal/lib-ios/libcrypto.a and /private/var/folders/_r/rtmkt9590l7gkq8zscryyqz80000gn/T/CocoaPods-Lint-20180419-3650-1tkys6n-CBBase58/Pods/OpenSSL-Universal/lib-ios/libssl.a)) during validation.

这个错误是因为依赖库(s.dependency)包含了.a静态库造成的。虽然这并不影响Pod的使用,但是验证是无法通过的。可以通过 --use-libraries 来让验证通过。

$ pod spec lint CBBase58.podspec --verbose --use-libraries

2)警告错误

[!] The spec did not pass validation, due to 5 warnings (but you can use --allow-warnings to ignore them).

cocoaPods(提交自有库到pod,创建私有库)_第2张图片
屏幕快照 2018-04-19 上午10.53.14.png

警告同样是无法通过验证的。这时可以用 --allow-warnings 来允许警告。

$ pod spec lint CBBase58.podspec --verbose --use-libraries --allow-warnings

3)其他错误
如果错误发生在 .podspec 中。当修改完时,不需要再次提交就可以直接验证。如果错误发生在代码中,则需要再次提交并修改tag才能验证。

这样就验证通过了:


cocoaPods(提交自有库到pod,创建私有库)_第3张图片
屏幕快照 2018-04-19 上午10.56.19.png

3)上传库到pod

$ pod trunk push CBBase58.podspec --verbose --use-libraries --allow-warnings
屏幕快照 2018-04-19 上午11.04.32.png

4)在pod 上查找自己上传的库

$ pod search CBBase58

一般上传完成直接search是查不到的,可以执行一到两次pod update,更新一下pod在本地的索引,就可以了。

5)更新本地pod索引库

执行pod setup其实在你安装CocoaPods执行pod install时,系统会默认操作pod setup,然而由于中国强大的墙可能会pod setup不成功。这时就需要手动执行pod setup指令,如下:

$ pod setup

会出现Setting up CocoaPods master repo,稍等几十秒,最底下会输出Setup completed。说明执行pod setup成功。

如果pod search操作还是搜索失败,则需要删除~/Library/Caches/CocoaPods目录下的search_index.json文件
pod setup成功后,依然不能pod search,是因为之前你执行pod search生成了search_index.json,此时需要删掉。

$ rm ~/Library/Caches/CocoaPods/search_index.json

删除成功后,再执行pod search。
终端输入:

$ pod search CBBase58(不区分大小写)

输出:Creating search index for spec repo ‘master’.. Done!,稍等片刻······就会出现所有带有CBBase58字段的类库。


cocoaPods(提交自有库到pod,创建私有库)_第4张图片
屏幕快照 2018-04-19 上午11.17.54.png

使用CocoaPods创建私有Spec Repo管理项目公共组件

创建私有Spec Repo ,下面这篇文章讲的已经很详细了,参考即可
http://www.cocoachina.com/ios/20170728/20046.html

你可能感兴趣的:(cocoaPods(提交自有库到pod,创建私有库))