组件化
组件化其实就是将模块单独抽离、分层,并指定模块间的通讯方式,从而实现解耦的一种方式,主要运用与团队开发
组件化的好处
1、模块间解耦
2、模块重用
3、提高团队协作开发效率
4、单元测试
组件化的标准
组件化方案的8条指标
一个项目经过组件化后如何来评判,主要有以下几个标准
:
- 1、模块之间没有耦合,模块内部的修改不会应该其他模块
- 2、模块可以单独编译
- 3、模块间数据传递明确
- 4、模块可以随时被另一个提供了相同功能的模块替换
- 5、模块对外接口清晰且易维护
- 6、当模块接口改变时,此模块的外部代码能够被高效重构
- 7、尽量用最少的修改和代码,让现有的项目实现模块化
- 8、支持OC和Swift,以及混编
前4条主要用于衡量一个模块是否真正解耦
,后4条主要用于衡量在项目中实践中的易用程度
组件化原则
一个项目主要分为3层:业务层
、通用层
以及基础层
,在进行组件化时,有以下几点说明
-
只能上层对下层依赖,不能下层对上层的依赖,因为下层是对上层的抽象
-
项目公共代码资源下沉
-
横向的依赖尽量少有,最好下沉至通用模块,或者基础模块
组件化方案
常用的组件化方案主要有两种:
本地组件化
:主要是通过在工程中创建library
,利用cocoapods
的workspec
进行本地管理,不需要将项目上传git,而是直接在本项目中以framework
的方法进行调用
cocoapods组件化
:主要是利用cocoapods
来进行模块的远程管理
,需要将项目上传git(需要注意:这里的组件化模块分为公有库和私有库,对公司而言,一般是私有库)
本地组件化
1、创建主工程
-
首先创建一个工程
image -
集成cocopods,进行本地管理:
$ cd 项目目录
$ pod init
- 编辑podfile,并执行
pod install
2、创建组件
假设有以下几个模块:
-
主工程
:承载主要的表层业务代码 -
Core
:独立存在,应用加密、接口请求等敏感代码 -
Base
:基类封装,拓展,基本的数据处理 -
Service
:服务层,封装业务工具类,例如网络层服务、持久化服务等 -
Pods
:三方依赖
其中,各个模块间的关系如下所示
image下面,我们来进行模块的创建,以Core
模块为例:
-
选择
imagenew -> project -> iOS -> Framework
,新建一个模块 -
选择正确的
imageGroup
和WorkSpace
(这里需要注意一点:创建的library
最好放在主工程根目录
下,否则后续podfile
执行pod install
时会报错) -
将创建的
imagelibrary
的Build Settings -> Mach-O Type
修改为静态库Static Library
3、主工程调用library
- 在CJLCore中新建一个文件,并添加如下代码
//类需要声明为public
public class CJLCoreSetting: NSObject {
//属性需要声明为public
public static let SCRET_KEY = "SCRET_KEY"
}
-
在
imageBuild Phases -> Headers -> Public
中将新建的文件添加为public,这样主工程才能访问该文件 -
在主工程中,选择
imagetarget -> Linked Frameworks Library
中添加CJLCore
,只需要build主工程,library能够自动联编
4、使用
首先import CJLCore
,然后使用
这里需要注意的是,子library之间的互相调用,与主工程调用library类似,主需要添加依赖、暴露header即可
5、使用cocoapods管理三方依赖
假设我们需要在CJLCore
中封装网络层代码,需要用到三方库Alamofire
,在podfile中
platform :ios, '9.0'
inhibit_all_warnings!
use_frameworks!
#配置workspace路径
workspace 'Modularization.xcworkspace'
################# 三方依赖
# 公有
def workspace_pods
pod 'SwiftyJSON'
end
# 主工程
def project_only_pods
pod 'SnapKit'
end
#网络
def network_layer_pods
pod 'Alamofire'
end
################# 模块
target 'CJLCore' do
#配置libray路径
project 'CJLCore/CJLCore.xcodeproj'
workspace_pods
network_layer_pods
end
################# 主工程
target 'Modularization' do
workspace_pods
project_only_pods
network_layer_pods
target 'ModularizationTests' do
inherit! :search_paths
end
target 'ModularizationUITests' do
end
end
到此,一个本地组件化的模块就配置完成了
cocoapods组件化
除了本地组件化,还可以使用cocoapods
,其原理如下图所示
这里还是以本地组件化中的结构为例
1、创建私有仓库
-
在github上创建一个MySpecs仓库
具体步骤:登录github-->点击右上角“+”-->选择 new repository-->输入Repository name为MySpecs,选择仓库类型为 private,点击Create repository。 -
将私有仓库添加至本地
~/.cocoapods/repos
目录
pod repo add mySpecs https://github.com/xxx/MySpecs.git
2、创建pods 工程,即组件化工程
- 使用终端创建
CJLServices
模块
pod lib create CJLServices
-
根据提示依次输入:ios、swift、yes、none、no、CJL
image -
进入模块的目录,将文件拷贝至
imageCJLServices -> Classes
中 -
执行
imagepod install
,会将Classes更新至pods中
3、配置pods工程
修改模块的配置文件,即CJLServices.podspec
- 如果需要依赖三方库,需要配置
s.dependency
s.dependency 'AFNetworking'
- 如果模块间需要相互引用,同样需要配置
s.dependency
,以CJLBase
为例,需要引用CJLService
//********1、修改 podspec 文件
s.dependency 'CJLServices'
//********2、修改 podfile 文件
pod 'CJLServices', :path => '../../CJLServices'
- 如果需要加载资源,例如图片、json、bundle文件等
- 1、在模块的
Assets
文件夹 中添加资源文件 - 2、在
specs
里配置资源路径(必须配置!!否则无法读取资源) - 3、访问时需要指定资源文件路径
- 1、在模块的
//*****1、修改 podspec 文件
s.resource_bundles = {
'CJLBase' => ['CJLBase/Assets/*']
}
//*****2、使用
let bundlePath: String = Bundle.init(for: dynamicClass.self).resourcePath! + "/CJLBase.bundle"
let bundle = Bundle(path: bundlePath)
if let path = bundle?.path(forResource: "mouse", ofType: "jpg"){
self.imgView.image = UIImage(contentsOfFile: path)
}
同理,模块中的xib,json文件的获取方式也是一样的
4、提交至git
这里提交至git的模块是pods工程才可以,以CJLBase
为例
-
需要在github上创建一个私有repository,命名为
CJLBase
-
执行以下终端命令
$git init
$git add .
$ git commit -am "第一次提交"
//即第一个步骤中创建的仓库地址
$ git remote add origin https://github.com/xxx/CJLBase.git
$ git push origin master
//一定要有标签,不然会有下面的警告
//podspec文件中获取Git版本控制的项目需要tag号,
$ git tag -m "first release" "0.1.0"
$ git push --tags
5、验证podspec文件
执行终端命令 pod spec lint
注意:
pod spec
相对于pod lib
会更为精确,
pod lib
相当于只验证一个本地仓库,pod spec
会同时验证本地仓库和远程仓库。
6、提交到私有仓库
执行以下命令
pod repo push [本地Spec Repo名称][podspec文件路径]
//******举例
$ pod repo push MySpecs CJLBase.podspec
提交成功后,可在本地仓库中看到提交路径MySpecs -> CJLBase
7、使用
- 新建一个工程,在项目的podfile里添加
#私有spec仓库的地址,而不是某个pod仓库的地址
source 'https://github.com/xxx/MySpecs'
pod 'CJLBase'
- 执行
pod install
即可
网友评论