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,接下来通过该模板文件来制作我们自己的组件。
终端得到以下界面:
这里会询问几个问题(答案根据实际情况设置),分别是:
1、语言选择
—— 教程选择Objc,如果要做Swift私有库,请选择输入Swift
2、是不是需要一个demo项目工程
—— 教程选择Yes,需要创建一个demo工程,建议创建一个demo工程
3、测试框架使用哪一个
—— 教程选择None
4、是不是需要做基本的测试
—— 教程选择Yes
5、类前缀是什么
—— 教程输入LAT
2、将我们自己的组件放入指定目录
- 将源码文件复制到文件夹路径:ZLDemoTool/ZLDemoTool/Classes下。
-
资源文件放到Assets下。
模板文件中会看到一个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、更改模板文件相关信息
我们打开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文件
$ 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)'
验证通过后的截图
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
成功后的截图
通过这一步我们就同步好了远程和本地索引库,到此,私有库已经制作完毕!
使用 验证
注意:podfile文件里要加上
source 'https://github.com/CocoaPods/Specs.git'
source 'https://gitee.com/whityStyle/ZLDemoTool.git'
配置
如果你不配置系统的索引库 会找不到其他的库 只能找到你自己创建的仓库
总结
- 私有库:是我们真正放置组件代码的地方。
- 索引库:存放spec文件的地方,用于索引到代码的位置。
由于未保存截图,引用了部分其他截图(后续会补全所有源截图),如发现有问题,可共同交流
参考:侵立删
有gif
流程疏离
trunk的注册使用发布