Android Gradle插件7.x版本引入了全新的构建配置方式，核心变化在于`plugins`块取代了传统的`buildscript`和`apply plugin`语法，实现了插件的集中声明与版本管理。本文将详细阐述项目级`build.gradle`、`settings.gradle`以及模块级`build.gradle`中插件和依赖管理的最新实践，帮助开发者高效适应新版Gradle构建系统。
Android Gradle插件7.x版本构建配置概述
随着Android Gradle插件（AGP）演进到7.x版本，Gradle构建文件的结构和语法发生了显著变化，旨在提供更清晰、更可维护的构建配置。最核心的改变是引入了顶层plugins块，用于声明和管理项目所需的所有Gradle插件及其版本。这一机制取代了以往在buildscript块中声明classpath依赖，并在后续使用apply plugin应用插件的方式。
项目级build.gradle文件的演变
在旧版本的Gradle配置中，项目根目录下的build.gradle文件通常包含一个buildscript块，用于声明构建工具的classpath依赖，例如AGP本身。随后，通过apply plugin语句将插件应用到项目。
旧版示例：
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:X.X.X' // AGP版本
}
}
// apply plugin: 'com.android.application' // 在模块级文件应用而在AGP 7.x及更高版本中，项目根目录的build.gradle文件采用了新的plugins块来集中声明所有插件及其版本。
新版示例：
// project-level build.gradle
plugins {
id 'com.android.application' version '7.3.1' apply false
id 'com.android.library' version '7.3.1' apply false
id 'org.jetbrains.kotlin.android' version '1.7.20' apply false
}这里需要注意apply false关键字。它表示该插件的声明只是将其添加到Gradle的类路径中，但并不会立即将其应用到当前项目。这种机制特别适用于根项目，允许开发者在一个中心位置声明所有插件及其版本，而实际的应用则发生在各个模块的build.gradle文件中。
settings.gradle文件中的插件与依赖管理
settings.gradle文件在新的构建系统中扮演着至关重要的角色，它负责管理整个项目的插件和模块依赖的仓库配置。
插件仓库管理 (pluginManagement)
为了让Gradle能够找到在plugins块中声明的插件，我们需要在settings.gradle中配置插件的查找仓库。这通过pluginManagement块实现。
// settings.gradle
pluginManagement {
repositories {
gradlePluginPortal() // Gradle插件门户
google() // Google Maven仓库
mavenCentral() // Maven Central仓库
}
}开发者可以在此块中添加其他自定义的插件仓库。
模块依赖仓库管理 (dependencyResolutionManagement)
除了插件，模块的普通依赖（如implementation 'androidx.core:core-ktx:1.7.0'）也需要从特定的仓库中解析。settings.gradle中的dependencyResolutionManagement块用于集中配置这些依赖的仓库。
// settings.gradle
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) // 推荐设置，强制所有模块使用此处定义的仓库
repositories {
google()
mavenCentral()
}
}repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)是一个推荐的设置，它强制所有模块使用在此处定义的仓库，如果模块尝试定义自己的仓库而未在此处声明，则会导致构建失败。这有助于统一和简化整个项目的依赖管理。
模块级build.gradle文件的配置
在每个Android模块（例如app模块或library模块）的build.gradle文件中，我们主要关注两件事：应用插件和声明模块依赖。
应用插件
在模块级的build.gradle文件中，我们通过简化的plugins块来应用在根项目或settings.gradle中已经声明的插件。这里不需要指定version或apply false，因为版本信息已在根项目统一管理。
// app/build.gradle (module-level)
plugins {
id 'com.android.application' // 应用AGP
id 'org.jetbrains.kotlin.android' // 应用Kotlin插件
}声明模块依赖
模块的外部库依赖仍然在dependencies块中声明，这与旧版本保持一致。
// app/build.gradle (module-level)
dependencies {
implementation 'androidx.core:core-ktx:1.7.0'
implementation 'androidx.appcompat:appcompat:1.4.1'
// 其他依赖...
}虽然模块级的build.gradle文件也可以包含repositories块，但为了保持一致性和简化管理，强烈建议通过settings.gradle中的dependencyResolutionManagement来统一配置所有模块的依赖仓库。
总结与注意事项
Android Gradle插件7.x版本带来的构建配置变化是Gradle生态系统发展的重要一步。通过引入顶层plugins块和增强settings.gradle的功能，实现了插件和依赖管理的集中化与标准化。
- 集中化管理： 插件版本在项目根build.gradle中统一声明，依赖仓库在settings.gradle中统一配置。
- 清晰的职责分离： 根build.gradle负责插件声明，settings.gradle负责仓库管理，模块build.gradle负责插件应用和依赖声明。
- 提高可维护性： 减少了重复配置，降低了版本冲突的风险，使大型项目的构建配置更加清晰。
开发者应熟悉这些新变化，并根据新的最佳实践来配置其Android项目，以确保构建过程的高效和稳定。在迁移旧项目时，务必仔细检查并更新所有相关的Gradle文件，以符合AGP 7.x的要求。
