通过在构建脚本中创建一个简单的任务来学习编写 Gradle 任务的基础知识。

在本部分中，您将

  • 了解任务

  • 为插件创建自定义任务

第 0 步。开始之前

  1. 您在 第 1 部分 中初始化了 Java 应用程序。

  2. 您从 第 2 部分 中了解了 Gradle 构建生命周期。

  3. 您在 第 3 部分 中添加了子项目和单独的构建。

  4. 您在 第 4 部分 中查看了设置文件。

  5. 您在 第 5 部分 中编写了构建脚本。

第 1 步。了解任务

任务是一段可执行的代码，其中包含一系列操作。

操作通过 doFirst{} 和 doLast{} 闭包添加到任务中。

一个任务可以依赖于其他任务。

第 2 步。注册和配置任务

在本教程的早期，我们在 app 构建脚本中注册并配置了 task1

app/build.gradle.kts
tasks.register("task1"){  (1)
    println("REGISTER TASK1: This is executed during the configuration phase")
}

tasks.named("task1"){  (2)
    println("NAMED TASK1: This is executed during the configuration phase")
    doFirst {
        println("NAMED TASK1 - doFirst: This is executed during the execution phase")
    }
    doLast {
        println("NAMED TASK1 - doLast: This is executed during the execution phase")
    }
}
1 你可以使用 register() 方法创建新任务。
2 你可以使用 named() 方法配置现有任务。
app/build.gradle
tasks.register("task1") {  (1)
    println("REGISTER TASK1: This is executed during the configuration phase")
}

tasks.named("task1") {  (2)
    println("NAMED TASK1: This is executed during the configuration phase")
    doFirst {
        println("NAMED TASK1 - doFirst: This is executed during the execution phase")
    }
    doLast {
        println("NAMED TASK1 - doLast: This is executed during the execution phase")
    }
}
1 你可以使用 register() 方法创建新任务。
2 你可以使用 named() 方法配置现有任务。

步骤 3. 创建自定义任务

要创建自定义任务，你必须在 Groovy DSL 中继承 DefaultTask，或在 Kotlin DSL 中继承 DefaultTask。

使用以下代码创建一个名为 LicenseTask 的自定义类，并将其添加到 gradle/license-plugin/plugin/src/main/kotlin/license/LicensePlugin.kt 或 gradle/license-plugin/plugin/src/main/groovy/license/LicensePlugin.groovy 文件的底部

gradle/license-plugin/plugin/src/main/kotlin/license/LicensePlugin.kt
import org.gradle.api.Project
import org.gradle.api.Plugin
import org.gradle.api.DefaultTask
import org.gradle.api.tasks.Input
import org.gradle.api.tasks.TaskAction
import java.io.File
import java.io.InputStream
import java.nio.charset.Charset

class LicensePlugin: Plugin<Project> {
    // Don't change anything here
}

abstract class LicenseTask : DefaultTask() {
    @Input
    val fileName = project.rootDir.toString() + "/license.txt"

    @TaskAction
    fun action() {
        // Read the license text
        val licenseText = File(fileName).readText()
        // Walk the directories looking for java files
        File(project.rootDir.toString()).walk().forEach {
            if (it.extension == "java") {
                // Read the source code
                var ins: InputStream = it.inputStream()
                var content = ins.readBytes().toString(Charset.defaultCharset())
                // Write the license and the source code to the file
                it.writeText(licenseText + content)
            }
        }
    }
}
gradle/license-plugin/plugin/src/main/groovy/license/LicensePlugin.groovy
import org.gradle.api.Project
import org.gradle.api.Plugin
import org.gradle.api.DefaultTask
import org.gradle.api.tasks.Input
import org.gradle.api.tasks.TaskAction

class LicensePlugin implements Plugin<Project> {
    // Don't change anything here
}

abstract class LicenseTask extends DefaultTask {
    @Input
    def fileName = project.rootDir.toString() + "/license.txt"

    @TaskAction
    void action() {
        // Read the license text
        def licenseText = new File(fileName).text
        // Walk the directories looking for java files
        new File(project.rootDir.toString()).eachFileRecurse { file ->
            int lastIndexOf = file.getName().lastIndexOf('.')
            if ((lastIndexOf != -1) && (file.getName().substring(lastIndexOf)) == ".java") {// Read the source code
                def content = file.getText()
                //println(licenseText + '\n' + content)
                // Write the license and the source code to the file
                file.text = licenseText + '\n' + content
            }
        }
    }
}

LicenseTask 类封装了任务操作逻辑，并声明了任务期望的任何输入和输出。

任务操作使用 @TaskAction 进行注释。在内部，逻辑首先查找名为 "license.txt" 的文件。此文件包含 Apache 许可证的文本

license.txt
/*
* Licensed under the Apache License
*/

然后，任务查找扩展名为 .java 的文件并添加许可证头。

该任务有一个输入，即许可证文件名，使用 @Input 进行注释。

Gradle 使用 @Input 注释来确定是否需要运行任务。如果任务以前没有运行，或者自上次执行以来输入值已更改，则 Gradle 将执行该任务。

虽然已经创建了一个自定义类，但它尚未添加到 LicensePlugin 中。目前无法运行 LicenseTask。

你现在能做的就是确保 ./gradlew build 运行时不会失败

$ ./gradlew build

SETTINGS FILE: This is executed during the initialization phase

> Configure project :app
BUILD SCRIPT: This is executed during the configuration phase

BUILD SUCCESSFUL in 1s
13 actionable tasks: 6 executed, 7 up-to-date

下一步： 编写插件 >>