maven-3 - 使用 maven-javadoc-plugin 和 Maven 3 生成多个 javadoc 报告

Question

我们使用自定义 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 目标的报告。

这是一个错误，还是我错过了一些配置？我从 reporting 移动了 maven-javadoc-plugin 设置到 configuration的站点插件，如 http://maven.apache.org/plugins/maven-site-plugin-3.0-beta-3/maven-3.html 所述，无济于事。我正在使用 Maven 3.0.4、maven-site-plugin 3.0-beta-3 和 maven-javadoc-plugin 2.8.1。

谢谢!

Answer 1

这是一个 bug in maven-reporting-exec component .

报告集使用报告目标作为关键字保存在 map 中。