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

Question

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

Answer 1

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

Answer 2

令人惊讶的是，经过六年和很多 Gradle 版本，这个问题仍然存在 :)

当我将 Unicode 字符（即箭头）添加到我的 Groovydoc 概述文件并尝试在具有默认 Windows-1251 编码的机器上组装 Groovydoc 时，我遇到了这个问题。

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