Learn Gradle - CH 3 Java 快速入门

上一章（连接）咱们主要对Gradle的脚本进行了简要的介绍，本章咱们将继续学习Gradle的另一个特性——插件（plugins）。

一、插件介绍

插件是对Gradle功能的扩展，Gradle有着丰富的插件，你能够在这里搜索相关插件（传送门）。本章将简要介绍Gradle的Java插件（Java plugin），这个插件会给你的构建项目添加一些任务，好比编译java类、执行单元测试和将编译的class文件打包成jar文件等。

Java插件是基于约定的（约定优于配置），它在项目的不少方面定义了默认值，例如，Java源文件应该位于什么位置。咱们只要遵循插件的约定，就不须要在Gradle配置脚本进行额外的相关配置。固然，在某些状况下，你的项目不想或不能遵循这个约定也是能够的，这样你就须要额外的配置你的构建脚本。

Gradle Java插件对于项目文件存放的默认位置与maven相似。

Java源码存放在目录：src/main/java

Java测试代码存放目录：src/test/java

资源文件存放目录：src/main/resources

测试相关资源文件存放目录：src/test/resources

全部输出文件位于目录：build

输出的jar文件位于目录：build/libs

二、一个简单的Java项目

新建一个文件build.gradle，添加代码：

apply plugin: 'java'

以上代码即配置java插件到构建脚本中。当执行构建脚本时，它将给项目添加一系列任务。咱们执行：gradle build，来看看输出的结果：

:compileJava UP-TO-DATE
:processResources UP-TO-DATE
:classes UP-TO-DATE
:jar UP-TO-DATE
:assemble UP-TO-DATE
:compileTestJava UP-TO-DATE
:processTestResources UP-TO-DATE
:testClasses UP-TO-DATE
:test UP-TO-DATE
:check UP-TO-DATE
:build UP-TO-DATE

BUILD SUCCESSFUL

根据输出结果能够看出，咱们执行的build这个任务依赖其余任务，好比compileJava等，这就是java插件预先定义好的一系列任务。

你还能够执行一些其余的任务，好比执行：gradle clean，gradle assemble，gradle check等。

gradle clean：删除构建目录以及已经构建完成的文件；

gradle assemble（装配）：编译和打包java代码，可是不会执行单元测试（从上面的任务依赖结果也能够看出来）。若是你应用了其余插件，那么还会完成一下其余动做。例如，若是你应用了War这个插件，那么这个任务将会为你的项目生成war文件。

gradle check：编译且执行测试。与assemble相似，若是你应用了其余包含check任务的插件，例如，Checkstyle插件，那么这个任务将会检查你的项目代码的质量，而且生成检测报告。

若是想知道Gradle当前配置下哪些任务可执行，能够执行：gradle tasks，例如应用了java插件的配置，执行该命令，输出：

:tasks

------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------

Build tasks
-----------
assemble - Assembles the outputs of this project.
build - Assembles and tests this project.
buildDependents - Assembles and tests this project and all projects that depend on it.
buildNeeded - Assembles and tests this project and all projects it depends on.
classes - Assembles classes 'main'.
clean - Deletes the build directory.
jar - Assembles a jar archive containing the main classes.
testClasses - Assembles classes 'test'.

Build Setup tasks
-----------------
init - Initializes a new Gradle build. [incubating]
wrapper - Generates Gradle wrapper files. [incubating]

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

Help tasks
----------
components - Displays the components produced by root project 'learn-gradle'. [incubating]
dependencies - Displays all dependencies declared in root project 'learn-gradle'                                                                                                      .
dependencyInsight - Displays the insight into a specific dependency in root project 'learn-gradle'.
help - Displays a help message.
model - Displays the configuration model of root project 'learn-gradle'. [incubating]
projects - Displays the sub-projects of root project 'learn-gradle'.
properties - Displays the properties of root project 'learn-gradle'.
tasks - Displays the tasks runnable from root project 'learn-gradle'.

Verification tasks
------------------
check - Runs all checks.
test - Runs the unit tests.

Rules
-----
Pattern: clean<TaskName>: Cleans the output files of a task.
Pattern: build<ConfigurationName>: Assembles the artifacts of a configuration.
Pattern: upload<ConfigurationName>: Assembles and uploads the artifacts belonging to a configuration.

To see all tasks and more detail, run gradle tasks --all

To see more detail about a task, run gradle help --task <task>

BUILD SUCCESSFUL

小伙伴们看到这里会不会有疑问，若是在构建脚本中定义了名为tasks的任务，执行会是如何？好奇的小伙伴能够本身试一试噢。事实上，是会覆盖原有的任务的。

三、外部依赖

一般一个Java项目会依赖多个其余项目或jar文件，咱们能够经过配置gradle仓库（repository）告诉gradle从哪里获取须要的依赖，而且gradle还能够配置使用maven仓库。例如，咱们配置gradle使用maven中央仓库，在build.gradle中添加代码：

