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 存根来工作，以支持 Groovy 和 Java 源代码的联合编译。

当设置为 true 时，将无条件地为所有 Groovy 源生成存根，并对这些存根执行 Java 注解处理器。

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

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

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

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

已知选项包括

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

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

指定是否启用详细输出。默认为 false。