如何在多模块maven项目中正确使用javadoc:aggregate？

Question

这是我在多模块项目中的父 pom.xml 文件（其中一部分）：

...
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
        </plugin>
    </plugins>
</build>
...

该插件在所有子模块中继承，我认为这不是正确的方法。当我运行 mvn javadoc:aggregate 时，文档在 target/site/apidoc 中生成，但日志中充满了警告：

...
[WARNING] Removing: aggregate from forked lifecycle, 
to prevent recursive invocation.
...

我做错了什么？

Answer 1

您需要为此插件启用聚合：

  <plugin>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
      <aggregate>true</aggregate> <!-- this enables aggretation -->
    </configuration>
  </plugin>

在命令行上输入：

mvn javadoc:aggregate

编辑：

好的，我深入研究了 Maven 插件的 jira，发现所有 javadoc 插件 mojos 都已用 @aggregator 进行了注释。 提交了问题

但是maven的聚合器似乎存在问题，已在此处 还有相关错误此处和这里 以及更多

这似乎是一个拦截器问题使用 maven 的聚合器，因为某些插件（例如 clover）无法运行。

总而言之，您没有做错任何事情

只需切换回不使用 @aggregator mojo 注释的 maven-javadoc-plugin 的早期版本，您将不会收到警告（除非您正在使用某些功能）早期版本中不可用的 javadoc 插件）

顺便说一句，如果您将 javadoc 插件作为报告运行，则 @aggregator 将被忽略。