美文网首页
cocoaPods(提交自有库到pod,创建私有库)

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

作者: 曹波波 | 来源:发表于2017-11-16 13:16 被阅读187次

    CocoaPods Mac App的安装和使用

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

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

    提交自己的iOS库到pod

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

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

    $ pod trunk me
    
    屏幕快照 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).

    屏幕快照 2018-04-19 上午10.53.14.png

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

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

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

    这样就验证通过了:


    屏幕快照 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字段的类库。


    屏幕快照 2018-04-19 上午11.17.54.png

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

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

    相关文章

      网友评论

          本文标题:cocoaPods(提交自有库到pod,创建私有库)

          本文链接:https://www.haomeiwen.com/subject/amslvxtx.html