如何在多模块 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 插件 mojo 都已使用 @aggregator 进行注释。但是maven的聚合器似乎存在问题，该问题已提交here

还有here和here相关的bug等等

这似乎是 maven 聚合器的一个阻塞问题，因为某些插件，例如三叶草不会运行。

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

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

附带说明，如果您将 javadoc 插件作为报告运行，则 @aggregator 将被忽略。