本文深入探讨了android studio dolphin及更高版本中gradle构建配置的变化，重点介绍了`plugins`块如何取代传统的`buildscript`和`apply plugin`语法，以及在项目级`build.gradle`、模块级`build.gradle`和`settings.gradle`文件中如何高效管理插件版本、应用插件和声明依赖项及其仓库，旨在帮助开发者理解并适应新的构建系统。
在Android开发中，Gradle是核心的构建工具。随着Gradle版本和Android Studio的不断演进，其构建脚本的配置方式也在持续更新。对于Android Studio Dolphin及更高版本，开发者可能会注意到项目级的build.gradle文件结构与以往有所不同，这主要是由于Gradle 7.x引入的声明式plugins块取代了传统的buildscript和apply plugin语法。理解这些变化对于高效管理项目构建至关重要。
1. 声明式plugins块：新一代插件管理
过去，我们通常在项目级的build.gradle文件中使用buildscript块来声明Gradle插件的classpath依赖，然后通过apply plugin来应用插件。例如：
// 旧的插件声明方式
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:7.3.1'
classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.20'
}
}
apply plugin: 'com.android.application'
apply plugin: 'org.jetbrains.kotlin.android'而在新的Gradle版本中，这一模式被更为简洁和统一的plugins块所取代。plugins块允许开发者以声明式的方式指定插件ID、版本，并可选择性地控制插件的应用时机。其基本语法如下：
plugins {
id '«plugin id»' version '«plugin version»' [apply «false»]
}其中，apply false是一个关键选项。当在plugins块中声明插件时，如果添加apply false，表示该插件仅被添加到项目的classpath中，而不会立即应用于当前项目。这使得我们可以在根项目（project-level）的build.gradle文件中集中声明所有插件及其版本，而将实际的插件应用推迟到需要使用它们的模块（module-level）中。
例如，一个典型的项目级build.gradle文件可能包含：
// 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
}这表示Android应用插件、Android库插件和Kotlin Android插件的版本被定义为7.3.1和1.7.20，但它们尚未应用于根项目。
2. settings.gradle：插件与依赖仓库的统一管理
在新的Gradle构建系统中，settings.gradle文件扮演了更为重要的角色，它负责管理整个项目的插件和依赖项的仓库配置。
2.1 插件仓库管理 (pluginManagement)
pluginManagement块用于定义Gradle查找和下载插件的仓库。这是所有插件（包括Android Gradle插件、Kotlin Gradle插件等）的来源。
// settings.gradle
pluginManagement {
repositories {
gradlePluginPortal() // Gradle官方插件门户
google() // Google Maven仓库，包含AGP等
mavenCentral() // Maven中央仓库
}
}如果您的项目需要使用来自其他自定义Maven仓库的插件，可以在此块中添加相应的maven { url '...' }声明。
2.2 模块依赖仓库管理 (dependencyResolutionManagement)
除了插件仓库，settings.gradle还通过dependencyResolutionManagement块统一管理所有模块的依赖项仓库。
// settings.gradle
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) // 推荐设置，防止隐式仓库
repositories {
google() // Google Maven仓库，包含AndroidX等
mavenCentral() // Maven中央仓库，包含大量第三方库
}
}repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)是一个重要的最佳实践，它强制所有模块使用在settings.gradle中定义的仓库，防止模块级build.gradle文件随意添加仓库，从而提高构建一致性和安全性。
3. 模块级build.gradle：应用插件与添加依赖
在模块（如app模块或自定义库模块）的build.gradle文件中，我们主要负责应用在项目级声明的插件，并添加该模块特有的依赖项。
3.1 应用插件
由于插件版本已在项目级的build.gradle中集中声明，模块级只需通过插件ID来应用它们：
// app/build.gradle
plugins {
id 'com.android.application' // 应用Android应用插件
id 'org.jetbrains.kotlin.android' // 应用Kotlin Android插件
}3.2 添加模块依赖
模块的特定依赖项仍然在dependencies块中声明，其语法与旧版本保持一致：
// app/build.gradle
dependencies {
implementation 'androidx.core:core-ktx:1.7.0'
implementation 'androidx.appcompat:appcompat:1.6.1'
implementation 'com.google.android.material:material:1.9.0'
// ... 其他依赖
}需要注意的是，如果某个模块需要使用来自settings.gradle中未声明的特定仓库的依赖（通常不推荐，但在某些特殊情况下可能需要），也可以在模块级的build.gradle中添加repositories块。然而，由于dependencyResolutionManagement中的FAIL_ON_PROJECT_REPOS设置，这种做法通常会被阻止，以确保仓库配置的统一性。
// app/build.gradle (不推荐，除非特殊情况且了解其影响)
repositories {
google() // 这里的仓库会与settings.gradle中的合并，但如果settings.gradle设置了FAIL_ON_PROJECT_REPOS则会报错
}总结
Gradle构建系统在Android Studio Dolphin及更高版本中的演变，旨在提供更清晰、更集中的插件和依赖管理方式。核心变化包括：
- plugins块取代旧的buildscript和apply plugin：在项目级build.gradle中集中声明插件版本（使用apply false），在模块级build.gradle中按需应用插件。
- settings.gradle成为配置中心：通过pluginManagement管理插件仓库，通过dependencyResolutionManagement管理所有模块的依赖仓库，推荐使用repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)来强制统一仓库配置。
理解并适应这些变化，将有助于开发者更高效地配置和维护Android项目的构建脚本，提高项目的可维护性和构建性能。
