随着项目功能的不断增加,越来越多的开发人员加入,业务主线也随之越来越多,造成耦合越来越严重,编译越来越慢,测试不独立等一系列问题。为了解决此类情况,我们可以考虑到使用组件化开发
-
概念 组件化就是将一个单一工程的项目, 分解成为各个独立的组件, 然后按照某种方式, 任意组织成一个拥有完整业务逻辑的工程。
-
优势
- 独立:独立编写、编译、运行、测试
- 重用:功能代码的重复使用。比如不同项目使用同一功能模块
- 高效:任意增删模块,实现高效迭代
- 组件化还可以配合二进制化, 提高项目编译速度
-
组件分类 大体上分三类:基础组件、功能组件和业务组件
- 基础组件:也称为公共组件,存放平时定义的宏、常量、协议、分类、对必要的第三方的封装类,以及各种处理工具类,如:时间、日期、设备信息、文件处理、沙盒管理等
- 功能组件: 自定义视图控件、一些特定功能的封装(如录音、播放音频封装)
- 业务组件:各种业务线
本篇先来介绍下远程私有库的基本使用,建议按顺序看完之后,回来再看一遍步骤归纳,加深了解,如有不足之处,欢迎指出,感谢 : )
步骤归纳
-
创建远程索引库和私有库
-
将远程索引库添加到本地
pod repo add 索引库名称 索引库地址
-
在本地创建一个pod模板库
pod lib create 组件名称
将框架的核心代码添加到Classes目录下 本地安装测试核心代码是否可用pod install
修改Spec描述文件 将修改好的模板库上传至远程私有库 -
上传代码和打标签
git init
git add .
git commit -m "提交描述"
git remote add origin 远程私有库地址
git push origin master
git tag '0.1.0'
git push --tags
-
提交spec至私有索引库
pod lib lint --private
pod spec lint --private
pod repo push 索引库的本地名称 xx.podspec
-
使用
source 官方索引库url
source 私有索引库url
pod '组件名称'
pod install
接下来我们就来实战如何创建和使用私有库
一、创建私有索引库
这里以码云为例,创建一个LXFSpecs的私有索引库,这玩意的作用如其名,就是用来索引的
二、本地添加私有索引库
1、查看本地索引库
pod repo
如图,目前本地仅有github上的那个公有索引库
2、添加私有索引库
将我们刚刚新建的私有索引库LXFSpecs添加到本地
// pod repo add 索引库名称 索引库地址
pod repo add LXFSpecs https://gitee.com/LinXunFeng/LXFSpecs.git
现在本地就有两个索引库,好,索引库的事情就先放一边去了~
三、创建组件库
码云上的创建操作同上,这里以LXFBase为例,创建基础组件库
1、快速创建模版库
到合适的位置创建一个与组件名相同的文件夹,cd进去后,使用如下命令
// pod lib create 组件名
pod lib create LXFBase
这里会让你配置一些信息,根据自己的情况自行配置即可。
2、添加组件内容
创建完成后会自动帮我们打开相应的Example项目,LXFBase目录中会出现如图这些文件,我们把基础组件相关的东西丢到Classes文件夹中,并且把ReplaceMe.m
文件删除
默认Classes文件夹中存放的文件就是pod install时要下载下来的文件,当然可以通过修改spec文件的配置来更改位置
3、安装与测试本地库
在Example项目的Podfile文件中可以看到
pod 'LXFBase', :path => '../'
模板库已经默认帮我们在Podfile中指定了LXFBase.podspec的位置,使组件LXFBase可以正常安装使用和方便测试
pod install
可以看到我们已经将本地的组件添加进Example中了,现在可以尽情地做你想做的测试,确保组件的可用。
测试组件没有问题后,我们接下来就要将podspec文件上传至私有索引库,不过在此之前,需要对spec进行修改。
4、 修改Spec
具体的配置说明可以参考Cocoapods 创建第三方框架
主要的修改内容
s.name = 'LXFBase'
s.version = '0.1.0'
s.summary = 'LXFBase.'
s.description = <<-DESC
LXFBase是基础组件库,包括分类和常用工具
DESC
s.homepage = 'https://gitee.com/LinXunFeng/LXFBase'
s.source = { :git => 'https://gitee.com/LinXunFeng/LXFBase.git', :tag => s.version.to_s }
s.source_files = 'LXFBase/Classes/**/*'
四、上传组件代码
1、将代码提交到组件仓库
git add .
git commit -m 'firstCommit'
git remote add origin https://gitee.com/LinXunFeng/LXFBase.git
// 第一次push如果报错的话可以加上-f
// git push -f origin master
git push origin master
2、打标签
标签0.1.0
与spec中的s.version
保持一致
git tag '0.1.0'
git push --tags
五、提交podspec到私有索引库
在上传spec文件前我们可以做一个验证来节省时间,不然每次都推送很久结果还是验证失败,会气死人的~
1、本地验证Spec的必填字段
// 本地验证不会验证 s.source 中的tag
pod lib lint
2、远程验证
// 远程验证会验证 s.source 中的tag,如果此时没有打上相应的标签则会报错
pod spec lint
如果你刚才没有打标签并上传至远程私有库就来进行远程验证,肯定是会报错的
在打完并上传tag后再进行远程验证,就会验证成功了,验证成功后我们就可以进行下一步操作:提交podspec文件到索引库
- 验证私有库提示
如果验证的是私有库,则在后面加上
--private
,否则会有警告,你可以选择--allow-warnings
来忽略该警告
pod lib lint --private
pod spec lint --private
3、提交podspec
// pod repo push 私有索引库名称 spec名称.podspec
pod repo push LXFSpecs LXFBase.podspec
这里的操作过程:先将我们的代码直接push到本地索引库LXFSpecs,推送后会自动帮我们同步到远程索引库
再来看看码云上的私有索引库LXFSpecs
来测试下搜索我们的组件
pod search 'LXFBase'
六、使用私有库
这时我们可以来试试通过pod形式来添加组件LXFBase,创建一个新的项目
1、添加Podfile文件
pod init
2、在Podfile的最顶部添加如下描述
// 第二行是为了保证公有库的正常使用
source 'https://gitee.com/LinXunFeng/LXFSpecs.git'
source 'https://github.com/CocoaPods/Specs.git'
3、添加使用组件LXFBase
pod 'LXFBase'
4、安装组件
pod install