如何使用 Maven 指定 Javadoc HTML 版本？答案

【问题标题】：How to specify Javadoc HTML version with Maven?如何使用 Maven 指定 Javadoc HTML 版本？
【发布时间】：2018-09-04 00:34:52
【问题描述】：

在设置 Maven 以生成 Javadoc 时，我收到了以下警告：

javadoc: 警告 - 您尚未指定要使用的 HTML 版本。当前默认为 HTML 4.01，但在未来版本中将更改为 HTML5。要抑制此警告，请使用 -html4 或 -html5 选项指定文档 cmets 中使用的 HTML 版本，并由该 doclet 生成。

我该怎么做？

【问题讨论】：

标签： maven javadoc

【解决方案1】：

我通过将 additionalOptions 添加到 Javadoc 插件的 configuration 部分来做到这一点：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>3.0.1</version>
            <configuration>
                <additionalOptions>-html5</additionalOptions>
            </configuration>
        </plugin>
    </plugins>
</build>

【讨论】：

顺便说一句，这也适用于在较新版本的插件中强制html4。

【解决方案2】：

我通过在配置中添加另一个额外的 JOption 来做到这一点

<additionalJOptions>
  <additionalJOption>-J-Dhttp.agent=maven-javadoc-plugin-${project.name}</additionalJOption>
  <additionalJOption>-html5</additionalJOption>
</additionalJOptions>

【讨论】：

【解决方案3】：

最好将其放入配置文件中，因为 1.9 以下不支持 -html5：

  <profile>
        <id>javadoc-html5</id>
        <activation>
            <jdk>[1.9,)</jdk>
        </activation>
        <build>
            <pluginManagement>
                <plugins>
                    <plugin>
                        <artifactId>maven-javadoc-plugin</artifactId>
                        <configuration>
                            <additionalOptions>-html5</additionalOptions>
                        </configuration>
                    </plugin>
                </plugins>
            </pluginManagement>
        </build>
    </profile>

【讨论】：