你好，Gradle！

HoshinoTented

2020-02-15 03:13:33

Tech. & Eng.

前置知识：Java

Gradle 是一种构建工具，可以通过编写脚本来做到依赖管理等等……

目前 Gradle 的脚本所支持的语言有 Groovy 和 Kotlin。

Groovy 支持大部分 Java 语法，所以完全可以把 Groovy 当做 Java 用

Gradle 能做什么

Gradle 是一个很常用的工具，一般用于 JVM 开发，但是 Gradle 提供了插件系统，你可以开发自己的 Gradle 插件来支持其他你需要的语言。

运行一个 Java 程序

既然 Gradle 是一个构建工具，那应当能构建一个普通的项目。

首先通过 gradle init 来创建一个普通的 Gradle 项目，会出现一些选项，这里我们选择：2-3-1-4-<回车>-<回车>

之后会创建一个类似以下类型的项目：

root
  - gradle/                 // Gradle Wrapper 目录
  - src/                    // 源代码目录
      - main/               // 应用代码目录
          - java/           // Java 代码目录
          - resources/      // 应用资源目录
      - test/               // 测试代码目录
          - java/           // Java 测试代码目录
          - resources/      // 测试资源目录
  - build.gradle            // 项目脚本文件
  - settings.gradle         // 项目配置文件
  - gradlew                 // gradlew 文件，用于启动项目级别的 Gradle
  - gradlew.bat             // 同上，用于 Windows 平台

最重要的是 build.gradle 文件，来看看里面有什么：

plugins {
    id 'java'
    id 'application'
}

repositories {
    jcenter()
}

dependencies {
    testImplementation 'junit:junit:4.12'
}

application {
    mainClassName = 'test.App'
}

首先是 plugins { ... }，这个是模块的插件配置代码，比如 id 'java' 就是应用了 java 插件。

接着是 repositories { ... } 块，用于添加远端的依赖源，比如 jcenter 或者是 mavenCentral()。

接下来是 dependencies { ... } 块，用于添加模块的依赖，会从上面配置的依赖源中查找依赖并自动下载。

最后是 application { ... } 块，这是 application 插件的配置代码，mainClassName 字段代表了主类的全限定名，让 application 知道该从哪里启动程序。

说了这么多，该说说怎么启动这个程序了：

./gradlew run

run 是 application 添加的一个 任务（Task），application { ... } 块中的配置会引导这个任务找到主类，然后启动它：

> Task :run
Hello world.

BUILD SUCCESSFUL in 7s
2 actionable tasks: 2 executed

发现输出了 “Hello world.”，我们成功地启动这个程序了！

管理依赖

在实际开发中，通常需要很多第三方库 来避免造轮子，但是去网上找 jar 然后下载下来太麻烦了，怎么办呢？

答案是：使用 Gradle。

假如我们需要 Gson 库（Google 开发的 JSON 解析库），于是可以在 build.gradle 的 dependencies { ... } 块中添加如下代码：

dependencies {
    compile 'com.google.code.gson:gson:2.8.6'
}

如果你曾经用过 Maven，那么这段代码与 Maven 中的：

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.6</version>
</dependency>

是一样的，但是 Gradle 的会更加简洁一些，并且可以通过代码动态控制版本或者是其他的东西。

在这里需要注意一下 compile，Gradle 提供了许多应用依赖的方式：

api 一般用于库项目，而 implementation 一般用于应用项目。

任务系统

除了管理依赖，另一个 Gradle 的功能就是 任务系统 了：

通过 task 创建一个任务：

// Groovy 风格
task hello {                    // 创建一个 “hello” 任务
    println 'hello'             // **配置** 任务

    doLast {                    // 在任务最后执行
        println 'last'  
    }

    doFirst {                   // 在任务一开始执行
        println 'first'
    }
}

// Java 风格
task("hello-java", new Action<Task>() {
    @Override
    void execute(Task task) {
        task.doFirst {
            System.out.println("Hello, Java!");
        }
    }
})

随后可以通过命令 ./gradlew hello 来调用任务

> Configure project :
hello

> Task :hello
first
last

BUILD SUCCESSFUL in 18s
1 actionable task: 1 executed

会输出类似以上内容。

需要注意的是，配置任务在每次调用 root 项目的 build.gradle 时都会执行，即使没有调用 hello 任务：

> ./gradlew hello-java

Configuration on demand is an incubating feature.

> Configure project :
hello

> Task :hello-java
Hello, Java!

BUILD SUCCESSFUL in 3s
1 actionable task: 1 executed

有向无环图

一些任务通常需要依赖其他任务，比如吃东西前需要拿到食物和张嘴：

task tabemono {
    doLast {
        println 'Get Tabemono'
    }
}

task openmouth {
    doLast {
        println 'Opened Mouth'
    }
}

task eat {
    dependsOn tabemono, openmouth           // 使用 dependsOn 函数进行任务依赖

    doLast {
        println 'Oishii!'
    }
}
./gradlew eat

> Configure project :
hello

> Task :openmouth
Opened Mouth

> Task :tabemono
Get Tabemono

> Task :eat
Oishii!

BUILD SUCCESSFUL in 3s
3 actionable tasks: 3 executed

项目的海洋

Gradle 还支持子项目：

root
  - build.gradle                // root 项目的配置文件
  - settings.gradle
  - sub
      - build.gradle            // sub 项目的配置文件

随后在 settings.gradle 中：

include ':sub'          // 导入 sub 项目

sub/build.gradle

task subhello {
    doLast {
        println 'I am a subproject!'
    }
}
> ./gradlew :sub:subhello

> Task :sub:subhello
I am a subproject!

BUILD SUCCESSFUL in 16s
1 actionable task: 1 executed

地图炮

有的时候需要对一堆子项目配置相同的内容，可以使用 subprojects：

build.gradle

plugins {
    id 'java'
}

subprojects {
    apply plugin: 'java'            // plugins 只能在顶层使用，在其他地方需要使用 apply 函数
}

最后

参考：