通过运行一个任务并查看其输出来了解 Gradle 任务的基础知识。

在本节中,您将:

  • 查看可用任务

  • 运行任务并检查结果

  • 了解任务

  • 探索任务依赖关系

步骤 0. 开始之前

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

步骤 1. 查看可用任务

任务是一个基本工作单元,可以由 Gradle 作为构建的一部分来完成

在该tutorial目录中,输入以下命令列出项目中所有可用的任务:

$ ./gradlew tasks

该列表包括插件贡献的任务application及其应用的插件:

Application tasks
-----------------
run - Runs this project as a JVM application

Build tasks
-----------
assemble - Assembles the outputs of this project.
build - Assembles and tests this project.

...

Documentation tasks
-------------------
javadoc - Generates Javadoc API documentation for the main source code.

...

Other tasks
-----------
compileJava - Compiles main Java source.

...

任务可能负责编译、复制和移动文件、创建 JAR 文件、生成 Javadoc、将工件发布到存储库或许多其他离散的工作单元。

app您还可以通过运行列出仅在子项目中可用的任务./gradlew :app:tasks

您可以使用以下选项在任务列表中获取更多信息--all./gradlew tasks --all

在本教程的第 1 部分build中,我们使用./gradlew build命令运行任务。

第 2 步:了解任务

我们列出了项目初始化时可用的任务,但是如果我们想创建自己的任务怎么办?

Gradle 提供了许多内置任务,开发人员可以使用它们来增强构建脚本。

此示例任务使用内置任务将*.war文件从source目录复制到目录。targetCopy

tasks.register<Copy>("copyTask") {
    from("source")
    into("target")
    include("*.war")
}
tasks.register(Copy, "copyTask") {
    from("source")
    into("target")
    include("*.war")
}

如果将该任务添加到子项目目录build.gradle(.kts)中的文件中app,则将使用命令 执行该任务./gradlew :app:copyTask

流行的内置任务包括:

  • 复制-Copy对于复制文件很有用。

  • 删除-Delete对于删除文件和目录很有用。

  • Exec -Exec对于执行任意操作系统命令很有用。

  • Zip -Zip对于捆绑文件很有用。

Kotlin 和 Groovy DSL 中还记录了更多内容。

步骤 3. 了解任务之间的依赖关系

很多时候,一个任务需要先运行另一个任务。如果任务 B 使用任务 A 的输出,则任务 A 必须在任务 B 开始之前完成。

  • 任务可以显式声明其依赖关系。

  • 一个任务可能隐式地依赖于其他任务。

以下是显式任务依赖性的示例:

tasks.register("hello") {
    doLast {
        println('Hello!')
    }
}

tasks.register("greet") {
    doLast {
        println('How are you?')
    }
    dependsOn("hello")
}
tasks.register("hello") {
    doLast {
        println('Hello!')
    }
}

tasks.register("greet") {
    doLast {
        println('How are you?')
    }
    dependsOn("hello")
}

在这种情况下,hello在 之前打印greet。输出是Hello! How are you?.

任务执行顺序由 Gradle 自动确定,同时考虑显式和隐式任务依赖性。如果任务之间不存在依赖关系,Gradle 允许用户请求特定的执行顺序。

步骤 4. 在 IDE 中查看任务

IntelliJ 中也提供了项目任务。该项目应该在教程的第 1 部分之后打开。

在窗口的右侧,打开窗格Gradle

intellij idea 任务

步骤 5. 在 IDE 中运行任务

您可以通过双击窗格中的任务来通过 IntelliJ 运行 Gradle 任务。

双击教程 > 应用 > 构建 > 构建

intellij 理念构建

构建完成后,确保在 IntelliJ 控制台中成功:

BUILD SUCCESSFUL in 966ms
7 actionable tasks: 7 executed
3:18:24 AM: Execution finished 'build'.

步骤 6. 在终端中运行任务

在终端中运行以下命令:

$ ./gradlew build
> Task :app:compileJava
> Task :app:processResources
> Task :app:classes
> Task :app:jar
> Task :app:startScripts
> Task :app:distTar
> Task :app:distZip
> Task :app:assemble
> Task :app:compileTestJava
> Task :app:processTestResources
> Task :app:testClasses
> Task :app:test
> Task :app:check
> Task :app:build

build任务使用源代码及其依赖项来构建应用程序。从输出中可以看出,该build任务编译、汇编、测试和检查代码。

任务按执行顺序打印。任务jar是任务的依赖项build

jar任务创建应用程序的可执行 JAR 文件。让我们单独运行它:

$ ./gradlew jar
> Task :app:compileJava
> Task :app:processResources
> Task :app:classes
> Task :app:jar

正如预期的那样,该compileJava任务是该任务的依赖项jar并且首先执行。任务完成后,app.jar将在您的文件夹中创建一个文件tutorial/app/build/libs/

调用run任务并检查输出:

$ ./gradlew run
> Task :app:compileJava
> Task :app:processResources
> Task :app:classes

> Task :app:run
Hello World!

BUILD SUCCESSFUL in 325ms

run任务执行 中的代码tutorial/app/src/main/java/com.gradle.tutorial/App.java。 Java 代码App.java只是将“Hello World”打印到屏幕上:

public class App {
    public String getGreeting() {
        return "Hello World!";
    }
    public static void main(String[] args) {
        System.out.println(new App().getGreeting());
    }
}

下一步: 依赖管理>>