Android Studio组件化方案——多module编译常见问题

android组件化开发中，工程通常被拆分为多个module。开发中可以根据需要来选择组件开发或者集成开发。

背景知识

Android Studio中一个project可由多个module组成，其中module主要有两种属性：

• 1、application属性，即该module为可独立运行的app程序

apply plugin: ‘com.android.application’

• 2、library属性，一般作为app编译运行依赖的库文件，不可独立运行

apply plugin: ‘com.android.library’

注：module的属性在各自的build.gradle文件中配置。

module组件开发和集成开发模式切换

在多个团队进行各自组件的开发时，业务组件应处于application属性，方便开发人员的独立开发、运行及调试。当组件开发完毕需要转为集成模式，业务组件应处于library属性，便于宿主app依赖各业务组件，构造一个具备完整功能app。
为了便于各业务组件在两种属性之间切换，我们可以利用gradle构建工具，在项目根目录的gradle.properties中定义一个属性isModule，true表示当前处于组件开发模式，false表示当前处于集成开发模式。其他业务组件的build.gradle中可以读取gradle.properties中定义的isModule常量，根据需要在两种开发模式间切换。

注：程序员一定要‘懒’，避免重复性的体力劳动。

一、在根目录gradle.properties中添加定义

# 每次更改“isModule”的值后，需要主动 "Sync Project" 
isModule=false

二、在各业务组件的builde.gradle中读取isModule，设置运行属性。其中isModule是String类型，需要进行转换。

if (isModule.toBoolean()) {
    apply plugin: 'com.android.application'  //组件开发模式，独立运行
} else {
    apply plugin: 'com.android.library'  //集成开发模式
}

三、在各业务组件的builde.gradle中读取isModule，设置不同的Manifest文件。
每个业务组件都会有各自的AndroidManifest.xml文件，其中配置了业务组件使用的四大组件、权限、Application等信息。在组件开发模式中，AndroidManifest.xml应该声明组件作为app独立运行所需要的全部属性，e.g.Application信息和桌面启动的Activity。在集成开发模式中，每个业务组件的AndroidManifest.xml都会合并到宿主app中，此时不需要声明Application和桌面启动的Activity等信息。综上，业务组件在切换开发模式的同时，需要切换对应的AndroidManifest.xml。
可以通过创建两个AndroidManifest.xml文件位于不同的路径，并由gradle提供的sourceSets属性来配置不同开发模式使用的AndroidManifest文件路径，来解决上述的冲突问题。

sourceSets {
        main {
            if (isModule.toBoolean()) {
                manifest.srcFile 'src/main/module/AndroidManifest.xml'
            } else {
                manifest.srcFile 'src/main/AndroidManifest.xml'
            }
        }
}

首先是集成开发模式下的 AndroidManifest.xml，不能拥有自己的 Application 和 桌面启动的 Activity，也不能声明APP名称、图标等属性，只能声明自己业务组件独有的东西。示例如下：

然后是组件开发模式下的表单文件，和常见的app的AndroidManifest.xml一致：

compileSdkVerstion、targetSdkVersion、support-library版本的统一

多moudle开发时，建议统一各个module的compileSdkVerstion、targetSdkVersion、support-library等的版本号，否则容易出现编译问题或者warn。

以下图为例，我将compileSdkVerstion、targetSdkVersion版本号设置为23，但是引入的com.android.support:appcompat-v7包版本号为25.3.1，二者不一致引入了该问题。

compileSdkVersion和support版本不一致引入.png

compile 'com.android.support:appcompat-v7:25.3.1' 改为23后解决
compile 'com.android.support:appcompat-v7:23.2.1'

多moudle编译配置的统一

工程中有多moudle时，每个moudle都有独自的build.gradle文件，可配置各自的编译信息。当buildToolsVersion与其他的编译依赖版本号不一致时，可能出现下图中的错误。这个时候需要更新每个moudle的build.gradle文件。
为了避免上述繁琐的步骤，必须将各moudle的编译依赖信息统一配置，方便后续的更新维护。

buildToolsVersion与其他版本不一致问题.png

解决方案是通过在gradle.properties文件中定义常用的编译配置，然后在各moudle中引用该配置。步骤如下：

一、gradle.properties中定义如下，示例中定义了compileSdkVerstion、targetSdkVersion、support-library等信息

//gradle.properties
MIN_SDK_VERSION=14
COMPLIE_SDK_VERSION=25
TARGET_SDK_VERSION=25

BUILDTOLLS_VERSION=25.0.0
SUPPORT_LIB_VERSION=25.2.0

二、在moudle的build.gradle中引入配置。示例如下：

//build.gradle
android {
    compileSdkVersion Integer.parseInt(COMPLIE_SDK_VERSION)
    buildToolsVersion BUILDTOLLS_VERSION

    defaultConfig {
        minSdkVersion Integer.parseInt(MIN_SDK_VERSION)
        targetSdkVersion Integer.parseInt(TARGET_SDK_VERSION)
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

    dependencies {
        compile "com.android.support:appcompat-v7:${SUPPORT_LIB_VERSION}"
    }
}

参考：http://blog.csdn.net/cai_iac/article/details/51850291