GroovyCompileOptions

一个 Groovy 脚本文件，用于配置编译器，允许对代码编译方式进行广泛控制。

该脚本作为 Groovy 代码执行，具有以下上下文

这方便了以下模式

withConfig(configuration) {
  // use compiler configuration DSL here
}

例如，要为所有 Groovy 类激活类型检查…

import groovy.transform.TypeChecked

withConfig(configuration) {
    ast(TypeChecked)
}

有关编译器配置 DSL 的更多信息，请参阅 Groovy 编译器自定义构建器文档。

此功能仅在使用 Groovy 2.1 或更高版本编译时可用。

不应加载到 Groovy 编译器的全局 AST 转换集合。

告知源编码。默认为 UTF-8。

告知编译任务是否应在发生编译错误时失败。默认为 true。

可接受的源文件扩展名列表。仅在针对 Groovy 1.7 或更高版本编译时生效。默认为 ImmutableList.of("java", "groovy")。

告知是否在单独的进程中运行 Groovy 编译器。默认为 true。

返回在单独进程中运行 Groovy 编译器的选项。这些选项仅在 fork 设置为 true 时生效。

Groovy 代码是否应进行 Java 注解处理。

Groovy 代码的注解处理通过让注解处理器访问 Groovy 编译器生成的 Java Stub 来工作，以便支持 Groovy 和 Java 源代码的联合编译。

当设置为 true 时，将为所有 Groovy 源代码无条件生成 Stub，并且 Java 注解处理器将在这些 Stub 上执行。

当此选项设置为 false（默认值）时，Groovy 代码将不进行注解处理，但任何联合编译的 Java 代码都将进行注解处理。如果编译器参数 "-proc:none" 作为 Java 编译选项的一部分指定，则将忽略此标志的值。无论如何，都不会对 Java 或 Groovy 源代码执行注解处理。

告知在 Java/Groovy 联合编译期间生成的 Groovy 类的 Java Stub 是否应在编译完成后保留。对于联合编译调试目的很有用。默认为 false。

告知是否打印要编译的源文件。默认为 false。

返回 Groovy 编译器的优化选项。选项的允许值为 true 和 false。仅在针对 Groovy 1.8 或更高版本编译时生效。

已知选项包括

Groovy 编译器是否为 JDK 8 及更高版本上的方法参数名称反射生成元数据。

Java/Groovy 联合编译期间，Groovy 类的 Java Stub 将存储在该目录中。默认为 null，在这种情况下将使用临时目录。

告知是否启用详细输出。默认为 false。

使用命名参数语法设置 GroovyForkOptions 的便捷方法。调用此方法会将 fork 设置为 true。