repositories {
    mavenCentral()
}

接下来，咱们来添加一些依赖。代码示例：

dependencies {
    compile group: 'commons-collections', name: 'commons-collections', version: '3.2'
    testCompile group: 'junit', name: 'junit', version: '4.+'
}

关于依赖，暂时就点这么多。详细能够参考gradle依赖管理基础，也能够关注后续文章。

四、定义项目属性

Java插件会为项目添加一系列的属性，一般状况下，初始的Java项目使用这些默认配置就足够了，咱们不须要进行额外的配置。可是若是默认属性不知足于你的项目，你也能够进行自定义项目的一些信息。例如咱们为项目指定版本号和一些jar manifest信息。

sourceCompatibility = 1.5
version = '1.0'
jar {
    manifest {
        attributes 'Implementation-Title': 'Gradle Quickstart', 'Implementation-Version': version
    }
}

事实上，Java插件添加的一系列任务与咱们以前在脚本中自定义的任务没什么区别，都是很常规的任务。咱们能够随意定制和修改这些任务。例如，设置任务的属性、为任务添加行为、改变任务的依赖，甚至替换已有的任务。例如咱们能够配置Test类型的test任务，当test任务执行的时候，添加一个系统属性。配置脚本以下：

test {
    systemProperties 'property': 'value'
}

另外，与以前提到的“gradle tasks”命令类型，咱们能够经过“gradle properties”来查看当前配置所支持的可配置属性有哪些。

五、将Jar文件发布到仓库

uploadArchives {
    repositories {
       flatDir {
           dirs 'repos'
       }
    }
}

执行gradle uploadArchives，将会把相关jar文件发布到reops仓库中。更多参考：Publishing artifacts

六、构建多个Java项目

假设咱们的项目结构以下所示：

multiproject/
--api/
--services/webservice/
--shared/
--services/shared/

项目api生成jar文件，Java客户端经过jar提供的接口访问web服务；项目services/webservice是一个webapp，提供web服务；项目shared 包含api和webservice公共代码；项目services/shared依赖shared项目，包含webservice公共代码。

接下来，咱们开始定义多项目构建。

1）首先，咱们须要添加一个配置文件：settings.gradle文件。settings.gradle位于项目的根目录，也就是multiproject目录。编辑settings.gradle，输入配置信息：

include "shared", "api", "services:webservice", "services:shared"

include是Gradle DSL定义的核心类型Settings的方法，用于构建指定项目。配置中指定的参数“shared”、“api”等值默认是当前配置目录的目录名称，而“services:webservice”将根据默认约定映射系统物理路径"services/webservice"（相对于根目录）。关于include更详细的信息能够参考：构建树。

2）定义全部子项目公用配置。在根目录建立文件：build.gradle，输入配置信息：

subprojects {
    apply plugin: 'java'
    apply plugin: 'eclipse-wtp'

    repositories {
       mavenCentral()
    }

    dependencies {
        testCompile 'junit:junit:4.12'
    }

    version = '1.0'

    jar {
        manifest.attributes provider: 'gradle'
    }
}

subprojects 是Gradle DSL定义的构建脚本模块之一，用于定义全部子项目的配置信息。在以上配置中，咱们给全部子项目定义了使用“java”和“eclipse-wtp”插件，还定义了仓库、依赖、版本号以及jar（jar是Gradle的任务类型之一，任务是装配jar包，jar任务包含属性manifest，用于描述jar的信息，具体参考：Jar）。

咱们在根目录执行gradle build命令是，这些配置会应用到全部子项目中。

3）给项目添加依赖

新建文件：api/build.gradle，添加配置：

dependencies {
    compile project(':shared')
}

以上，咱们定义了api项目依赖shared项目，当咱们在根目录执行gradle build命令时，gradle会确保在编译api以前，先完成shared项目编译，而后才会编译api项目。

一样，添加services/webservice/build.gradle，添加配置：

dependencies {
    compile project(':services:shared')
}

在根目录执行：gradle compileJava，输出：

:shared:compileJava UP-TO-DATE
:shared:processResources UP-TO-DATE
:shared:classes UP-TO-DATE
:shared:jar UP-TO-DATE
:api:compileJava UP-TO-DATE
:services:compileJava UP-TO-DATE
:services:shared:compileJava UP-TO-DATE
:services:shared:processResources UP-TO-DATE
:services:shared:classes UP-TO-DATE
:services:shared:jar UP-TO-DATE
:services:webservice:compileJava UP-TO-DATE

BUILD SUCCESSFUL

经过输出信息咱们就能够清楚看出依赖配置是否正确啦。本次教程到此结束。

本文是本人初学Gradle所做笔记，是在边学习Gradle边写做的状况下完成，若是错漏，还请看客们勿喷。若能友好指出，共同进步，本人不甚感激。