主页 > 开发文档 > Android 组件化和插件化开发探索与思考

Android 组件化和插件化开发探索与思考

前言

开发中,我习惯性会把一个模块的功能放在一个包下,便于查找,但烦于耦合性太高,后期维护太费劲,因此对项目进行组件化拆分势在必行。组件化好处:便于开发,团队成员只关注自己的开发的小模块,降低耦合性,后期维护方便等。相当于先有很多小组件,各自开发,最后组装,成一个 app。

关系图

app:壳工程;module1:组件1;module2:组件2;common:第三库,公用工具、自定义 View、主题等。

效果预览

组件化过程很容易想到一些问题,比如 module1 我想单独调试怎么做?module1 有页面需要跳转到module2怎么办等。接下来,我一一探索,提供解决方案。

全局设置 Gradle

如果有很多项目,可以设置全局来统一管理版本号或依赖库,这样就不用一个个去改了,根目录下 build.gradle 添加:

def androidSupportVersion = '25.3.1'

ext {
    //编译的 SDK 版本,如API20
    compileSdkVersion = 25
    //构建工具的版本,其中包括了打包工具aapt、dx等,如API20对应的build-tool的版本就是20.0.0
    buildToolsVersion = "26.0.0"
    //兼容的最低 SDK 版本
    minSdkVersion = 14
    //向前兼容,保存新旧两种逻辑,并通过 if-else 方法来判断执行哪种逻辑
    targetSdkVersion = 22
    appcompatV7 = "com.android.support:appcompat-v7:$androidSupportVersion"
    constraintLayout = 'com.android.support.constraint:constraint-layout:1.0.2'
}

其中module/build.gradle:

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
    buildToolsVersion rootProject.ext.buildToolsVersion
    //……
}

资源名重名

每个 module 都有 app_name,为了不让资源名重名,可以在每个组件的 build.gradle 中增加 resourcePrefix "xxx_",固定每个组件的资源前缀。但是 resourcePrefix 这个值只能限定 xml 里面的资源,并不能限定图片资源,所有图片资源仍然需要你手动去修改资源名。不过我更建议把图片、 strings、 colors、dimens 等资源放到 common 去,可以防止不同的资源名字却对应了同一资源值。

组件单独调试

application 与 library 切换

module1 在开发阶段应该 application,等 release 后才是 library,这里可以设置一个变量控制下,在根项目 gradle.properties 加入:

# 组件单独调试开关true 可以false 不可以需要点击 "Sync Project"
isDebug=false

module1/build.gradle:

if (isDebug.toBoolean()) {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}

android {
    //……    
}

applicationId

开发阶段,module1 还必须有个 applicationId:

android {
     //……
    defaultConfig {
        // 作为library时不能有applicationId,只有作为一个独立应用时才能够如下设置
        if (isDebug.toBoolean()){
            applicationId "com.wuxiaolong.module1"
        }
        //……
        }
}

入口类

到这里还不行,还得有 AndroidManifest 设置入口类,release 后这个 AndroidManifest 不需要打包进去,新建文件 debug,然后在 build.gradle 指定路径:

android {
    //……  
    sourceSets {
        main {
            if (isDebug.toBoolean()) {
                manifest.srcFile 'src/main/debug/AndroidManifest.xml'
            } else {
                manifest.srcFile 'src/main/release/AndroidManifest.xml'
                java {
                    //release 时 debug 目录下文件不需要合并到主工程
                    exclude 'debug/**'
                }
            }
        }
    }
}

另外,module 可能会需要使用到自定义的 Application,release 同样也不需要打包进去,不然合并会有冲突。

组件间通信

组件间通信包括两个场景:(1)UI 跳转;(2)调用组件某个类的某个方法。这里涉及路由,何为路由,就是页面请求,都交给它处理。网上有很多路由库,我这里选的是阿里的 ARouter,ARouter 能解决上面的问题,但是也遗留一个问题,我独立运行 module1 时,想访问 module2 页面就做不到了,Router 不支持跨进程访问,这个问题待定,也可能是我使用 ARouter 姿势不对,如果您能做到,望告知。

ARouter 使用

1、common

dependencies {
    //arouter
    compile rootProject.ext.arouterApi
}

2、组件app 和 module 都需要加入:

android {
    defaultConfig {
        //arouter
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [moduleName: project.getName()]
            }
        }
    }

dependencies {
    //arouter
    annotationProcessor rootProject.ext.arouterCompiler
}

3、使用sample 列出了组件跳转、组件跳转-带参数、获取 Frgment、调用组件某个类的使用方法,详见我的 GitHub 分享。详细使用请阅读 ARouter,不得不吐槽,文档写的不是一般的烂。

library 重复依赖

module1 和 module2 分别都依赖了 common,会不会导致 library 重复依赖呢,想必大家也有这个疑问了,实际上在 release 构建 APP 的过程中 Gradle 会自动将重复的 aar 包排除,APP 中也就不会存在相同的代码了,可以打包反编译验证下,我试了,确实没有重复依赖。

ButterKnife

Attribute value must be constant

在 Android Studio 的 library 的 module 中无法使用 ButterKnife。网上说用 R2 替代(为什么能用 R2?),但都没有说 R2 怎么生成的?这篇《butterknife在library中使用问题处理》文章说使用 android-apt,确实可行,但是带来一个新坑,发现 apply plugin: 'android-apt' 与 arouter 冲突,这时候 arouter 失效了。正确姿势,用 Android ButterKnife Zelezny 插件生成,手动改成 R2,clean 下就 OK,感谢群里的小伙伴提示。

OnClick 方法

ButterKnife 还有个坑,OnClick 方法中同样使用 R2,但是找 id 的时候使用 R,然而 library 中是不能使用 switch- case 找 id 的(原因:《在Android library中不能使用switch-case语句访问资源ID的原因分析及解决方案》),可以使用 if-else:

  @OnClick({R2.id.module1_button, R2.id.module1_button2})
    public void onViewClicked(View view) {
        int id = view.getId();
        Log.d("wxl","id="+id);
        if (id == R.id.module1_button) {
            toastShow("module1_button");
        } else if (id == R.id.module1_button2) {
            toastShow("module1_button2");
        }
    }

当你写 switch- case 时,Android Studio 也有提示,可以一键转换成 if-else。

源码

https://github.com/WuXiaolong/ModularSample,