插件 -Gradle 2 用户指南集册 - 时代Java，与您同行！

Gradle 在它的核心中有意地提供了一些小但有用的功能，用于在真实世界中的自动化。所有有用的功能，例如以能够编译 Java 代码为例，都是通过插件进行添加的。插件添加了新任务（例如 JavaCompile），域对象（例如 SourceSet ），约定（例如主要的 Java 源代码是位于 src/main/java ），以及扩展的核心对象和其他插件的对象。

在这一章中，我们将讨论如何使用插件以及术语和插件相关的概念。

插件类型

Gradle 一般有两种类型的插件 :script 插件和 binary 插件。script 插件是额外的构建脚本，用于进一步配置构建，以及实现一种声明性方法操纵构建。他们通常用于构建虽然他们可以外部化和从远程位置访问。binary插件的类实现 Plugin 接口,采用的编程方法操纵构建。binary 插件通过项目层次结构或外部插件 jar 驻留在构建脚本中。

应用插件

插件是可以被应用的，通过 Project.apply() 方法来完成。

Script 插件

Example 21.1. Applying a script plugin

build.gradle

    apply from: 'other.gradle'

script 插件可以从本地文件系统或在远程位置的脚本应用。文件位置是相对于项目目录，而远程脚本的位置是一个 HTTP URL 指定。多个脚本插件（或形式）可以应用到一个给定的建立。

核心插件

Example 21.2. Applying a binary plugin

build.gradle

    apply plugin: 'java'

核心插件注册一个简短的名字。在上面的例子中，我们使用短名称“java”来应用 JavaPlugin。插件也有插件ID，以一个完全合格的形式如 com.github.foo.bar，虽然一些遗留的插件还可以利用短期的，不合格的形式。

该方法还可以接受一个类识别插件：

Example 21.3. Applying a binary plugin by type

build.gradle

    apply plugin: JavaPlugin

在上述样本 JavaPlugin 符号就是指 JavaPlugin。这类不需要严格引入 org.gradle.api.plugins 包在所有构建脚本会自动导入（见[Appendix E. Existing IDE Support and how to cope without it 支持的 IDE 以及如何应对没有它](Appendix E. Existing IDE Support and how to cope without it 支持的 IDE 以及如何应对没有它.md)）。此外，不需要追加 .class 来确认这个类是在 Groovy 还是在 Java。

插件的应用是幂等。就是说一个插件，可多次应用。如果插件已被应用，任何进一步的应用将没有任何效果。

关于 binary 插件的位置

一个插件是任意类实现 Plugin 接口。Gradle 提供核心插件为其分配部分简单地应用插件来提供所有你需要做的。然而，非核心 binary 插件需要可用于构建类路径才可以应用。这可以通过很多途径实现，包括：

定义插件为内联类的声明在一个构建脚本。
定义插件作为一个源在项目目录下的文件 buildsrc。
包括从外部罐定义为 buildscript 依赖插件。
包括插件从插件门户使用插件的DSL。

使用 DSL 应用插件

插件 DSL 目前正在酝酿中。请注意,DSL 和其他配置可能会在以后 Gradle 版本改变。

新的插件提供了一个更简洁的 DSL 和方便的方式来声明插件的依赖关系。它的工作原理与新的 Gradle 插件门户提供方便地访问核心和社区插件。插件脚本块配置实例 PluginDependenciesSpec。

申请一个核心插件，可以使用短名称：

Example 21.4. Applying a core plugin

build.gradle

    plugins {
        id 'java'
    }

若门户网站需要一个社区插件，那么必须使用一个完全限定的插件：

Example 21.5. Applying a community plugin

build.gradle

    plugins {
        id "com.jfrog.bintray" version "0.4.1"
    }

不需要进一步配置。具体来说,不需要配置 buildscript 类路径。Gradle 将在插件门户解决插件,找到它,使它可用于构建。

有关更多信息,请参见 PluginDependenciesSpec 使用插件的 DSL。

寻找社区插件

Gradle 至今有一个充满活力的社区插件开发人员贡献为各种功能的插件。Gradle 插件门户提供了一个接口用于搜索和探索社区插件。

插件做啥

把插件应用到项目中可以让插件来扩展项目的功能。它可以做的事情如：

将任务添加到项目（如编译、测试）
使用有用的默认设置对已添加的任务进行预配置。
向项目中添加依赖配置（见“依赖配置”）。
通过扩展对现有类型添加新的属性和方法。

举例

Example 21.6. Tasks added by a plugin

build.gradle

    apply plugin: 'java'

    task show << {
        println relativePath(compileJava.destinationDir)
        println relativePath(processResources.destinationDir)
    }

执行 gradle -q show

    > gradle -q show
    build/classes/main
    build/resources/main

这个 Java 插件增加了 compileJava 任务 processResources 任务到项目中，以及给这两个任务配置 destinationDir 属性。

约定

插件可以通过智能的方法对项目进行预配置以支持约定优于配置。Gradle 对此提供了机制和完善的支持，而它是强大-然而-简洁的构建脚本中的一个关键因素。

在上面的示例中我们看到，Java 插件添加了一个任务，名字为 compileJava ，有一个名为 destinationDir 的属性（即配置编译的 Java 代码存放的地方）。Java 插件默认此属性指向项目目录中的 build/classes/main。这是通过一个合理的默认的约定优于配置的例子。

我们可以简单地通过给它一个新的值来更改此属性。

Example 21.7. Changing plugin defaults

build.gradle

    apply plugin: 'java'

    compileJava.destinationDir = file("$buildDir/output/classes")

    task show << {
        println relativePath(compileJava.destinationDir)
    }

执行 gradle -q show

    > gradle -q show
    build/output/classes

然而， compileJava 任务很可能不是唯一需要知道类文件在哪里的任务。

Java 插件添加了 source sets 的概念（见SourceSet）来描述的源文件集的各个方面，其中一个方面是在编译的时候这些类文件应该被写到哪个地方。Java 插件将 compileJava 任务的 destinationDir 属性映射到源文件集的这一个方面。

我们可以通过这个源码集修改写入类文件的位置。

Example 21.8. Plugin convention object

插件

在这篇文章中：