iOS 私有库的创建(本地)

 iOS 组件化必经之路—创建私有库,这里记录一下创建过程,以及遇到的坑。
需要的知识点
  • it 相关指令
  • cocoaPod相关知识点(电脑正确安装了pod)
  • ssh Git配置多个SSH-Key
准备工作
  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,接下来通过该模板文件来制作我们自己的组件。

终端得到以下界面:


iOS 私有库的创建(本地)_第1张图片
image.png

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


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

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


    iOS 私有库的创建(本地)_第2张图片
    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、更改模板文件相关信息

iOS 私有库的创建(本地)_第3张图片
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           = { '刘磊' => '[email protected]' }
  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文件

iOS 私有库的创建(本地)_第4张图片
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)'

验证通过后的截图

iOS 私有库的创建(本地)_第5张图片
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

成功后的截图

iOS 私有库的创建(本地)_第6张图片
image.png

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

使用 验证

注意:podfile文件里要加上

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

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

iOS 私有库的创建(本地)_第7张图片
image.png

总结

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

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

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

你可能感兴趣的:(iOS 私有库的创建(本地))