maven-2 - 如何使用 javadoc :aggregate properly in multi-module maven project?

Question

这是我的 parent 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 的聚合器似乎存在问题，该问题已提交 here

还有相关的bug here和 here还有一些

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

总而言之， 你没有做错

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

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