详解Gradle项目构建的生命周期

作者:黄少存,叩丁狼高级讲师。本文为原创文章,转载请注明出处。      

上一篇咱们已经知道了如何自定义任务了,而且也知道执行任务只需要点击下任务就 ok 了,还有直接写在任务中的代码在执行任意任务时都会被执行. 那为什么这些代码会被执行? 执行的顺序又是怎样的呢?请看一下Gradle 构建的生命周期就明了了.

Gradle 项目构建生命周期

Gradle 的生命周期分三个阶段,初始化阶段,配置阶段,执行阶段.那这三个阶段在做什么事情呢?请看每个阶段的描述

初始化阶段

通过 settings.gradle 判断有哪些项目需要初始化,加载所有需要初始化的项目的build.gradle 文件并为每个项目创建 project 对象

配置阶段

执行各项目下的 build.gradle 脚本,完成 project 的配置,并且构造 Task 任务依赖关系图以便在执行阶段按照依赖关系执行Task.执行task 中的配置代码

配置代码: 配置阶段就需要执行的代码,如下

task configCode{
   println 'config Code'
}

执行阶段

通过配置阶段的 Task 图,按顺序执行需要执行的 任务中的动作代码,就是执行任务中写在 doFirst 或 doLast 中的代码.

动作代码: 任务调用才会执行的代码.

task executeCode << {
   println 'execute Code'
}

以上就是 Gradle 构建项目时的生命周期,由于Gradle 的强大和易配性,如果想在构建的过程中去做一些额外的操作的话可以使用Gradle 自带的钩子方法.以下咱们通过一个图来描述 Gradle 的生命周期和钩子方法.

Gradle 生命周期和钩子方法

详解Gradle项目构建的生命周期

上图表明了Gradle 构建的整个流程,在生命周期的三个阶段中有很多的钩子方法供用户自行覆盖使用.
注意:
1 初始化阶段的钩子方法和 gradle.beforeProject() 只能定义在 setting.gradle 或 init.gradle 脚本中.
执行 build.gradle 时已经有了 project 对象.且执行前就调用了beforeProject钩子方法.

2 gradle.buildStarted() 钩子方法无法执行到.
通过源码得知,在初始化前就已经调用了 buildStarted 方法,所以在初始化阶段无法回调的到.

例子

setting.gradle

rootProject.name = 'gradleWeb'

// 初始化阶段
gradle.settingsEvaluated {
    println '初始化阶段settingsEvaluated'

}
gradle.projectsLoaded  {
    println '初始化阶段 projectsLoaded'
}

// 配置阶段
gradle.beforeProject {
    println '配置阶段 beforeProject'
}

build.gradle

// 自定义任务
task t1 {
    println 't1 configuration'
    doLast {
        println 't1 execute doLast'
    }
    doFirst {
        println 't1 execute doFirst'
    }
}
// 钩子方法
gradle.afterProject {
    println '配置阶段 afterProject'
}
project.beforeEvaluate {
    println '配置阶段 beforeEvaluate'
}
gradle.projectsEvaluated {
    println '配置阶段 projectsEvaluated'
}
project.afterEvaluate {
    println '配置阶段 afterEvaluate'
}
gradle.taskGraph.whenReady {
    println '配置任务 whenReady'
}

// 执行阶段
gradle.taskGraph.beforeTask {
    println "执行阶段 before task"
}
gradle.taskGraph.afterTask {
    println "执行阶段 afterTask "
}
gradle.buildFinished {
    println '构建结束 buildFinished'
}

执行 gradle t1 结果如下

初始化阶段settingsEvaluated
初始化阶段 projectsLoaded

> Configure project :gradleWeb
15:16:02: Executing task 't1'...

初始化阶段 settingsEvaluated
初始化阶段 projectsLoaded

> Configure project :
配置阶段 beforeProject
t1 configuration
配置阶段 afterProject
配置阶段 afterEvaluate
配置阶段 projectsEvaluated
配置任务 whenReady

> Task :t1
执行阶段 before task
t1 execute doFirst
t1 execute doLast
执行阶段 afterTask 

BUILD SUCCESSFUL in 1s
1 actionable task: 1 executed
构建结束 buildFinished
15:16:03: Task execution finished 't1'.

以上就是Gradle 项目构建的生命周期和钩子方法的介绍,这些钩子方法一般使用得少,特殊需求情况下可以使用.
了解了生命周期之后让咱们对 Gradle 有一个更深入的理解.当然Gradle有很多的点值得咱们去学习和研究.比如一个比较重要的点,依赖管理.期待下篇 Gradle 的依赖管理.

详解Gradle项目构建的生命周期