要使用 Groovy 的插件，请在构建脚本中包含以下语句：

apply plugin: 'groovy'

Groovy 的插件向project 中添加了以下任务。

Groovy 的插件向 Java 插件所加入的 tasks 添加了以下的依赖。

图 24.1. Groovy 插件 - tasks

Groovy 的插件会假定项目的布局如表 24.3，“Groovy 插件 - 项目布局”中所示。所有 Groovy 的源目录都可以包含 Groovy和Java 代码。Java 源目录只能包含 Java 源代码。^[11]这些目录不一定得存在或是里面包含有什么内容；Groovy 的插件只会进行编译，而不管它发现什么。

sourceSets {
    main {
        groovy {
            srcDirs = ['src/groovy']
        }
    }

    test {
        groovy {
            srcDirs = ['test/groovy']
        }
    }
}

由于 Gradle 的构建语言基于 Groovy 的，且部分的 Groovy 使用 Groovy 实现，因此 Gradle 已经带有了一个 Groovy 库 （截至 Gradle 1.6所带的 Groovy 库的版本是 1.8.6）。然而，Groovy 项目需要显式地声明一个 Groovy 依赖。这个依赖会在编译和运行的类路径时用到。它还将用于分别获取Groovy 编译器及 Groovydoc 工具。

如果 Groovy 用于production 代码，Groovy 依赖应该添加到compile配置中：

repositories {
    mavenCentral()
}

dependencies {
    compile 'org.codehaus.groovy:groovy-all:2.2.0'
}

如果 Groovy 仅用于测试代码，Groovy 的依赖应该被添加到testCompile配置中：

dependencies {
    testCompile "org.codehaus.groovy:groovy-all:2.2.0"
}

如果要使用 Gradle 所带的 Groovy 库，请声明localGroovy()依赖。注意，不同 Gradle 版本附带的 Groovy 版本不同；因此，声明一个固定的 Groovy 依赖要比使用localGroovy()更安全一些。

dependencies {
    compile localGroovy()
}

Groovy 库不一定得从远程仓库中获取。它也可以获取自本地中可能检入版本控制的lib目录：

repositories {
    flatDir { dirs 'lib' }
}

dependencies {
    compile module('org.codehaus.groovy:groovy:1.6.0') {
        dependency('asm:asm-all:2.2.3')
        dependency('antlr:antlr:2.7.7')
        dependency('commons-cli:commons-cli:1.2')
        module('org.apache.ant:ant:1.9.3') {
            dependencies('org.apache.ant:ant-junit:1.9.3@jar', 'org.apache.ant:ant-launcher:1.9.3')
        }
    }
}

GroovyCompile和Groovydoc tasks 会以两种方式使用 Groovy： 在它们的classpath以及它们的groovyClasspath上。前者用于在源代码中查找类的引用，通常会包含 Groovy 库和其他库。后者用来分别加载和执行 Groovy 编译器和 Groovydoc 工具，并且应该只包含 Groovy 库及其依赖项。

除非显式配置了一个 task 的groovyClasspath ，否则 Groovy（基础）插件会尝试推断该 task 的classpath。以如下方式进行：

Groovy 的插件没有向 project 添加任何的常规属性。

Groovy 的插件向 project 的每一个source set 添加了下列的常规属性。你可以在你的构建脚本中，把这些属性当成是source set 对象中的属性一样使用 （见第 21.3，“公约”）。

这些属性由一个GroovySourceSet 的约定对象提供。

Groovy 的插件还修改了一些 source set 的属性：

Java 插件向 project 里的每个source set 添加了一个JavaCompile task。这个task 的类型继承自JavaCompile task（见第 23.11 节，“CompileJava”）。除非groovyOptions.useAnt设置为true，否则将使用 Gradle 集成的本地的 Groovy 编译器。对于大多数项目而言，这相比基于 Ant 编译器，是个更好的选择。GroovyCompile task 支持官方的 Groovy 编译器的大多数配置选项。