Gradle用户指南（章7：java插件）

如我们所见，gradle是一个通用的构建工具。它可以构建你关心并实现的构建脚本。它是开箱即用的，然而，它不会构建任何东西除非你在你的构建脚本中添加代码。

大多数java项目都有非常相似的基础操作：编译java源文件，运行单元测试，和创建包含类文件的jar包。如果你不想为每个项目添加这些操作代码，那是非常好的。Gradle用插件解决这个问题。这个插件通常通过以某种方式配置你的项目来扩展它，通过添加一系列预配置的任务来做一些有用的东西。Gradle附带大量的附件，当然，你也可以编写自己的附件并分享给他人。其中一个就是java插件。这个插件给你的项目添加了一些任务:编译、测试你的java源文件并生成jar包。

Java插件是基于约定的。这意味插件在项目的许多方面都定义了默认值，例如java源文件所在的地方。如果在你的项目中遵守这个约定，则一般不需要大量修改你的构建脚本就可以有一个可用的构建。Gradle允许定制插件，如果你不想或者不能遵守约定。事实上，因为对java项目的支持是通过插件实现的，如果你不想，你可以不使用插件来构建一个项目。

我们将在后面的章节中深入了解更多java插件例子，依赖管理，多项目的内容。在本章中，我们只想给你的一个初步的概念：如何使用java插件构建一个java项目。

让我们来看一个简单的例子。使用java插件，添加以下到你的构建文件中:

这是你所有需要的来定义一个java项目。这将java插件添加到你的项目中，它将添加需要任务到你的项目中。

Gradle将找到你生产环境下的源代码?src/main/java?和你的测试源代码src/test/java。此外，?src/main/resources下的文件都将被包含在类路径中用于运行测试。所有的输出文件夹都将创建在构建目录下，jar被包含在build/libs目录中。

Java插件添加许多任务到你的项目中。然而你只需要少数任务就可以构建项目。我们最常用的任务是构建任务build task，它对你的项目做了一个完整的构建。当你执行 gradle build ，gradle将编译并测试你的代码，创建一个jar包包含你的主要类和资源。

其他一些有用的任务：

Clean

删除构建目录，删除所有构建文件。

Assemble

代码编译并打包，不运行单元测试。其他插件也可以添加更多操作到这个任务。例如，如果你使用war插件，这个任务也能在你的项目中构建war包。

Check

编译并测试代码。其他插件可以添加更多检查到这个任务。如你使用checkstyle插件，这个任务将对你的代码运行checkstyle检查。

通常，一个java项目将有一些外部依赖jar包。如果在项目中使用这些jar包，你需要告诉gradle如何找到他们。Gradle构件如jar，都被放置在一个仓库中。这个项目可以用来抓取项目依赖项或者发布项目构件，或者兼而有之。这个例子中，我们将使用公共的maven库。

让我们添加一些依赖项。这里我们声明我们的生产有一个编译时类依赖于commons collections,和测试类依赖于junit

你可以在第八章：依赖关系管理中找到更多。

定制项目

Java插件添加一系列属性到你的项目中。这些属性通常在项目开始处赋予默认值。如果他们不适合，我们能非常方便的改变这些值。让我们看下这些示例。这里我们将为项目指定版本号，与我们在源文件中写的版本号一起。我们还将添加一些属性到mainfest中。

Java插件能添加定期任务，就像在构建文件中声明的那样。这意味着你可以使用前面章节展示的任何机制来定制这些任务。例如，你可以定义这些任务的性质，将行为添加到任务，改变任务依赖关系的任务，或者完全替换一个任务。在例子中，我们将配置测试任务，这类型的?Test，执行测试时添加一个系统属性：

现在执行gradle eclipse 命令，生成eclipse项目文件。你可以找到更多关于eclipse在38章?Eclipse插件

在本章中你已经看到你通常建立一个java项目需要做的任务。本章并不详尽，对java项目你还可以做的更多。你可以找到更多java插件?23章,?Java插件?，你也可以找到更多的java项目示例在gradle分布samples/java目录中