美文网首页
iOS 私有库的创建(本地)

iOS 私有库的创建(本地)

作者: 韧风透骨寒 | 来源:发表于2018-12-11 20:23 被阅读14次
     iOS 组件化必经之路—创建私有库,这里记录一下创建过程,以及遇到的坑。
    
    需要的知识点
    准备工作
      1、有一个私有代码仓库(github、gitlab、码云、腾讯云 )   
      2、创建两个私有项目(一个存放索引、另外一个存放源代码)
    

    一、创建私有库的索引库

    1、在码云中创建私有库的索引库(拷贝项目路径https://gitee.com/whityStyle/ZLRepo.git\给下一步使用备用)
    

    创建私有库的索引库,这句话有些绕口,我们分开来看:

    • 私有库:指的是我们真正放置组件代码的地方。
    • 索引库:存放spec文件的地方,用于索引到代码的位置。

    2、将创建的索引库添加到本地cocoapods仓库
     <1> cocoapods本地仓库路径(command + shift + G)
         $ ~/.cocoapods/repos 
     <2> 在本地添加一个自己的远程索引库(路径为上一步拷贝的项目路径)
         pod repo add ZLRepo https://gitee.com/whityStyle/ZLRepo.git
    

    这时候在~/.cocoapods/repos目录下会生成一个名为ZLRepo的文件夹,


    二、制作组件

    1、创建模版, 在指定的目录下(最好固定方便以后修改)

      $ cd  ../../..指定的目录
      $ pod lib create ZLDemoTool
    

    通过该命令会自动创建一个模板工程,里面包含我们需要的索引文件,格式为spec,接下来通过该模板文件来制作我们自己的组件。

    终端得到以下界面:


    image.png

    这里会询问几个问题(答案根据实际情况设置),分别是:
    1、语言选择
    —— 教程选择Objc,如果要做Swift私有库,请选择输入Swift
    2、是不是需要一个demo项目工程
    ​ —— 教程选择Yes,需要创建一个demo工程,建议创建一个demo工程
    3、测试框架使用哪一个
    ​ —— 教程选择None
    4、是不是需要做基本的测试
    ​ —— 教程选择Yes
    5、类前缀是什么
    ​ —— 教程输入LAT


    2、将我们自己的组件放入指定目录

    • 将源码文件复制到文件夹路径:ZLDemoTool/ZLDemoTool/Classes下。
    • 资源文件放到Assets下。


      image.png

    模板文件中会看到一个Development pods的文件夹,这个文件夹代表的是本地的组件库,这里我们把Tool文件(也就是我们自己制作的组件)放在指定的文件夹,然后引入到工程中.
    至此,我们的本地第三方组件已经制作完成,现在可以通过在终端执行pod install看看效果了(cd 到example文件夹下)!当然,我们肯定不会局限于本地,接下来就是如何制作线上组件库了!


    3、将制作好的组件上传至码云
    在项目工程文件下执行git相关指令,发布到git。

        $ git remote add origin https://git.oschina.net/ZLDemoTool/ZLDemoTool.git
        $ git add .
        $ git commit -a -m "初始化"
        $ git pull origin master --allow-unrelated-histories
        $ git push origin master
    

    4、更改模板文件相关信息

    image.png

    我们打开Xcode工程,找到.podspec后缀的文件,更改s.summary,这个是显示在pod search的简短描述,s.version是版本号,我这里修改为0.0.1,下面再主要修改一个s.homepage和s.source中的地址为我们创建组件仓库的地址即可!

    #
    # Be sure to run `pod lib lint ZLDemoTool.podspec' to ensure this is a
    # valid spec before submitting.
    #
    # Any lines starting with a # are optional, but their use is encouraged
    # To learn more about a Podspec see https://guides.cocoapods.org/syntax/podspec.html
    #
    
    Pod::Spec.new do |s|
      s.name             = 'ZLDemoTool'
      s.version          = '0.0.1'
      s.summary          = 'ZLDemoTool use desc.'
      s.description      = <<-DESC
    TODO: ZLDemoTool use desc.
                           DESC
    
      s.homepage         = 'https://gitee.com/whityStyle'
      s.license          = { :type => 'MIT', :file => 'LICENSE' }
      s.author           = { '刘磊' => 'liulei10luojia@163.com' }
      s.source           = { :git => 'https://gitee.com/whityStyle/ZLDemoTool.git', :tag => s.version.to_s }
    
      s.ios.deployment_target = '8.0'
    
      s.source_files = 'ZLDemoTool/Classes/**/*'
      # s.public_header_files = 'Pod/Classes/**/*.h'
      s.frameworks = 'UIKit'
    
    end
    
    

    5、验证spec文件

    image.png
    $ pod lib lint  --private
    如果出现警告,可以将 
    s.homepage   = '[https://gitee.com/Qinz_323/Tool](https://gitee.com/Qinz_323/Tool)'
    改为
    s.homepage   = '[https://gitee.com/Qinz_323](https://gitee.com/Qinz_323)'
    

    验证通过后的截图

    image.png

    6、将修改的.podspec文件上传到码云

      $ git commit -a -m " 注释"
      $ git push origin master
    

    7、给版本打一个分支
    此处的0.0.1版本号要与spec文件的保持一致

      $ git tag 0.0.1
      $ git push  --tags
    

    三、建立关联

      在项目的根目录下操作
      $ pod repo push ZLRepo ZLDemoTool.podspe
    

    成功后的截图

    image.png

    通过这一步我们就同步好了远程和本地索引库,到此,私有库已经制作完毕!

    使用 验证

    注意:podfile文件里要加上

    source 'https://github.com/CocoaPods/Specs.git'
    source 'https://gitee.com/whityStyle/ZLDemoTool.git'
    

    配置
    如果你不配置系统的索引库 会找不到其他的库 只能找到你自己创建的仓库

    image.png

    总结

    • 私有库:是我们真正放置组件代码的地方。
    • 索引库:存放spec文件的地方,用于索引到代码的位置。

    由于未保存截图,引用了部分其他截图(后续会补全所有源截图),如发现有问题,可共同交流

    参考:侵立删
    有gif
    流程疏离
    trunk的注册使用发布

    相关文章

      网友评论

          本文标题:iOS 私有库的创建(本地)

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