前言
随着移动互联网的不断发展,很多程序代码量和业务越来越多,现有架构已经不适合公司业务的发展速度了,很多都面临着重构的问题。而组件化架构则是目前众多厂家采取的方案之一。
组件化是把按照功能或者业务方向做细分模块,每个模块功能单一化,可以是公用工具类模块,也可以是单一功能模块。每个模块又可以独自形成一个APP,这样在单元测试,或者是功能测试时,可以更好的发现问题。后期主工程通过cocospod做仓库管理,引入各个模块组件。今天我们先来讲解一下单一组件仓库的搭建。
一、创建本地私有代码库工程(两种方式)
第一种、通过终端Pod命令创建模板工程
1、打开终端,cd到存放工程的目标目录下
$ cd Desktop/FFCS_TestKit
2、创建模板工程
$ pod lib create FFCS_TestKit (FFCS_TestKit为仓库名称)
在创建过程中,需要配置几个信息,如下:
至此本地私有代码库模板工程创建完成。
若选择了创建demo工程,本地私有代码库模板工程创建完成后,会自动打开demo工程。
pod lib create 工程名命令,会自动创建.podspec文件、README.md文件和LICENSE开源协议文件等。
文件夹目录结构,Example文件夹下是demo工程,FFCS_TestKit文件夹下是存放私有代码库源代码文件、资源文件等,如下图:
第二种、已有工程仓库,添加podspec文件即可
1、cd到工程目录下,在目录下添加.podspec文件到工程中,命令如下:
pod spec create FFCS_TestKit
2、添加README.md文件和LICENSE开源协议文件,可以从别的项目中copy过来,然后修改修改。
注意:LICENSE开源协议文件必须要有,因为Cocoapods不允许没有LICENSE开源协议文件的库到Cocoapods上。
二、添加封装的组件源代码、资源文件到工程目录下
这里我们添加一个UIView+FlowLayout分类和FFCSAlertView工具类
三、配置工程中的.podspec文件
.podspec文件描述了Pod库的一个版本。一个索引库,随着时间的推移,将有许多的版本。它包括关于应该从何处获取源、使用什么文件、应用构建设置以及其他通用元数据(如其名称、版本和描述)的详细信息。
Specs Repo是GitHub上的存储库,其中包含所有可用pods的列表。每个库都有一个单独的文件夹,其中包含该pod可用版本的子文件夹。
.podspec配置如下:
注意:.podspec文件中的配置参数说明,请参见Cocoapods-Podspec语法参考或者使用Cocoapods创建/管理公共库
四、更新demo工程,测试编译是否成功
终端运行$ cd /Desktop/FFCS_TestKit/FFCS_TestKit/Example命令,到Example文件夹目录下,然后运行pod install或pod update命令更新demo工程,并在Xcode中编译运行demo,看是否有错误,有错误及时修改,保证能运行成功。有错误存在会验证不通过。
注意:每次更改私有代码库工程中的相关信息后,都需要更新编译demo工程,保证无误。
pod更新后,工程目录如下
五、验证本地.podspec文件
该验证过程不会访问网络,且仅仅是一个验证不会添加文件到某文件夹下。先cd到FFCS_TestKit文件目录下
终端下,运行pod验证命令,如下:
$ pod lib lint 或者 $ pod lib lint--allow-warnings///--allow-warnings参数:允许忽略警告
六、提交本地工程到远程私有git仓库,注意添加对应的tag
如果没有远程git仓库,先建立git仓库,这边就不讲解怎么建立
操作指令如下:
$ git init #git 工程初始化
$git add.或者 $ git add -A
$ git status # 显示代码状态
$ git commit -m '初始化工程'
$ git remote add origin 远程仓库地址 # 链接到远程仓库
$ git push -u origin master # 推送到远程仓库
// 添加tag标记
$ git tag # 查看所有版本号
$ git tag -m '第一个发布版本'' 0.0.1' #或者 $ git tag 0.0.1 或者 $ git tag -a '0.0.1' -m '第一个发布版本'
$ git push --tags 或者 $ git push --tag # 上传tag
具体的git操作指令含义可以上Git教程上查找。
上传完代码后,别忘了为这次提交添加tag,否则下一步验证会有问题,找不到相应版本的.podspec文件。
注意:添加的tag版本号必须和.podspec文件中的s.version = '0.0.1'版本号一致。
七、验证远程git仓库的.podspec文件
$ pod spec lint 或者 $ pod spec lint--allow-warnings
八、保存.podsepc文件并提交到远程端私有索引库
$ pod repo push 远程私有索引库名称 FFCS_TestKit.podspec --use-libraries --allow-warnings
九、新建测试工程,检测远程pod库是否可用
新建一个工程,在Podfile文件中pod我们的私有库,pod 'FFCS_TestKit'
注意:1)引入私有库的时候,还需要通过source引入私有库对应的索引库地址,
如:source 'http://192.168.254.31/app/PublicProject/componentLibrary/iOS/ffcsspec.git' # 自己的私有索引库地址。
2)若你的私有库还依赖了第三方公共库或者自己的其他私有库,第三方公共库或者自己的其他私有库对应的索引库地址也需要引入。