如何在Gradle中为Groovydoc设置字符编码？

Question

我有UTF-8编码的Groovy代码，需要生成的Groovydoc HTML使用相同的代码。但是我如何在Gradle中配置它呢？

Answer 1

Groovydoc工具目前不支持encoding选项，因此Gradle的Groovydoc任务也不支持。不过，为Gradle JVM设置file.encoding系统属性应该是可行的。您可以通过GRADLE_OPTS环境变量或通过将systemProp.file.encoding=utf-8添加到gradle.properties来完成此操作。

Answer 2

令人惊讶的是，这个问题在六年后和许多Gradle版本之后仍然相关:)

当我将Unicode字符(即箭头)添加到Groovydoc概述文件中，并试图在使用默认Windows-1251编码的机器上组装Groovydoc时，我就遇到了这个问题。

从Gradle4.10.2开始，可以使用Groovydoc的其他选项，方法是通过setAntGroovydoc方法为groovydoc任务提供自己的AntGroovydoc实现。但由于这种方法被认为是内部的，所以它将是一个有点老套的解决方案。此外，AntGroovydoc显然不是为扩展而设计的，它的子类化需要从原始类进行大量的复制粘贴。