这是你所有需要的来定义一个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,执行测试时添加一个系统属性:
发布jar文件
通常我们需要发布jar包。要做到这一点,你需要告诉gradle在哪里发布这些jar文件。在gradle,构件发布到仓库中。示例中,我们发布到本地仓库中。你也可以发布到远程位置或者多个位置。
发布jar包,运行 gradle uploadArchives
创建eclipse项目
创建eclipse-specific特性描述符文件,如.project,你需要添加另一个插件到你的构建文件中。
现在执行gradle eclipse 命令,生成eclipse项目文件。你可以找到更多关于eclipse在38章Eclipse插件
总结
这里是完整的构建文件示例: