美文网首页
用CocoaPods创建自己的Podspec供别人使用

用CocoaPods创建自己的Podspec供别人使用

作者: 曦琦 | 来源:发表于2016-10-13 14:16 被阅读0次

    创建Podspec

    首先在项目中创建一个Podspec

    
    $ pod spec create GQCategory
    
    

    编辑Podspec

    用上述命令创建好的Podspec会被填上默认的参数并有注释说明了每个参数的含义及用法,这里只介绍几个常用的参数

    Pod::Spec.new do |s|
      s.name         = "GQCategory"
      s.version      = "0.0.5"
      s.summary      = "常用的分类封装."
    
      
      s.description  = <<-DESC
                第一个podspec
                       DESC
    
      s.homepage     = "https://github.com/gqisabug/GQCategory"
      s.license      = { :type => "MIT", :file => "LICENSE" }
      s.author             = { "gqisabug" => "gqlyan419@163.com" }
      
      s.platform     = :ios, "7.0"
      s.source       = { :git => "https://github.com/gqisabug/GQCategory.git", :tag => s.version }
    
    ## 这里不支持ssh的地址,只支持HTTP和HTTPS,最好使用HTTPS
      ## 正常情况下我们会使用稳定的tag版本来访问,如果是在开发测试的时候,不需要发布release版本,直接指向git地址使用
      ## 待测试通过完成后我们再发布指定release版本,使用如下方式
      #s.source       = { :git => "http://EXAMPLE/O2View.git", :tag => version }
    
      s.source_files  = "GQCategory/GQCategory/**/*.{h,m}"
      s.requires_arc = true
    
    end
    

    s.name:名称,pod search 搜索的关键词
    s.version:版本
    s.summary:简介,pod search 搜索的关键词
    s.homepage:主页地址,例如Github地址
    s.license:许可证
    s.author:作者
    s.social_media_url:社交网址
    s.platform:平台
    s.source:Git仓库地址,例如在Github地址后边加上 .git 就是Git仓库地址,常见写法如下

    s.source = { :git => "仓库地址", :commit => "68defea" }
    s.source = { :git => "仓库地址", :tag => 1.0.0 }
    s.source = { :git => "仓库地址", :tag => s.version }
    
    • commit => "68defea" 表示将这个Pod版本与Git仓库中某个commit绑定
    • tag => 1.0.0 表示将这个Pod版本与Git仓库中某个版本的comit绑定
    • tag => s.version 表示将这个Pod版本与Git仓库中相同版本的comit绑定
    "Directory1/*"
    "Directory1/Directory2/*.{h,m}"
    "Directory1/**/*.h"
    
    • “*” 表示匹配所有文件
    • “*.{h,m}” 表示匹配所有以.h和.m结尾的文件
    • “**” 表示匹配所有子目录

    s.resources:需要包含的图片等资源文件
    s.dependency:依赖库,不能依赖未发布的
    s.dependency:依赖库,如有多个可以这样写
    s.requires_arc:是否要求ARC

    上传到git

    将编辑好的Podspec 上传到git并给这次更新打上tag并推送到仓库(需与文件里一致)

    • 创建标签
    $ git tag v1.0
    //标签默认是打在最新的commit上,如果想要给某个之前的操作打,可以先找到历史记录
    $ git log --pretty=oneline --abbrev-commit
    执行后输出如下
    6224937 add merge
    6224937是commit的id
    $ git tag v0.9 6224937
    就可以给add merge这个操作打上标签了
    
    • 查看所有标签
    $ git tag
    
    • 删除标签
    //删除本地的
    $ git tag -d v0.1
    //删除远程
    $ git push origin :refs/tags/v0.9
    
    • 推送标签到远程
    //推送一个
    $ git push origin v1.0
    //推送所有尚未被推送的本地标签
    $ git push origin --tags
    

    验证Podspec

    $ pod spec lint GQCategory.podspec
    //如果依赖库(s.dependency)包含了.a静态库,需要在后面加上--use-libraries
    //如果有警告,需要加上 --allow-warnings来忽略警告以通过验证
    //可以加上--verbose来查看错误
    

    发布Podspec

    需要先注册

    pod trunk register gqlyan419@163.com "gaoqi"
    

    注册成功后验证邮箱就可以发布自己的pod了

    pod trunk push GQCategory.podspec
    //这里也可以加上验证时的参数--allow-warnings 等
    

    版本升级

    修改 .podspec 中的 s.version 为更高的版本号,并修改 s.source 中对应的 Git 版本。提交到Git,并打上对应tag。然后再讲修改后的pod spec发布到Cocoapods就可以完成更新。
    -建议s.source采用

    s.source = { :git => "仓库地址", :tag => s.version }
    

    写法,这样就与s.version绑定了,每次更新只需要改版本号即可

    创建私有库

    //打开隐藏的命令:
    defaults write com.apple.finder AppleShowAllFiles -bool true
    //关闭隐藏的命令:
    defaults write com.apple.finder AppleShowAllFiles -bool false
    

    接着需要重启一下 Finder, 可以按住 option + 右键 Finder 图标选择重启。然后打开隐藏目录 .cocoapods (这个目录在你的个人目录底下, ~/.cocoapods 或 /Users/[username]/.cocoapods)

    1.创建一个私有的 Spec Repo

    在自己的私有git服务器(GitHub,Gitlab,Coding, Bitbucket等)上创建一个空的仓库。

    2.添加私有Spec Repo

    然后打开终端,输入命令行:

    pod repo add [本地Spec Repo名称][远程Spec Repo地址]
    

    例如:

    pod repo add MySpecs https://xxxxxxxxxxx/MySpecs.git
    

    这里的xxxxxxx就是自己的git地址。
    此时跳转到文件夹:repos。就是:

    ~/.cocoapods/repos/
    

    除了原来的master,会出现一个你自己的MySpecs: cd进去 执行:

    pod repo lint
    

    时间较长,耐心等待

    3.验证Podspec

    参考上面的步骤新建Podspec并验证成功后提交到仓库

    4.把要共享的库添加到私有Spec Repo中

    执行命令:
    pod repo push [本地Spec Repo名称][podspec文件路径] --allow-warnings
    例如:
    pod repo push MySpecs ~/本地路径.podspec --allow-warnings
    成功后能在你的MySpecs里面看到新加的库

    5.使用

    和原来的常规的使用cocoapods一样,不过需要在Podfile里面添加:

    source 'http://xxxxxxxxxxx/zhanggui/MySpecs.git' //你的私有库的地址
    source 'https://github.com/CocoaPods/Specs.git'  //原来的系统的地址
    

    相关文章

      网友评论

          本文标题:用CocoaPods创建自己的Podspec供别人使用

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