java - 如何在 Maven 中指定不同版本的 Standard DocLet？

Question

背景:我有一个项目，在一台装有 java 1.7.0 的机器上用 maven 编译得很好，但在另一台装有 java 1.8.0 的机器上 javadoc 编译失败。从maven的日志中，我可以看到一个使用的是“Standard DocLet version 1.7.0_40”，而另一个使用的是“Standard DocLet version 1.8.0”。

问题是:我如何告诉maven使用正确版本的标准DocLet？

我已经在 maven-compiler-plugin 中将源代码和目标版本都设置为 1.7。

Answer 1

我建议查看 documentation of maven-javadoc-plugin其中描述了您应该定义 doclet 的版本。

<project>
  ...
  <reporting> (or <build>)
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9.1</version>
        <configuration>
          <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>

          <!-- <docletPath>/path/to/UmlGraph.jar</docletPath> -->
          <docletArtifact>
            <groupId>org.umlgraph</groupId>
            <artifactId>doclet</artifactId>
            <version>5.1</version>
          </docletArtifact>
          <additionalparam>-views</additionalparam>
          <useStandardDocletOptions>true</useStandardDocletOptions>
        </configuration>
      </plugin>
    ...
    </plugins>
  </reporting> (or </build>)
  ...
</project>