Android 工程组件化实践

本文记录将一个新工程按组件化配置的过程及过程中遇到的问题。

一、工程最终结构

首先看下工程的最终结构，其中包括主模块、组件模块（也就是可以单独打包的子模块）、 lib 模块（又包括：基础lib，普通lib）。
如图：

工程结构

各个模块的详细介绍：

app：入口作用，最终发版打包的模块；
common：包括组件模块中共用的依赖、activity、工具类等其他可能会共用的，比如 ARouter 的依赖、登录activity 等可以放到该模块中，注意：主模块及组件模块要分别依赖该模块；
easyvideoplayer：就是普通的lib模块，哪儿个模块需要就去哪儿个模块添加依赖，下文中不再说这个模块相关的配置；
usercenter：用户中心组件模块。

二、创建工程及模块

创建工程其中包含主模块 app，并新建模块（正常应用模块，非 Android Library 类型）：common、usercenter。

1. 在工程 build.gradle 中添加：

ext {
    // 定义版本号，模块中版本号保持一致
    compileSdkVersion = 29
    buildToolsVersion = '29.0.2'
    minSdkVersion = 18
    targetSdkVersion = 29
    
    // 定义 applicationId
    applicationId = 'com.hyh.trytodo'

    // 控制组件化是否可以打组件包，想打组件包时改为：true
    isRunModule = false
}

2. app 模块需要配置：

文件 build.gradle 中：

api project(':common')
// 非组件化打包时添加模块依赖
if (!rootProject.ext.isRunModule) {
    implementation project(':usercenter')
}

3. common 模块中需要修改文件：

文件 build.gradle 中：
apply plugin: 'com.android.application' 改为 apply plugin: 'com.android.library'
版本号使用工程 build.gradle 文件中定义的
compileSdkVersion rootProject.ext.compileSdkVersion
buildToolsVersion rootProject.ext.buildToolsVersion
删除 applicationId xxx
AndroidManifest.xml 中：删除 <application> 中的所有属性，添加 activity 中也要在该文件中添加声明。

4. usercenter 模块中需要修改文件：

在目录 main/ 下创建 degub/ 目录，并将该模块中的 AndroidManifest.xml 复制到该目录，之后新建的 activity 要在该文件中声明。
AndroidManifest.xml 中：删除 <application> 中的所有属性。
文件 build.gradle 中：

if (rootProject.ext.isRunModule) {
   apply plugin: 'com.android.application'
} else {
   apply plugin: 'com.android.library'
}

android {
   compileSdkVersion rootProject.ext.compileSdkVersion
   buildToolsVersion rootProject.ext.buildToolsVersion

   defaultConfig {
       if (isRunModule) {
           applicationId rootProject.ext.applicationId
       }
       minSdkVersion rootProject.ext.minSdkVersion
       targetSdkVersion rootProject.ext.targetSdkVersion
   }
   ....
   sourceSets {
       main {
           if (isRunModule) {
               manifest.srcFile 'src/main/debug/AndroidManifest.xml'
           } else {
               manifest.srcFile 'src/main/AndroidManifest.xml'
               java {
                   exclude '**/debug/**'
               }
           }
       }
   }
}

到此工程及模块配置已经完成，接下来就是添加代码。

4. ARouter 配置及使用参考官方文件，不在赘述。

过程中遇到的问题：

1. 明明在 common 中添加了RxJava 的依赖，在 app 中也添加了 common 的依赖，但是在 app 中还是不能使用 RxJava 相关的方法。

出现该问题：需要看下依赖 RxJava 的语句是使用的 api 还是 implementation。只有使用 api 时，app 中才能正常使用。出现同样问题可以先排查这离

2. ARouter 提示：`"W/ARouter::: ARouter::There is no route match the path [/xxx/xxx], in group [xxx][ ]"`

ARouter 的主要配置是在 common 的 build.gradle 文件中配置，然后各个需要使用 ARouter 的模块去依赖 common，但是光这样是不行的，还需要添加下面的配置：

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

dependencies {
    annotationProcessor 'com.alibaba:arouter-compiler:1.2.2'
}