欢迎阅读全新的 MAD Skills 系列之 Gradle 及 Android Gradle plugin API 的第一篇文章。我们将在本文中了解 Android 构建系统的工作方式以及 Gradle 的基础知识。

• Gradle
  https://gradle.org/

• Android Gradle plugin API
  https://developer.android.google.cn/reference/tools/gradle-api

通过了解构建阶段的工作原理及配置 Android Gradle plugin 的配置方法，可以帮您基于项目的需求自定义构建。让我们回到 Android Studio，一起看看构建系统是如何工作的吧。

△ Android 项目结构与 build.gradle 及 settings.gradle 文件

由于插件的存在，Gradle 可以处理不同类型的项目，比如 Android 或 Java。这些插件会包含预定义的功能，用于配置和构建特定类型的项目。

例如，为了构建 Android 项目，您需要使用 Android Gradle 插件配置您的 Gradle 构建文件。无论当前的 Android 项目是应用还是依赖库，Android Gradle 插件都知道如何对其进行构建和打包。

△ Gradle Task 列表

• Gradle DSL

  https://docs.gradle.org/current/dsl/index.html

典型的 Android 项目会包含一个顶层 Gradle 构建文件。Android 项目中的每个模块又分别有一个 Gradle 构建文件。在示例项目中，我仅有一个应用模块。

在模块层的 build.gradle 文件中，我需要声明和应用构建项目所需的插件。为了让 Gradle 知道我正在构建 Android 项目，我需要应用 com.android.application 或 com.android.library 插件。这两个插件分别定义了如何配置和构建 Android 应用和依赖库。在本例中，我要构建的是 Android 应用项目，所以我需要应用 com.android.application 插件。由于我需要使用 Kotlin，所以在示例中也应用了 kotlin.android 插件。

plugins {   id 'com.android.application'   id 'org.jetbrains.kotlin.android'}

https://developer.android.google.cn/studio/build

android {    compileSdk 31
    defaultConfig {        applicationId "com.example.myapp"        minSdk 21        targetSdk 31        versionCode 1        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"    }
    buildTypes {        release {            minifyEnabled false            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'        }    }    compileOptions {        sourceCompatibility JavaVersion.VERSION_1_8        targetCompatibility JavaVersion.VERSION_1_8    }    kotlinOptions {        jvmTarget = '1.8'    }}

dependencies {    implementation 'androidx.core:core-ktx:1.7.0'   implementation 'com.google.android.material:material:1.4.0'   implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.4.0'   testImplementation 'junit:junit:4.13.2'   androidTestImplementation 'androidx.test.ext:junit:1.1.3'   androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0' }

• Maven
  https://maven.apache.org/

• Ivy
  http://ant.apache.org/ivy/

Gradle 分三个阶段评估和运行构建，分别是 Initialization (初始化)、Configuration (配置) 和 Execution (执行)，更多请参阅 Gradle 文档:

在 Initialization (初始化) 阶段，Gradle 会决定构建中包含哪些项目，并会为每个项目创建 Project 实例。为了决定构建中会包含哪些项目，Gradle 首先会寻找 settings.gradle 来决定此次为单项目构建还是多项目构建。

在 Configuration (配置) 阶段，Gradle 会评估构建项目中包含的所有构建脚本，随后应用插件、使用 DSL 配置构建，并在最后注册 Task，同时惰性注册它们的输入。

需要注意的是，无论您请求执行哪个 Task，配置阶段都会执行。为了保持您的构建简洁高效，请避免在配置阶段执行任何耗时操作。

最后，在 Execution (执行) 阶段，Gradle 会执行构建所需的 Task 集合。

下篇文章中，在编写我们自己的插件时，我们将深入剖析这些阶段。

Gradle DSL 支持使用 Groovy 与 Kotlin 脚本编写构建文件。到目前为止，我都在使用 Groovy DSL 脚本来配置此工程的构建。您可以在下面看到分别由 Kotlin 和 Groovy 编写的相同构建文件。注意 Kotlin 脚本文件名后缀为 ".kts"。

从 Groovy 迁移到 Kotlin 或其他配置脚本的方法，不会改变您执行 Task 的方式。

敬请关注下一篇文章，我们将带您了解如何在编写您自己的插件时，使用 AGP 的 Variant API 来扩展您的构建。

 点击屏末 | 阅读原文 | 即刻了解配置 build 更多内容