美文网首页
使用CocoaPods上传自己的依赖库

使用CocoaPods上传自己的依赖库

作者: 相思的忆 | 来源:发表于2017-08-12 11:26 被阅读0次

    创建一个Git项目

    项目内容

    • 项目文件
    • YourProjectName.podspec文件(CocoaPods配置文件)
      文件创建:使用终端命令
    pod spec create [YourProjectName|ProjectUrl] 
    

    例:

    pod spec create YourProjectName|https://git.coding.net/User/YourProject.git
    

    创建podspec文件,使用命令

    chmod +x YourProjectName.podspec
    

    将文件转换成 Unix executable 文件

    文件内容:

    Pod::Spec.new do |s|
      s.name = 'YourProjectName'
      s.version = '1.0.0'
      s.license = 'MIT'
      s.summary = 'Project Summary'
      s.homepage = 'https://www.baidu.com'
      s.social_media_url = 'https://www.baidu.com'
      s.authors = { 'YourName' => 'yourname@qq.com' }
      s.source = { :git => 'https://git.coding.net/User/YourProject.git', :tag => s.version }
    
      s.ios.deployment_target = '9.0'
    
      # 指定你的三方文件(使用通配符,建议拿其他三方库的文件进行修改)
      s.source_files = 'YourProject/*.swift'
      s.dependency 'AFNetworking', '~> 2.3'   #依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
    end
    

    该文件中 s.version 指定的版本号需要在Git上添加tag标记,该标记是给版本指定项目分支(如果没有添加或者格式错误,上传和获取的时候会产生branch错误)

    • .swift-version文件(项目Swift版本说明文件,CocoaPods默认Swift版本是3.0)
      文件内容:Swift版本号。例:
    3.1
    
    • LICENSE文件(该文件是版权说明文件,不提供该文件CocoaPods不会帮你自动配置项目)
      文件创建:使用终端命令
    vim LICENSE
    

    创建文本文件(文件名:LICENSE),使用命令

    chmod +x LICENSE
    

    将文件转换成 Unix executable 文件

    文件内容:授权说明。例:

    Copyright © 2017年 YourName. All rights reserved. 
    other info...
    

    私有三方库

    当创建了一个Git项目后,就有了一个私有的三方库,可直接在Podfile文件中添加代码

     pod 'YourProjectName', :git => ' https://git.coding.net/User/YourProject.git'
    

    然后

    pod install
    或
    pod update
    

    公有三方库

    Trunk

    以上的方法,使用 pod search 是搜不到你的库的,因为这只是你私有的库而已。在你本地,前往~/.cocoapods/repos/master/Specs,你会看到CocoaPods所有公有的开源库配置,这个通过cocoapod官方在github的specs来管理,地址为https://github.com/CocoaPods/Specs 。说到这里,你会想把这个库fork分支下来,clone到你本地,把自己的YourProjectName.podspec加入,然后add、commit、 push,最后在github上pull request来和官方的主分支合并,可是你会发现请求马上被自动关闭。WHY!!!!!! 虽然一开始使用GitHub Pull Requests来整理所有公共pods效果很好。但是,随着Pod数量的增加,这个工作对于spec维护人员Keith Smiley来说变得十分繁杂。甚至一些没有通过$ pod lint的spec也被提交上来,造成repo无法build。 CocoaPods 0.33中加入了Trunk服务。CocoaPods Trunk服务的引入,解决了很多类似的问题。CocoaPods作为一个集中式的服务,使得分析和统计平台数据变得十分方便。下面来说说怎么分布CocoaPod。

    使用Trunk服务

    1. 注册电脑
      使用podspec文件中的邮箱和用户名进行注册
    pod trunk register youremail@qq.com 'yourname'
    

    成功后你会收到一份邮件,需要点击验证。

    可以使用 pod trunk me 查看自己的注册信息

    1. 可以使用 pod trunk add-owner otheremail@qq.com 添加其他维护者

    2. 提交podspec文件

    pod trunk push YourProjectName.podspec
    

    在提交之前你可以使用 pod spec lint YourProjectName.podspec 验证你本地的podspec文件(是否有错误)
    如果验证成功的话会显示

    YourProjectName.podspec passed validation.

    但你收到类似消息,如:

    [!] /usr/bin/git clone https://github.com/User/YourProject.git /var/folders/z2/h6c1f1hj72b6p5y3dhgjd27c0000gn/T/d20150827-4039-1ujw0u9 --single-branch --depth 1 --branch v1.0.0Cloning into '/var/folders/z2/h6c1f1hj72b6p5y3dhgjd27c0000gn/T/d20150827-4039-1ujw0u9'...
    warning: Could not find remote branch v1.0.0 to clone.
    fatal: Remote branch v1.0.0 not found in upstream originUnexpected end of command stream

    这是因为Git项目没有给分支添加tag标记或者tag标记格式错误
    如果错误提示是 branch v1.0.0,格式就是v+版本号
    如果错误提示是 branch 1.0.0,格式就是版本号

    等待部署成功。

    上面的代码做了三件事: *验证你的podspec文件是否合法。在trunk方式之前我们一般用“pod spec lint”命令进行验证。 *上传podspec文件到trunk服务器(其实最终也会自动添加到https://github.com/CocoaPods/Specs中,只是使用trunk方式省去了以前先fork在pull request的繁琐操作) *将你上传的podspec文件转成json格式文件
    执行上面的push操作,就相当于你把你的源代码提交给CocoaPods团队审核了,一般需要一到两个工作日可以审核结束。这种心情有点像提交App给Apple审核,哈哈。

    其实在这里就可以使用 pod 'YourProjectName' 来安装自己的CocoaPods依赖库,只是不能 pod search 到而已

    查看我们自己创建的pods依赖库 如果收到了cocoapods官方发过来的审核通过邮件后,你很急着用pod search命名肯定会失望,没收到,还记得我们本地的~/.cocoapods/repos/master/Specs吗,还没跟官方的github上的Specs同步, 执行一次
    pod setup
    或者
    pod update
    来更新本地缓存的Spec库,再去search就能看到了
    就能够用
    pod 'YourProjectName', '~> 1.0.0'
    这样去安装自己pod依赖库了 而.podspec文件也可以作为管理内部代码的利器
    pod 'Z', :path => 'path/to/directory/with/podspec'

    这里不要使用 pod install,这行命令不会更新本地的三方库列表

    参考: http://m.blog.csdn.net/bluefish89/article/details/48030941

    相关文章

      网友评论

          本文标题:使用CocoaPods上传自己的依赖库

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