Gradle Build Lifecycle

我们之前说过，Gradle 的核心是一种基于依赖性编程的语言。在 Gradle 术语中，这意味着您可以定义任务和任务之间的依赖关系。 Gradle 保证这些任务按照其依赖项的顺序执行，并且每个任务只执行一次。这些任务形成了一个有向无环图。有一些构建工具可以在执行任务时建立这样的依赖关系图。在执行任何任务之前，Gradle 构建完整的依赖关系图。这位于 Gradle 的心脏地带，使许多事情成为可能，否则这些事情是不可能实现的。

您的构建脚本配置这个依赖关系图。因此，严格地说，它们是构建配置脚本。

Build phases 构建阶段

一个 Gradle 构建有三个不同的阶段。

Initialization 初始化
Configuration 配置
Execution 执行

Settings file 设置文件

在构建脚本文件旁边，Gradle 定义了一个设置文件。设置文件由 Gradle 通过一个变数命名原则文件夹确定。这个文件的默认名称是 settings.gradle。在本章的后面，我们将解释 Gradle 如何查找设置文件。

设置文件在初始化阶段执行。多项目构建必须在多项目层次结构的根项目中有 settings.gradle 文件。这是必需的，因为设置文件定义了哪些项目正在参与多项目构建(参见创作多项目构建)。对于单项目生成，设置文件是可选的。除了定义所包含的项目之外，您可能还需要它将库添加到构建脚本类路径中(请参见 organizinggradle 项目)。让我们首先用一个单独的项目构建做一些反思:

settings.gradle

println 'This is executed during the initialization phase.'

build.gradle

println 'This is executed during the configuration phase.'

task configured {
    println 'This is also executed during the configuration phase.'
}

task test {
    doLast {
        println 'This is executed during the execution phase.'
    }
}

task testBoth {
    doFirst {
      println 'This is executed first during the execution phase.'
    }
    doLast {
      println 'This is executed last during the execution phase.'
    }
    println 'This is executed during the configuration phase as well.'
}

> gradle test testBoth
This is executed during the initialization phase.

> Configure project :
This is executed during the configuration phase.
This is also executed during the configuration phase.
This is executed during the configuration phase as well.

> Task :test
This is executed during the execution phase.

> Task :testBoth
This is executed first during the execution phase.
This is executed last during the execution phase.

BUILD SUCCESSFUL in 0s
2 actionable tasks: 2 executed

对于生成脚本，属性访问和方法调用被委托给项目对象。类似地，设置文件中的属性访问和方法调用也被委派给设置对象。有关更多信息，请查看 API 文档中的 Settings 类。

Multi-project builds 多项目建设

多项目生成是在 Gradle 的单次执行期间生成多个项目的生成。您必须在设置文件中声明参与多项目生成的项目。关于多项目构建，在本主题的章节中还有很多要说的(请参阅创作多项目构建)。

多项目构建总是由具有单个根的树来表示。树中的每个元素代表一个项目。项目有一条路径，它表示项目在多项目生成树中的位置。在大多数情况下，项目路径与项目在文件系统中的物理位置一致。但是，此行为是可配置的。项目树是在 settings.gradle 文件中创建的。默认情况下，假定设置文件的位置也是根项目的位置。但是您可以在设置文件中重新定义根项目的位置。

Building the tree

在设置文件中，您可以使用一组方法来生成项目树。层次化和扁平化的物理布局得到了特殊的支持。

Hierarchical layouts 分层布局

settings.gradle

include 'project1', 'project2:child', 'project3:child1'

Include 方法将项目路径作为参数。假设项目路径等于相对物理文件系统路径。例如，默认情况下，路径“ services: api”映射到文件夹“ services / api”(相对于项目根目录)。您只需指定树的叶子。这意味着包含服务: 酒店: api 的路径将导致创建3个项目: 服务、服务: 酒店和服务: 酒店: api。关于如何使用项目路径的更多示例可以在 Settings.include (java.lang)的 DSL 文档中找到。 String []).

Flat layouts 平面布局

settings.gradle

includeFlat 'project3', 'project4'

Includeflat 方法将目录名作为参数。这些目录需要作为根项目目录的兄弟目录存在。这些目录的位置被认为是多项目树中根项目的子项目。

Modifying elements of the project tree 修改项目树的元素

在设置文件中创建的多项目树由所谓的项目描述符组成。您可以随时在设置文件中修改这些描述符。要访问描述符，你可以这样做:
settings.gradle

println rootProject.name
println project(':projectA').name

使用此描述符，您可以更改项目的名称、项目目录和生成文件。

settings.gradle

rootProject.name = 'main'
project(':projectA').projectDir = new File(settingsDir, '../my-project-a')
project(':projectA').buildFileName = 'projectA.gradle'