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,二者不一致引入了该问题。
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的编译依赖信息统一配置,方便后续的更新维护。
解决方案是通过在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}"
}
}