如何使用 gradle 为所有模块定义通用的 android 属性

在大型Android项目中，通常涉及多个模块（比如app模块、library模块等）。为了确保所有模块在构建配置上保持一致性，通常会使用Gradle的优势来定义一些通用的属性。这样做可以简化维护工作，减少重复代码，并确保整个项目在更新依赖或工具版本时保持同步。

步骤一：定义项目级别的build.gradle文件

首先，在项目的根目录下的build.gradle文件中定义通用的属性。这个文件通常被称为项目级别的build.gradle文件。

groovy
// 根目录的 build.gradle 文件

// 定义一些常用的版本号作为变量
ext {
    compileSdkVersion = 31
    minSdkVersion = 21
    targetSdkVersion = 31
    versionCode = 1
    versionName = "1.0"

    // 可以定义其他通用变量
    supportLibVersion = "1.0.0"
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

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

步骤二：在模块的build.gradle文件中引用这些属性

然后，在每个模块的build.gradle文件中，你可以引用在项目级别build.gradle中定义的变量。

groovy
// 模块的 build.gradle 文件

apply plugin: 'com.android.application'

android {
    compileSdkVersion rootProject.ext.compileSdkVersion

    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdkVersion rootProject.ext.targetSdkVersion
        versionCode rootProject.ext.versionCode
        versionName rootProject.ext.versionName
    }

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

dependencies {
    implementation "androidx.appcompat:appcompat:$rootProject.ext.supportLibVersion"
}

实际应用示例：

假设您正在管理一个包含用户接口（app模块）和数据处理（data模块）的项目。您可以在项目级build.gradle中定义所有模块共用的SDK版本和依赖库版本。这样，无论何时需要升级SDK或者库，您只需要在一个地方更新版本号，所有的模块都会自动使用新的版本，这极大地简化了维护工作。

优势总结：

• 一致性保障：确保所有模块在编译SDK版本、目标SDK版本等方面保持一致。
• 维护简化：更新版本或依赖时，只需在一个地方修改。
• 减少错误：减少因配置不一致导致的构建或运行时错误。

通过这种方式，使用Gradle来管理Android项目的多模块构建配置，不仅能提高效率，还能保证构建系统的可维护性和扩展性。