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

Question

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

javadoc: warning - You have not specified the version of HTML to use. The default is currently HTML 4.01, but this will change to HTML5 in a future release. To suppress this warning, please specify the version of HTML used in your documentation comments and to be generated by this doclet, using the -html4 or -html5 options.

我该怎么做？

Answer 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>

Answer 2

我通过在配置中添加另一个 additionalJOption 来做到这一点

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

Answer 3

最好放到profile里面，因为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>

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

How to specify Javadoc HTML version with Maven?

javadoc

maven