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

96
zizi192
0.2 2017.09.07 11:34* 字数 1128

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名称、图标等属性,只能声明自己业务组件独有的东西。示例如下:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.moudlea">

    <application android:theme="@style/AppTheme">
        <activity
            android:name=".AActivity"
            android:screenOrientation="portrait" />
    </application>

</manifest>

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

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.moudlea">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity
            android:name=".AActivity"
            android:screenOrientation="portrait">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

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

Android开发