构建生命周期：初始化、配置、执行三阶段详解

Gradle 的构建过程，说白了就是跑三个固定的阶段。很多人写脚本时把代码都塞在一个 doLast 里完事，其实根本不知道 Gradle 在背后帮你干了多少事。

我第一次深入理解生命周期，是因为一个线上问题——配置阶段里跑了一个网络请求，导致每次执行 gradle tasks 都要等十几秒。嗯，那之后我才认真把这三个阶段掰扯清楚。

三阶段概览

阶段一：初始化 (Initialization)

这个阶段最容易被忽视。说白了，Gradle 要先搞清楚「这个项目到底有多大」。它从根目录开始寻找 settings.gradle 文件，然后决定哪些模块要参与构建。

具体流程：

1. 寻找并解析 settings.gradle 文件
2. 根据 include 语句创建 Project 对象
3. 确定根项目是谁，子项目有哪些

初始化阶段可以用的钩子：

• settingsEvaluated —— settings.gradle 解析完毕
• projectsLoaded —— 所有 Project 对象已创建

阶段二：配置 (Configuration)

这是我最想提醒大家注意的阶段。配置阶段会执行每个项目的 build.gradle 文件，构建出完整的 Task 依赖图。

我之前在一个大型 Android 项目里，发现构建要等 20 秒才开始跑任务。一查，配置阶段里有个插件在做大量反射扫描。我建议你把耗时的操作尽量延迟到执行阶段。

配置阶段做的事：

• 执行 build.gradle 中的脚本语句
• 注册所有 Task 对象
• 构建 Task 依赖网络
• 调用 afterEvaluate 等配置钩子

// 配置阶段执行的代码 —— 每次构建都会跑
tasks.register('myTask') {
    // 这里的代码在配置阶段执行
    println "我在配置阶段就被执行了"
    
    doLast {
        // 这里的代码在执行阶段执行
        println "我直到执行阶段才会跑"
    }
}

常用钩子一览：

阶段三：执行 (Execution)

执行阶段才是真正干活的阶段。只有这个阶段会运行 Task 的 actions，也就是 doFirst、doLast 里的逻辑。

执行阶段的规则：

• 只会执行用户指定的 Task（即命令行里输入的编译/测试等）
• 按照 Task 依赖顺序执行
• 如果一个 Task 没有被依赖或者没有被指定，它就不会执行

// 观察三阶段执行顺序
tasks.register('showOrder') {
    doFirst {
        println "执行阶段 —— doFirst"
    }
    doLast {
        println "执行阶段 —— doLast"
    }
    println "配置阶段 —— task 注册时"
}

// 输出结果：
// 配置阶段 —— task 注册时
// 执行阶段 —— doFirst
// 执行阶段 —— doLast

生命周期钩子实战

掌握了三阶段，我们就能精准地在正确的时间点插入逻辑。

常用的 Project 级别钩子：

// 在项目配置开始前 → 初始化阶段最有用
gradle.beforeProject {
    println "即将配置项目：${it.name}"
}

// 在项目配置结束后 → 配置阶段最常用
afterEvaluate {
    println "${project.name} 配置完毕，task 数量: ${tasks.size()}"
}

// 所有项目配置完成 → 跨模块整合
gradle.projectsEvaluated {
    println "所有子项目都配置好了，可以检查依赖一致性了"
}

Task 级别钩子：

// 为某个特定 task 添加前置动作
tasks.named('compileJava') {
    doFirst {
        println "开始编译 Java 代码..."
    }
    doLast {
        println "编译完成，输出目录: ${destinationDir}"
    }
}

总结：三阶段记忆口诀

搞清楚这三个阶段，你写的 Gradle 脚本会少很多「玄学问题」。以后遇到构建卡顿，先判断是配置阶段耗时还是执行阶段耗时，方向就对了。