CocoaPods Mac App的安装和使用
CocoaPods桌面应用版下载地址:https://cocoapods.org/app
打开应用会提示你是否安装命令行工具,选择install就也可以在命令行使用Pod了。省去了上面的步骤们,方便快捷的使用CocoaPods。
提交自己的iOS库到pod
1)首先我们注册trunk
$ pod trunk register 邮箱地址 'xxx(用户名)' --verbose
填写github的账号邮箱就可以了,成功后你应该会收到一封邮件然后点进去就可以了,然后查看下你的注册信息
$ pod trunk me
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).
警告同样是无法通过验证的。这时可以用 --allow-warnings 来允许警告。
$ pod spec lint CBBase58.podspec --verbose --use-libraries --allow-warnings
3)其他错误
如果错误发生在 .podspec 中。当修改完时,不需要再次提交就可以直接验证。如果错误发生在代码中,则需要再次提交并修改tag才能验证。
这样就验证通过了:
3)上传库到pod
$ pod trunk push CBBase58.podspec --verbose --use-libraries --allow-warnings
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创建私有Spec Repo管理项目公共组件
创建私有Spec Repo ,下面这篇文章讲的已经很详细了,参考即可
http://www.cocoachina.com/ios/20170728/20046.html