我们使用自定义 doclet 从自定义 javadoc 标记生成报告,并使用 Maven 站点插件和 javadoc 插件生成此报告和常规 java API 文档。
POM 的部分如下所示:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<reportSets>
<reportSet>
<id>html</id>
<reports>
<report>javadoc</report>
</reports>
</reportSet>
<reportSet>
<id>custom_report</id>
<configuration>
...
</configuration>
<reports>
<report>javadoc</report>
</reports>
</reportSet>
</reportSets>
</plugin>
在 Maven 2 下,这可以正常工作,但在 Maven 3 中只生成一个报告,这是 POM 中指定的最后一个报告(通过交换reportSet
元素来确定)。
经过一些实验,我发现如果我将常规报告的目标从“javadoc”更改为“test-javadoc”,那么我会从两个报告集中获得输出。所以问题似乎是使用 Maven 3 我无法生成两个使用相同 javadoc-plugin 目标的报告。
这是一个错误,还是我错过了一些配置?如http://maven.apache.org/plugins/maven-site-plugin-3.0-beta-3/maven-3.htmlreporting
所述,我将 maven-javadoc-plugin 设置从站点插件移至徒劳无功。我正在使用 Maven 3.0.4、maven-site-plugin 3.0-beta-3 和 maven-javadoc-plugin 2.8.1。configuration
谢谢!