Android独立Module运行

前言

Android组件化中我们经常会将逻辑组件到各个Module中,为了进一步提高开发效率,避免不必要的编译时间浪费,我们可以通过对Module中build配置进行进行设置,以使各个业务单元模块Module可以独立运行。

一、gradle文件说明

实现Module可以独立运行涉及到修改gradle文件或者相关配置,因此,我们首先对gradle的相关文件做一个简单说明,然后再说明如何更改。

gradle相关文件位置

gradle文件.jpg

如上图所示,我们在Android工程中常见到的gradle及相关文件有如下几个:

  1. 项目根目录下的build.gradle
  2. 项目根目录下的settings.gradle
  3. 项目根目录下的gradle.properties
  4. 项目根目录下的gradle文件夹
  5. Module目录下的build.gradle

1.项目根目录下的build.gradle

项目根目录下的build.gradle文件是整个项目工程的配置入口,在此文件中可以配置版本,插件,依赖库等信息,示例代码:

apply from:"config.gradle"
buildscript {
    ext.kotlin_version = "1.3.72"
    repositories {
        google()
        jcenter()
        maven { url "https://jitpack.io" }
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:4.1.0"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath 'com.google.protobuf:protobuf-gradle-plugin:0.8.8'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url "https://jitpack.io" }
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

整个文件主要包括两个部分: buildscript和allprojects。

  1. buildscript是gradle脚本执行所需依赖,分别是对应maven库和插件。
  2. allprojects里是项目本身需要的依赖,项目内所需要的库需要在此处声明,否则会找不到对应的库

2.项目根目录下的settings.gradle

settings.gradle文件主要是用来声明工程树的配置,我们需要将各个Module在此文件中引入,否则Module会被当成一个文件夹,而不会被当成Module处理。
文件配置示例如下:

include ':singlework'
include ':annotationTest'
include ':processorTest'
include ':app'
rootProject.name = "DemoWork1"

如上图,我们在当前的工程中引入了singlework,annotationTest,processorTest,app等几个Module。

include后面为Module名称。

3.项目根目录下的gradle.properties

此文件主要是配置项目中全局的Gradle配置,如是否使用AndroidX等其他内容也需要在此处配置android.useAndroidX=true.

4.项目根目录下的gradle文件夹

从上图中我们可以看出gradle文件夹中存在一个wrapper文件夹,wrapper文件夹中有gradle-wrapper.jargradle-wrapper.properties两个文件。

wrapper实际上是对Gradle的一层包装,可以使工程在构建时有着统一的Gradle版本。

  1. gradle-wrapper.jar文件:具体的Gradle功能实现的jar包
  2. gradle-wrapper.properties:gradle wrapper的配置文件,用来配置使用gradle的版本
  3. 根目录下的gradlew:Linux下的可执行脚本
  4. 根目录下的gradlew.bat: Windows下的可执行脚本

5.Module目录下的build.gradle

Module下的build.gradle文件主要是对于当前Module的配置,主要用来声明版本,依赖库以及一些编译或打包配置。

我们建立一个新工程,app Module下的build.gradle文件如下:

plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 30
    buildToolsVersion "30.0.3"

    defaultConfig {
        applicationId "com.didachuxing.taxi.myapplication"
        minSdkVersion 16
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {

    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.material:material:1.2.1'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.1'
    testImplementation 'junit:junit:4.+'
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
}

主要分为plugins,android和dependencies三个部分。

  1. plugin:声明要引入的插件
  2. android:声明Android工程相关的配置
  3. dependencies:声明当前Module的依赖库。

Android中Gradle插件常见的有三个:

  1. APP应用工程:com.android.application,用来生成可运行的apk应用。
  2. Library库工程:com.android.library,用来生成AAR包给其他的APP工程公用。
  3. Test测试工程:com.android.test,对APP应用工程或者Library库工程进行单元测试。

本次我们的用来设置Module库独立运行主要是针对这个插件配置进行调整。

二、独立Module运行

要使得Module模块能够独立运行,需要将当前Module的Gradle插件设置为APP工程,并将其他的Module的Gradle插件设置为lib即可。

具体的操作可以参考如下步骤:

1. gradle.properties中配置模块控制

在项目根目录下的gradle.properties文件中配置需要独立执行的Module名称。

如下所示,配置需要运行的名称runModule,如果需要运行的模块是app,则取值为app,如果需要运行的模块是singlework,则取值为singlework。

#控制运行哪个模块(app:运行app模块 singlework:运行singleWork模块
runModule=singlework

2. setting中配置需要运行的模块

setting中配置的是可以运行的Module模块,我们也可以根据运行的模块来自定义我们需要运行的Module文件。

如下所示,在运行singlework模块时,我们选择只运行singlework Module;在运行app Module时,我们将其他的Module全部引入,示例如下:

if (String.valueOf(runModule) == "singlework") {
    include ':singlework'
} else {
    include ':apt_lib'
    include ':common'
    include ':annotationTest'
    include ':processorTest'
    include ':app'
}
rootProject.name = "DemoWork1"

3. singlework Module的build.gradle文件配置

和settings中的配置类似,在singlework中的配置我们也可以进行设置,当选择运行singlework模块时,我们将当前的Gradle插件置为APP;当选择运行app模块时,我们将当前的Gradle插件置位lib,示例代码如下:

if (String.valueOf(runModule) == "singlework") {
    apply plugin: 'com.android.application'
} else {
    apply plugin: 'com.android.library'
}
apply plugin: 'kotlin-android'
apply plugin: 'kotlin-kapt'

android {
    compileSdkVersion 30
    buildToolsVersion "30.0.3"

    defaultConfig {
        if (String.valueOf(runModule) == "singlework") {
            applicationId "com.example.demowork1"       //当为运行module时才有applicationId属性,可以做到不同Module的APP在手机桌面上共存显示
        }
        ...
    }
    ...
}

4.app Module的build.gradle文件配置

和上一步中的配置类似,更新在app Module中的配置文件,示例代码如下:

if (String.valueOf(runModule) == "singlework") {
    apply plugin: 'com.android.library'
} else {
    apply plugin: 'com.android.application'
}

apply plugin: 'kotlin-android'
apply plugin: 'kotlin-kapt'
apply plugin: 'com.google.protobuf'

android {
    compileSdkVersion rootProject.ext.android["compileSdkVersion"]
    buildToolsVersion rootProject.ext.android["buildToolsVersion"]

    defaultConfig {
        if (String.valueOf(runModule) == "app") {
            applicationId "com.example.demowork1"
        }
    ...
    }
...
}

完成了上述步骤之后,此时可以通过修改gradle.properities文件中的参数来调整运行哪一个Module。

总结

通过修改gradle配置可以调整我们要运行的Module,这对于我们的组件化开发和调试有着极大的便利。

你可能感兴趣的:(Android独立Module运行)