多模块Android应用中Build Types与Flavors的最佳实践

一、核心实现思路：利用Gradle配置共享机制 #

无需在每个模块重复复制Build Types配置，通过Gradle的约定插件或根项目统一配置即可实现复用继承。

1. 约定插件（Convention Plugins）——官方推荐方案 #

适合中大型多模块项目，通过预编译脚本插件统一管理配置：

• 步骤1：在根项目下创建buildSrc目录（Gradle会自动编译该目录下的代码为插件）
• 步骤2：在buildSrc/src/main/kotlin下创建自定义插件类，比如AndroidCommonBuildPlugin.kt：

import com.android.build.api.dsl.ApplicationExtension
import com.android.build.api.dsl.LibraryExtension
import org.gradle.api.Plugin
import org.gradle.api.Project

class AndroidCommonBuildPlugin : Plugin<Project> {
    override fun apply(project: Project) {
        val androidExtension = project.extensions.findByType(ApplicationExtension::class.java)
            ?: project.extensions.findByType(LibraryExtension::class.java)
            ?: return

        androidExtension.buildTypes {
            // 通用Release配置
            getByName("release") {
                isMinifyEnabled = true
                proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
            }
            // 通用Debug配置
            getByName("debug") {
                isDebuggable = true
                applicationIdSuffix = ".debug"
            }
            // 自定义Build Type，复用Release配置后修改差异
            create("staging") {
                initWith(getByName("release"))
                isDebuggable = true
                applicationIdSuffix = ".staging"
            }
        }
    }
}

• 步骤3：在buildSrc/build.gradle.kts中添加依赖：

plugins {
    `kotlin-dsl`
}

repositories {
    google()
    mavenCentral()
}

dependencies {
    implementation("com.android.tools.build:gradle:8.1.0") // 替换为你的AGP版本
}

• 步骤4：在各模块的build.gradle.kts中应用插件：

plugins {
    id("com.android.application") // 或 com.android.library
    id("kotlin-android")
    id("your.package.AndroidCommonBuildPlugin") // 自定义插件的全类名
}

2. 根项目统一配置——轻量方案 #

适合小型项目，直接在根build.gradle.kts中定义通用Build Types：

subprojects {
    afterEvaluate {
        // 给应用模块配置Build Types
        extensions.findByType<ApplicationExtension>()?.apply {
            buildTypes {
                getByName("release") {
                    isMinifyEnabled = true
                }
                getByName("debug") {
                    isDebuggable = true
                }
            }
        }
        // 给库模块配置Build Types
        extensions.findByType<LibraryExtension>()?.apply {
            buildTypes {
                getByName("release") {
                    isMinifyEnabled = true
                }
                getByName("debug") {
                    isDebuggable = true
                }
            }
        }
    }
}

所有子模块会自动继承这些配置，无需重复编写。

二、最佳实践 #

• 统一命名规范：所有模块的Build Types名称保持一致（如debug、release、staging），避免依赖或构建时因名称不匹配出错。
• 差异化配置单独覆盖：若某模块需要特殊配置，直接在该模块的build.gradle.kts中覆盖通用规则：

android {
    buildTypes {
        getByName("release") {
            isMinifyEnabled = false // 该模块单独关闭混淆
        }
    }
}

• 用initWith复用配置：自定义Build Type时，通过initWith继承已有类型的配置，仅修改差异部分，减少冗余。
• 参数统一管理：将Build Types中的可变参数（如applicationIdSuffix）放在根项目的ext属性中，方便全局修改。
• 匹配变体规则：结合Product Flavors使用时，确保所有模块的Flavors和Build Types组合一致，避免变体不兼容。
• 统一依赖版本：所有模块的AGP、Kotlin版本等统一在根settings.gradle.kts中管理，避免版本冲突。

内容的提问来源于stack exchange，提问作者HeyJoe