如何在gradle中设置JavaDoc的编码？

Question

我编写了带有JavaDoc命令的Java-Classes，其中包含äöü等特殊字符。我使用gradle构建文件生成JavaDoc：

apply plugin: 'java'

和命令行中的gradle javadoc。

原始文件的编码是UTF-8。 JavaDoc文件的编码也是UTF-8。但HTML源代码中没有提示文件是UTF-8。这就是为什么我的浏览器总是认为它是ISO-8859。

在生成JavaDoc时，如何告诉javadoc（通过gradle）还将<meta charset="utf-8"/>添加到源代码中？

Answer 1

您想要设置javadoc charset option。

javadoc {
    options.encoding = 'UTF-8'
}

Answer 2

我使用gradle 2.13+并且Mark的回答和Arne的评论都不适合我。

但是，我可以通过addStringOption()修复它：

javadoc {
    options.addStringOption("charset", "UTF-8")
}

有关更多详细信息，请参阅gradles Javadoc docs和Javadoc的charset选项。

Answer 3

我使用的是Gradle 2.1，发现以下配置对我有用。

tasks.withType(Javadoc) {
    options.encoding = 'UTF-8'
}

Answer 4

对我来说，这是：

javadoc {
    options.addStringOption('encoding', 'UTF-8')
}

在Gradle 3.3中