Gradle：Android构建系统的本质与build.gradle
Gradle是一个构建系统，可自动完成Android应用程序的编译、测试和打包。与Apache Ant或Maven不同，它支持增量构建和结果缓存。更多功能详情请阅读Gradle官方文档。自2013年起，该工具被用作Android Studio中Android项目的标准构建系统。
要点
- Gradle — 自2013年起成为Android标准构建系统，取代了Ant和Maven
- Build.gradle.kts 基于Kotlin DSL — 带类型检查的现代配置标准
- 构建变体 组合构建类型和产品风味以为应用程序的不同版本提供服务
- 插件 扩展功能：从应用Android工具到发布构建
- 增量构建 和缓存将重新编译时间缩短数倍
什么是Gradle？
Gradle是一个用Java编写的开源构建自动化工具，运行在JVM上。它接收源代码、依赖项和资源作为输入，并输出一个完整的应用程序——Android的APK或AAB。Gradle的核心是基于任务的有向无环图（DAG）概念，其中每个任务是一个原子工作单元，它们之间的连接决定了执行顺序。与Make或Ant不同，Gradle不需要手动描述步骤顺序：只需声明任务之间的依赖关系，系统就会自行构建最佳顺序。这种方法使Gradle对于任何规模的项目都具有灵活性和可扩展性。
该系统使用三个执行阶段：初始化（确定参与的项目）、配置（构建任务图）和执行（按正确顺序启动任务）。配置阶段是Gradle的关键区别：整个构建脚本在任务启动之前执行，从而允许根据条件动态更改图。这提供了例如只为某些构建变体添加任务而无需重复代码的能力。构建器是用Groovy编写的，但配置文件支持两种语言：Groovy DSL和Kotlin DSL。
Gradle如何管理Android项目的构建？
Android的Gradle插件——com.android.application和com.android.library——为项目添加了使用Android工具的任务。当开发者启动构建时，Gradle会依次执行数十个任务：通过javac或kotlinc编译Kotlin和Java，通过AAPT2处理资源，生成R.java，通过D8或R8将字节码编译为DEX，签名和压缩APK。每个任务检查其输入数据是否已更改，如果没有——则使用缓存的结果。这种机制称为增量构建，与完全重新构建相比，可将重新编译速度提高60–80%。
Android模块的配置在build.gradle.kts文件的android块中设置。在块内部，定义了compileSdk、minSdk、targetSdk、应用程序版本、签名和其他参数。Gradle自动为每个模块创建多个构建变体——类型（release，debug）和风味的组合。例如，对于具有两种风味和两种类型的模块，Gradle生成四个任务：assembleDemoDebug、assembleDemoRelease、assembleFullDebug、assembleFullRelease。所有这些任务可以单独执行，也可以通过一个命令同时为所有变体启动。
Build.gradle和build.gradle.kts：配置结构
每个Android项目包含两个配置级别：根build.gradle.kts（适用于所有模块的设置）和模块build.gradle.kts（适用于特定模块的设置）。在根文件中，声明不应用的插件、仓库和公共变量。在模块文件中，插件应用于特定模块并配置构建参数。这种方法允许通过版本目录或ext块集中管理依赖版本。
Kotlin
@Suppress("UnstableApiUsage")
plugins {
id("com.android.application") version "8.2.2"
id("org.jetbrains.kotlin.android") version "1.9.22"
}
android {
namespace = "com.example.myapp"
compileSdk = 34
defaultConfig {
applicationId = "com.example.myapp"
minSdk = 24
targetSdk = 34
versionCode = 1
versionName = "1.0"
}
}dependencies块——build.gradle.kts的另一个关键元素。它列出了应用程序所需的库、模块和文件依赖项。Gradle支持多种依赖配置：implementation（仅对当前模块可用）、api（对依赖模块也可用）、testImplementation（仅用于测试）、androidTestImplementation（用于仪器化测试）和compileOnly（仅在编译阶段）。每个配置管理依赖图中类的可见性，这会影响构建时间和最终构件的大小。
Kotlin
dependencies {
implementation("androidx.core:core-ktx:1.12.0")
implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.7.0")
implementation("androidx.activity:activity-compose:1.8.2")
testImplementation("junit:junit:4.13.2")
androidTestImplementation("androidx.test.ext:junit:1.1.5")
}构建变体：应用程序的构建版本
构建变体——是构建类型和产品风味的组合，定义了具有独特设置、代码和资源的应用程序版本。构建类型确定打包参数：debug（带调试和.debug后缀）或release（带混淆和签名）。产品风味确定功能变体：例如，demo（有限版本）和full（具有额外功能的完整版本）。Gradle自动为每个组合生成任务，允许通过一个命令构建所有版本。
Kotlin
android {
buildTypes {
release {
isMinifyEnabled = true
proguardFiles(
getDefaultProguardFile("proguard-android-optimize.txt"),
"proguard-rules.pro"
)
}
debug {
applicationIdSuffix = ".debug"
}
}
flavorDimensions += "version"
productFlavors {
create("demo") {
dimension = "version"
applicationIdSuffix = ".demo"
}
create("full") {
dimension = "version"
applicationIdSuffix = ".full"
}
}
}每个构建变体对应一个单独的源集。Gradle使用src/demo/release、src/full/debug等目录，其中存储了特定变体的独特资源、清单和源代码。公共代码保留在src/main中。这种方法允许重用主要逻辑并仅替换不同的部分：字符串、图标、API端点或配置文件。源集可以覆盖main中的任何资源：清单、drawable、values甚至Kotlin类。在构建特定变体时，Gradle合并来自main和相应源集的文件，其中来自变体的文件具有优先级。
Android的Gradle插件：扩展功能
Gradle插件生态系统涵盖了Android应用程序开发的所有阶段。Google的官方插件包括com.android.application（用于应用程序模块）、com.android.library（用于库模块）、com.android.test（用于测试模块）和JetBrains的Kotlin插件。插件向项目添加新任务，用新的配置块扩展DSL，并连接其他工具。没有com.android.application插件，项目无法构建APK：此插件注册所有Android特定任务并将它们连接到构建图中。
第三方插件解决更具体的任务。Google Services（com.google.gms.google-services）集成Firebase和Google Play Services，自动将google-services.json添加到构建中。Hilt（dagger.hilt.android.plugin）在编译阶段生成依赖注入代码。Safe Args（androidx.navigation.safeargs.kotlin）创建用于Fragment之间导航的类型安全类。每个插件通过根build.gradle.kts中的plugins块连接，通常只需要最少的配置。Gradle自动解决插件之间的传递依赖关系，并通过Bom文件和版本目录保证版本兼容性。
Gradle任务：构建流程自动化
任务——是Gradle中的原子工作单元。每个任务都有输入数据、输出数据和操作。Android的内置任务包括assemble（构建所有变体）、lint（代码检查）、test（运行单元测试）和clean（清理临时文件）。开发者可以使用Groovy或Kotlin DSL添加自己的任务。自定义任务对于自动化日常操作非常有用：生成报告、复制构件、部署到测试设备或与CI系统集成。
Kotlin
tasks.register("printBuildInfo") {
description = "显示关于构建的信息"
group = "custom"
doLast {
println("Build variant: ${project.name}")
println("Version: ${android.defaultConfig.versionName}")
}
}每个任务可以通过dependsOn机制依赖其他任务。如果任务A依赖于任务B，Gradle保证B在A之前执行。系统不需要为每对手动指定顺序——只需声明依赖关系，Gradle就会构建一个有向图，针对独立任务的并行执行进行了优化。Android插件的内置任务已经相互关联：lint依赖于编译，test依赖于assemble，assembleDebug依赖于compileDebugKotlin。开发者可以使用dependsOn、mustRunAfter或shouldRunAfter将自己的任务嵌入到图的任何节点中。
使用Gradle时的常见错误
常见问题之一是依赖版本冲突，当两个库需要相同传递依赖的不同版本时。Gradle报告冲突错误，但并不总是提供自动解决方案。要诊断，请使用命令./gradlew :app:dependencies，它显示完整的依赖树。建议通过resolutionStrategy块强制指定冲突库的版本。另一个常见场景是由于缺乏增量处理而导致构建缓慢。检查所有插件是否已更新，Gradle Daemon是否已启用（org.gradle.daemon=true），以及gradle.properties中是否设置了足够的内存：org.gradle.jvmargs=-Xmx4096m。
缓存问题在更新依赖后出现：Gradle可能使用过时的缓存，构建以错误结束。解决方案——使用--refresh-dependencies标志运行构建或通过./gradlew cleanBuildCache手动清除缓存。第三大常见错误是Android Gradle Plugin（AGP）和Gradle的版本不兼容。每个AGP版本都需要特定的最低Gradle版本。兼容性表发布在developer.android.com上。如果版本不兼容，Gradle在配置阶段以错误终止，并显示最低所需版本的消息。始终检查Gradle wrapper版本是否符合AGP要求。
常见问题
用简单的话说，什么是Gradle？
Gradle是一个项目构建的自动化程序。它获取您的Kotlin或Java源代码，从互联网连接库，将所有内容编译为字节码并打包到APK中。它运行在JVM上，使用声明式脚本而不是手动指令。开发者只需描述规则，其余工作由Gradle自己完成。
build.gradle.kts与build.gradle有何不同？
Build.gradle用Groovy编写——一种具有灵活语法和较少严格性的动态语言。Build.gradle.kts使用Kotlin DSL：强类型、Android Studio中的自动补全和编译阶段的错误检查。Google建议所有新项目使用Kotlin DSL。Groovy文件更易于迁移，但Kotlin文件在维护中更可靠。
如何加速Gradle构建？
启用Gradle Daemon（org.gradle.daemon=true）和并行构建（org.gradle.parallel=true）。通过org.gradle.jvmargs将JVM内存增加到4–8 GB。使用按需项目配置（org.gradle.configureondemand=true）。对于Android项目，配置任务缓存和仅针对所需ABI的构建。在Android Studio中，运行Build Analyzer以找到瓶颈。
Android中的构建变体是什么？
构建变体——是构建类型（例如debug或release）和产品风味（例如demo或full）的组合。每个变体可以有自己的包名、版本、资源和源文件。Gradle自动为每个变体创建单独的构建任务。这允许从一个项目构建应用程序的多个版本。
如何在Gradle中添加依赖？
依赖项在build.gradle.kts文件的dependencies块中添加。写入格式：configuration("group:artifact:version")。例如，implementation("androidx.core:core-ktx:1.12.0")。对于测试，使用testImplementation；对于仪器化测试，使用androidTestImplementation。可以方便地将版本提取到单独的版本目录中，通过libs.versions.toml文件进行管理。
总结
- Gradle — 运行在JVM上并使用DAG任务图的Android标准构建系统
- 增量构建和缓存将重新编译时间减少60–80%
- Kotlin DSL（build.gradle.kts）— 具有自动补全和类型检查的现代配置格式
- 构建变体组合构建类型和产品风味，为每个变体创建单独的源集
- 插件扩展Gradle：从基础Android插件到Firebase、Hilt和Safe Args
- 自定义任务允许自动化构建和集成的任何阶段
- 主要问题 — 版本冲突、构建缓慢以及AGP与Gradle版本的不兼容
我们将开发一款交钥匙移动应用程序
IT Sectr自2017年以来为初创企业和企业打造iOS和Android应用程序。我们将为您提供咨询并提出最佳解决方案。
另请阅读