一、前言
这是第三次写博客。岁月不饶人,转眼间已经几年没发博客了。慢慢的,腰椎间盘突出了(工资没突出),年龄++了,还是孤身一人。转而只能以技术度日,终日研究至秃发。
转入正题。笔者一直听说有组件化开发这一说法,但终是没有进入实质性的研究。最近项目刚好要使用组件化开发,于是笔者查看了几十篇文章,各种度娘与Google,终也实现了基本功能。现在跟大家分享如下,希望能帮大家避坑。(ps.如果觉得对你有用,给我点个赞,让我有更新动力...)
二、说明与建议
-
关于组件化的 优点 与 缺点 ,笔者不在重复论述。大家可以在度娘或Google自行查看,要讲的一点就是,不是所有的项目都适用于组件。需要斟酌考虑。
-
那什么是组件化?多方查找资料,大多都是说把一个个功能或者模块分开写,多数以cocoapods管理,然后整合到一个壳(也就是新建一个项目中),然后再壳中引用。笔者也觉得差不多是这样。
- 在正式讲组件化的之前,个人建议,做组件化需要对cocoaPods 有一定的了解,以及对Git的操作与错误有一定的基础。
四、精彩开始
如上所述,组件化就是将功能或者业务拆分研发与维护,那么今天这篇文章主要是以学习如何创建一个Git项目 以及如何发布到cocoaPods上以供使用,当然本篇文章不涉及如何写代码,请知晓!
- 收集网上资料,大多相同,步骤也是类似,唯一不同点,就是有部分语句不一样。笔者就按照顺序来说。
-
首先,为了能让cocoaPods能安装以及搜索到我们所创建的组件,我们需要建立一个索引库(在码云或者GitHub或者公司Git上创建)(这里请切记,索引库和组件库是不一样,组件库下面会说。关于如何创建库,在文末。)
-
索引库创建完毕后,需要加入本地的pod repo 具体格式如下:
#这里切记,创建的索引库,必须要readme 文件,否则在第8步,会失败。笔者在这坑躺了很久了
pod repo add 索引库名称(跟你的组件名可以不一样) 索引库地址
到这里为止,你的第一小部分算是完成了。
3.接下来,我们需要开始创建一个Pod模板库,具体是找一个合适的文件夹(也可新建文件夹),然后
pod lib create 组件名称
切记,这里的组件名称与上面的索引库最好不要一样,有所区分最好。因为这里的组件最后是要关联到索引库,这样才可被搜索到和导下来使用的。
- 关于Pod模板库的介绍,我就不多说了,给个地址(理解CocoaPods的Pod Lib Create),请移步查看。这里的pod模板库可用于新建项目以及调试你的组件。
-
当你编写完组件后,就可以进行发布到私有库或者公有库,特别注意,这里的都是以私有库创建的来说。那么发布到库的话,我们就需要创建一个组件库(注意组件库与索引库的区别),组件库顾名思义就是用来保存组件的。那么我们就需要到Git 或者 你们公司Git上创建一个库。(关于如何创建库,在文末。)
-
当你组件库创建完毕后,就需要进行如下的环节
首先命令行进入到工程目录下
#初始化
git init
#添加文件或者项目
git add .
#提交到本地
git commit -m "提交描述"
#关联到远程的组件库 切记 不是索引库
git remote add origin 远程私有库地址
#推送到到远程的组件库
git push origin master
#创建Tag 标签 必须创建 若创建错了,可以删除。这里的标签和Pod模板库里面LXFBase.podspec 的s.version一致。
git tag 'X.X.X'
#推送到标签到远程组件库
git push --tags
到这一步结束,你能发现,你创建了一个索引库、一个组件库且已经有数据传递上去了。现在还不能通过pod install导入,因为你还没发布到cocoaPods上面。接下来就是校验和发布到cocoaPods.
- 先进行检查,看看是否符合上传的条件
#本地验证 这里切记,私有库必须要跟上 --private 验证私有库 --allow-warnings 忽略警告
pod lib lint --private --allow-warnings
#远端验证
pod spec lint --private --use-libraries --allow-warnings
出现绿色的 *** passed validation 字眼,表示验证成功。
- 这一步将关系到你使用 pod search 时,能不能搜到你组件的情况了
当上面验证成功后,执行将索引库与组件库关联。
# pod repo push 私有索引库名称 spec名称.podspec (这里的XXX.podspec 是第4步里面创建的的Pod模板库内的文件)
pod repo push ZSPSDK UITool.podspec
没有报错就是关联成功。
- 这个时候就可以开始验证你的组件库是否已经可以搜索到了
直接 pod search 你的组件库名称
能搜索到,即成功了。
接下来就是想使用AFNetWorking 一样使用你的组件库。
后话
至此,你的组件已经创建完成了,恭喜你。笔者在创建的时候也遇到了不少坑,若有幸看到这篇文章,又遇到问题了,可以留言,我看到后会回复。笔者会继续更新关于组件化的相关知识。争取把组件化吃透。
网友评论