美文网首页
项目模块化处理之Cocoapods 私有库管理

项目模块化处理之Cocoapods 私有库管理

作者: 云智真人 | 来源:发表于2016-08-09 15:36 被阅读1483次

    以前搞过私有库,但太长时间过去了,脑子难免出现短路的情况。
    正好最近项目要搞,记录下方便以后查看。

    为什么要搞私有库?###

    随着项目功能的增加,不同产品需要根据不同功能模块组合,每次重复改代码太麻烦了,工作量还大,查了些资料就有了几种方案。。
    1. 在项目里面创建多个工程,每个功能模块用独立的工程管理。(当项目很大的时候,编译需要很多时间的时候,推荐用单独工程管理项目)
    2. 在项目里创建多个静态库,每个功能模块开发后打成静态库。(PS:每次修改都要重新打静态库,太麻烦了)
    3. 习惯把每个功能单独搞到一个文件夹的,可以直接用文件夹管理。(PS:我以前做企业级就这么搞的)
    4. git submodules管理公共类模块。
    5. Cocoapods的私有库管理。(PS:好东西都要留到最后啊。以前每次添加库的时候还要先看依赖哪些框架,添加framework引用,好麻烦的说,用过pod管理第三方的童鞋都知道,用着非常爽,一个Podfile文件,填下轮子地址执行下install就搞定了,创建私有库以后也可以用一个Podfile管理了)

    如何创建一个私有库?###

    1. 给模块项目打一个tag####

    因为配置pod信息的时候可以用tag指定版本号

    # 打tag
    git tag -m "New tag" '0.1'
    # 把tag推到远程仓库
    git push --tags
    

    2. 拉取项目(私有仓)到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
    

    3. 到要上传文件的项目里创建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 // 这个也可以验证
    

    5. 提交代码####

    # 提交代码
    git commit -a -m "PodTest 0.1"
    # 将本地的master分支推送到远程仓库
    git push origin master
    

    6. 创建一个trunk账号(用于上传到公共库Cocoapods)####

    $ sudo gem install cocoapods // 先更新下Cocoapods版本
    $ pod trunk register 邮箱 '昵称' --verbose // 填写账号信息,注册完要去邮箱点一个验证邮件(邮箱最好和git的邮箱保持一致)
    $ pod trunk me // 验证完成后可以查看账号信息
    

    7. 提交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
    

    8. 使用库####

    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是用于找到仓库的

    9. 删除一个私有库####

    $ pod repo remove NNASpec
    

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

    $ pod repo add NNASpec git@coding.net:Leben-NNA/NNASpec.git
    

    鸣谢####

    老贾东东在百忙之中chou's帮忙校对😊

    相关文章

      网友评论

          本文标题:项目模块化处理之Cocoapods 私有库管理

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