美文网首页
iOS CocoaPods建立私有仓库

iOS CocoaPods建立私有仓库

作者: 小沫360 | 来源:发表于2016-12-11 19:33 被阅读592次

    CocoaPods建立私有仓库

    CocoaPods是iOS下的第三方包管理工具,有些不想开源的,或者复用的代码,我们可以创建一个私有仓库,通过CocoaPods来管理它们。

    如何创建一个私有库?

    1. 给模块项目打一个tag
      因为配置pod信息的时候可以用tag指定版本号
    打tag
    git tag -m "New tag" '0.1'
    把tag推到远程仓库
    git push --tags
    
    
    1. 拉取项目(私有仓)到pods管理目录下
      先在托管仓库(github,Coding等)创建一个私有仓(一个文件夹)
      这里我用的Coding托管的项目,至于为什么不用github(Coding私有库是免费的,墙内环境下访问速度超快,而且是中文的😊)
    pod repo add [私有项目名(repo库)] [clone地址]
    $ pod repo add NNASpec https://git.coding.net/Leben-NNA/NNASpec.git
    
    

    拉取完项目,会默认存在~/.cocoapods/repos这个目录下面,这里面有个master文件夹存的是缓存到本地的开源库的pods的.podspec.json格式配置信息,跟master同级你就会发现NNASpec(拉取的repo仓)的文件夹

    ~/.cocoapods/repos 大致目录结构

    ├── repos 
          └── NNASpec 
                 └── [VERSION] 
                         └── [SPEC_NAME].podspec
    
    1. 到要上传文件的项目里创建podspec配置文件
      这里要先到项目里(最好是readme,license文件同级)

    创建podspec文件

    $ pod spec create NNATree
    podspec创建也可以使用一个叫CocoaPods的Xcode插件生成
    创建好podspec文件以后,打开编辑会发现里面有很多参数需要配置,有很多注释信息说明参数作用
    这里就举个栗子:(下面是我填写的配置信息)
    注意:复制的时候删除后面的注释信息

    Pod::Spec.new do |s|
    
    s.name         = "NNATree" # 这里要跟上面创建的spec文件名一致
    s.version      = "0.1" # 这里使用之前的tag
    s.summary      = "Create a tree by tableview."
    s.homepage     = "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git"
    s.license      = "MIT"
    s.author       = { "Leben NNA" => "leben.nna@gmail.com" }
    s.platform     = :ios, "7.0"
    s.ios.deployment_target = "7.0"
    s.source       = { :git => "https://git.coding.net/Leben-NNA/NNAMultilevelTree.git", :tag => "0.1" } # 这里使用之前的tag
    s.source_files = 'MultilevelTree/*.{h,m}'
    s.framework    = "UIKit"
    s.requires_arc = true
    # s.dependency "AFNetworking", "~> 2.2.4"
    end
    
    

    一些参数的注释:

     name: 导入pod后的目录名
     version: 当前版本号
     deployment_target: 配置的target
     prefix_header_file: 预编译头文件路径,将该文件的内容插入到Pod的pch文件内
     source: 来源的具体路径,是http链接还是本地路径
     requires_arc: 是否需要arc
     source_files: 指定该目录下包含哪些文件
     其他可选参数还包括:
     dependency: 指定依赖,如果依赖的库不存在或者依赖库的版本不符合要求将会报错
     libraries: 指定导入的库,比如sqlite3
     frameworks: 指定导入的framework
     weak_frameworks: 弱链接,比如说一个项目同时兼容iOS6和iOS7,但某一个framework只在iOS7上有,这时候如果用强链接,那么在iOS7上运行就会crash,使用weak_frameworks可以避免这种情况。
     
    

    通配符说明:

    a{bb,bc}def.{h,m}表示四个文件abbdef.h abbdef.m abcdef.h abcdef.m
    *.{h,m,mm}表示所有的.h .m .mm文件
    Class/**/*.{h,m}表示Class目录下的所有.h .m文件
    4. 测试下podspec配置文件是否有错误
    $ pod lib lint // 验证是否有合格
    $ pod spec lint // 这个也可以验证
    
    
    1. 提交代码
    # 提交代码
    git commit -a -m "PodTest 0.1"
    # 将本地的master分支推送到远程仓库
    git push origin master
    
    
    1. 创建一个trunk账号(用于上传到公共库Cocoapods)
    $ sudo gem install cocoapods // 先更新下Cocoapods版本
    $ pod trunk register 邮箱 '昵称' --verbose // 填写账号信息,注册完要去邮箱点一个验证邮件(邮箱最好和git的邮箱保持一致)
    $ pod trunk me // 验证完成后可以查看账号信息
    
    
    1. 提交podspec到私有库
    # pod repo push [repo仓名] [podspec文件名]
    $ pod repo push NNASpec NNATree.podspec
    
    

    完成之后这个私有库就添加到我们的私有Spec Repo中,可以进入到~/.cocoapods/repos目录下查看
    同时远端仓里也完成了推送

    顺便把提交到cocoapods(公共库)的方法也提一句吧,前面的步骤都一样只需要用到上一步注册了的trunk提交就可以了

    # 提交podspec文件到trunk
    pod trunk push NNATree.podspec
    
    
    1. 使用库
      Podfile中填写
    source 'https://github.com/CocoaPods/Specs.git' // 公共库
    source 'https://git.coding.net/Leben-NNA/NNASpec.git' // 私有库
    platform :ios, '7.0'
    pod 'NNATree/Tree', '0.1' // 使用某一个部分
    pod 'NNATree', '0.1' // 使用整个库
    
    

    然后在终端输入账号密码就可以引入私有库了
    值得注意的一点:如果添加了私有库就需要加入source,默认是不需要添加的,source是用于找到仓库的,

    source公共库和私有库的顺序会影响查找顺序,假如公共库和私有库都有名字为AAA的轮子,如果公共库写在前面,就先在公共库中查找,如果找到了,就不会在私有库中找。

    1. 删除一个私有库
    $ pod repo remove NNASpec
    

    这样就从本地删除了
    当然我们还可以通过下面的代码添加回来

    $ pod repo add NNASpec git@coding.net:Leben-NNA/NNASpec.git
    
    
    1. 如果想删除私有Spec Repo下的某一个podspec,此时只需要cd到~/.cocoapods/repos/NNASpec目录下,删掉库目录
    $ rm -Rf NNATree
    
    

    然后再将git的变动push到远端仓库即可

    git add --all .
    
    git commit -m "remove unuseful pods" 
    
    git push origin master
    
    

    备注:本文抄袭自项目模块化处理之Cocoapods 私有库管理,略有删改。

    相关文章

      网友评论

          本文标题:iOS CocoaPods建立私有仓库

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