编辑推荐: |
本文内容针对想要实现工程组件化开发的中小型项目
ComponentLight 是一款 Gradle 插件,无代码侵入,可以理解为组件化辅助工具.
本文来自于简书,由火龙果软件Anna编辑、推荐。 |
|
本文将通过以下问题,逐步说明 ComponentLight 的用途和用法。
为什么要用组件化框架
ComponentLight 能做什么
ComponentLight 怎么用
一、为什么要用组件化框架
为什么要用组件化框架来实现项目组件化,直接利用 module 实现的项目组件化有什么问题吗?
通过创建 module、手动设置依赖的方式可以实现项目组件化,但是效果不好,实际开发中有暗病。
组件化结构的问题
在说问题之前,我们先来看下常见的组件化结构。
架构
项目分析
假如有这么一个项目(如上图),它的 app 模块是程序入口,有阅读(reader)、我的(me)、登录(login)三个业务模块,以及
base-all、base-reader 俩个基础模块。
为了方便说明,我把 app、reader、me、login 等业务(功能)模块称为组件,base-all、base-reader
称为基础库。
上面的项目,组件之间互不依赖,开发时不能直接引用,安全无耦合。同时基础库被组件依赖,组件之间可以依赖基础库做信息传递。
回顾下 Android 组件化。组件化是为了实现业务隔离开发,消除耦合的同时提升开发效率,为此要达到以下效果:
功能组件化。功能之间独立,开发时不能直接相互引用。这样有利于负责人独立开发自己的组件,至少拉代码时不用担心冲突、删组件时不用担心耦合。
组件独立化。各组件能作为 app 独立运行,不仅调试起来边界清晰,而且提升了编译速度。即,组件能随时从主项目插拔。
上面的项目中,reader、me、login 相互独立,表现在开发时,不能直接依赖;打包时,由于都被
app 依赖,所以可以全部打包到 apk 里。看似实现了组件化,但是实际操作起来却有很多不方便的地方:
首先,在组件独立化上,每次切换独立运行,要先修改 build.gradle 为 com.android.application、添加
android.sources,然后指定入口 Activity、移除主工程对它的依赖、Rebuild,一大堆操作后才能运行。操作繁琐复杂且耗时,本来组件独立化是为了方便调试、增快编译速度,怎么像是赔了夫人又折兵?
再者,有类似这样的场景:me 组件意为"我的",它展示的是用户的数据,既然涉及用户数据,必然离不开
login 组件。也就是说,me 如果独立运行,需要把 login 打包在内。那怎么做呢?让 me
组件直接依赖 login?此时 me 都可以直接引用 login 的代码,业务功能何来独立?那打包时再手动添加
login 依赖?你确定组件化不是自找麻烦。好,那再创建一个类似 app 的壳模块,让它包含 me
和 login,然后将壳模块独立启动,总可以了吧。确实可以,但是随着项目日益扩大,壳模块也会日渐增多,冗余的壳模块导致整个项目非常乱。
问题总结
分析了这么半天,核心问题就俩个:
独立运行可行性低,复杂的流程让人望而却步。
通过壳来实现 "开发时组件无依赖、独立运行时又能把必要的组件打包进去" 的方式很不灵活。
二、ComponentLight 能做什么
既然知道了上述问题,那 ComponentLight 自然就是为解决这俩个问题而生。
首先看下使用了 ComponentLight 后,各组件如何独立运行:
组件独立运行
直接在上栏中切换-运行即可。
然后看下组件 me 如何在不依赖壳模块的情况下,开发时不依赖 login(不可直接引用
login 代码,组件独立)、而在独立运行时自动打包进必要组件 login。只需要在 me 模块的相应配置文件(module-config.properties)里如下声明:
利用组件化框架可以极大的简化组件化过程中繁琐复杂的流程,最大程度的关注业务开发。
三、ComponentLight 怎么用
1、引入依赖
在项目根 build.gradle 中添加代码
buildscript {
...
dependencies {
...
classpath('com.dixon.plugin:component_light:1.0.0')
}
} |
2、配置模块
2.1、应用插件
找到各个 module 的 build.gradle 文件,移除
apply plugin: 'com.android.application' 或 apply plugin:
'com.android.library',用 apply plugin: 'com.dixon.component'
替代。
apply plugin:
'com.dixon.component'
android {
compileSdkVersion xx
defaultConfig {
minSdkVersion xx
... |
对于基础库可以不使用 ComponentLight,但推荐使用,以表明基础库在组件化项目中的层级关系。
2.2、声明模块关系
在各个 module 目录下均新建 module-config.properties 文件,用来声明模块关系。
位置如下图:
模块关系位置
该文件的内容如下示例:
module_type=application
depend_component=login,me,reader
depend_base=baseall
|
下面说明声明的意义和用法。
① module_type
表明当前模块的类型,这个属性最终将结合打包环境决定当前模块是 com.android.application
还是 com.android.library。它的参数如下:
参数 意义
application 表明当前模块是工程主模块。对应到上述项目中就是 app,不需要配置 runalone
即可独立运行,关于 runalone 配置后面会说。
component 表明当前模块是组件。该组件可独立运行,但要配置 runalone。
library 表明当前模块是组件。该组件不可独立运行,不需要配置 runalone。
base 表明当前模块是基础库。该基础库不可独立运行,不需要配置 runalone。
其实 library 和 base 本质上没有区别,但是意义上是有分别的。
library 表示的是业务组件,和 component 同级,不能独立运行可能是因为没有必要。
base 则是基础库。
综上,module_type 决定了当前模块是否可独立运行,和组件间的开发可见性没有关系。
② depend_component
当前组件 独立运行时 需要依赖的其它组件。
depend_component 参数声明了当前模块在业务意义上需要依赖的其它同级组件,并且当前模块独立运行时,这些依赖会被正确打包进
apk。被 depend_component 配置的组件在开发时并不会产生依赖,也就是说,它用于解决传统组件化依赖壳的问题。举几个例子:
模块 me 配置 depend_component=login
则 me 在开发时,无法直接引用 login 的代码。
但 me 在独立运行时,会将 login 正确打包进来,不再需要手动配置或依赖壳。 |
模块 app 配置 depend_component=me
模块 me 配置 depend_component=login
将 app 作为主工程打包,则 me 跳转 login 会【失败】
depend_component 决定了当前组件依赖的其它组件,如果要从 app 跳转至 login,不管是直接的还是间接的,app
都必须声明需要组件 login。 |
depend_component 决定了当前组件依赖的其它组件,如果要从 app 跳转至 login,不管是直接的还是间接的,app
都必须声明需要组件 login。
③ depend_base
表明当前模块依赖的基础库。
被 depend_base 声明的基础库,会被当前模块在任何时候依赖。也就是说不仅开发时能直接引用,运行时也会一并打包。
不同于 depend_component,假如组件 A 依赖组件 B,组件 B 依赖基础库 b,则
A 组件开发时虽然不能直接引用基础库 b 的代码,但在运行时会将基础库 b 正确打包进来。这是因为基础库
b 是组件 B 运行的基础,理论上是组件 B 的一部分,组件 B 缺少基础库 b 将无法运行,所以即使
A 的 depend_base 没有声明 b,b 也将正常打包进 apk。
上面三个参数分别声明了模块类型、组件关系、基础库关系,理论上就声明完了。
但是要某组件独立运行,除声明 module_type=component 外,还需要在 该组件模块下
配置 runalone。
2.3、配置 runalone
在 module/src/main 下新建 runalone 文件夹,将 AndroidManifest.xml
拷贝一份至 runalone 文件夹下,并指定启动 activity。
这里我是这么配置的:
runalone
runalone 中的代码仅会在组件独立运行时用到,不会打包进主工程或其它独立组件中。
关于 runalone,开发者可以按需自行定制,但至少要满足最小独立启动要求:
1.runalone 中有 AndroidManifest.xml;
2.AndroidManifest.xml 配置了 package;
3.AndroidManifest.xml 配置了默认 Activity。
可能会出的问题:
1.AndroidManifest 文件记得检查是否配置了 package。(有的会自带,没有包名怎么启动~)
2.明明配置了启动 Activity,却报 default activity 不存在,重启即可。
3.如果独立运行后,启动闪退,可能是因为你的资源文件找不到。尝试将资源放在 base 模块下。
4.独立运行后,如果新增四大组件,系统会自行声明到 runalone-AndroidManifest.xml
中,记得手动同步至原 AndroidManiest.xml,以保证主工程正确运行。
配置完毕后,Rebuild 即可。
附 runalone 的文件位置:
manifest.srcFile
"src/main/runalone/ AndroidManifest.xml"
java.srcDir "src/main/runalone/java"
res.srcDir "src/main/runalone/res"
assets.srcDir "src/main/runalone/assets"
jniLibs.srcDir '../app/src/main/jniLibs' |
四、尾声
ComponentLight 是组件化的辅助性插件,通过使用它,组件可以随时运行调试,并在摆脱了壳的束缚的同时,保证开发独立性和运行完整性。
bug 和建议可以直接反馈至 github 或文章下边。
|