Gradle Java 插件

由 珍珍阿姨 创建，youj 最后一次修改 2016-08-12 Java 插件 Java 插件向一个项目添加了 Java 编译、 测试和 bundling 的能力。它是很多其他 Gradle 插件的基础服务。 用法 要使用 Java 插件，请在构建脚本中加入： 使用 Java 插件 build.gradleapply plugin: 'java' 源集 Java 插件引入了一个源集的概念。一个源集只是一组用于编译并一起执行的源文件。这些源文件可能包括 Java 源代码文件和资源文件。其他有一些插件添加了在源集里包含 Groovy 和 Scala 的源代码文件的能力。一个源集有一个相关联的编译类路径和运行时类路径。 源集的一个用途是，把源文件进行逻辑上的分组，以描述它们的目的。例如，你可能会使用一个源集来定义一个集成测试套件，或者你可能会使用单独的源集来定义你的项目的 API 和实现类。 Java 插件定义了两个标准的源集，分别是 main 和 test。main 源集包含你产品的源代码，它们将被编译并组装成一个 JAR 文件。test 源集包含你的单元测试的源代码，它们将被编译并使用 JUnit 或 TestNG 来执行。 任务 Java 插件向你的项目添加了大量的任务，如下所示。 表 23.1. Java 插件-任务 任务名称 依赖于 类型 描述 compileJava 产生编译类路径中的所有任务。这包括了用于jar任务。 JavaCompile 使用 javac 编译产品中的 Java 源文件。 processResources - Copy 把生产资源文件拷贝到生产的类目录中。 classes processResources。一些插件添加了额外的编译任务。 Task 组装生产的类目录。 compileTestJava compile，再加上所有能产生测试编译类路径的任务。 JavaCompile 使用 javac 编译 Java 的测试源文件。 processTestResources - Copy 把测试的资源文件拷贝到测试的类目录中。 testClasses processTestResources。一些插件添加了额外的测试编译任务。 Task 组装测试的类目录。 jar compile Jar 组装 JAR 文件 javadoc compile Javadoc 使用 Javadoc 生成生产的 Java 源代码的API文档 test compileTest，再加上所有产生测试运行时类路径的任务。 Test 使用 JUnit 或 TestNG运行单元测试。 uploadArchives 使用jar。 Upload 使用archives配置上传包括 JAR 文件的构件。 clean - Delete 删除项目的 build 目录。 TaskName - Delete 删除由指定的任务所产生的输出文件。例如， jar任务中所创建的 JAR 文件，test任务所创建的测试结果。 对于每个你添加到该项目中的源集，Java 插件将添加以下的编译任务： 表 23.2. Java 插件-源集任务 任务名称 依赖于 类型 描述 SourceSetJava 所有产生源集编译类路径的任务。 JavaCompile 使用 javac 编译给定的源集中的 Java 源文件。 SourceSetResources - Copy 把给定的源集的资源文件拷贝到类目录中。 sourceSetClasses SourceSetResources。某些插件还为源集添加了额外的编译任务。 Task 组装给定源集的类目录。 Java 插件还增加了大量的任务构成该项目的生命周期： 表 23.3. Java 插件-生命周期任务 任务名称 依赖于 类型 描述 assemble 项目中的所有归档项目，包括jar任务。某些插件还向项目添加额外的归档任务。 Task 组装项目中所有的归类文件。 check 项目中的所有核查项目，包括test任务。某些插件还向项目添加额外的核查任务。 Task 执行项目中所有的核查任务。 build assemble Task 执行项目的完事构建。 buildNeeded build任务。