如果创建站点，如何避免多次调用 javadoc？

Question

我想将一个工件与 javadoc 和一个 Maven 站点一起部署。我用

clean javadoc:jar site deploy site:deploy

（site 和site:deploy 之间的拆分只是为了避免在deploy 失败时部署站点）。

现在 javadoc 被创建了两次 - 一次在 javadoc:jar 中，一次在 site 中。是否可以只创建一次并将其用于 Nexus 中的 javadoc-jar 和 Maven 站点？

Answer 1

我很确定插件缺少检查输出是否已作为 Maven 会话的一部分生成。验证输出是否是在 Maven 启动之后生成的 将是一个很好的改进。 （让我们添加一个 force-parameter 来强制创建）。

Answer 2

您可能使用的可能解决方案是为构建/部署创建两个不同的脚本并逐个运行它们：

1. 首先 - 使用 -Dmaven.javadoc.skip=true 进行完整构建，避免您创建 javadoc
2. 另一个 - 只运行 mvn javadoc:javadoc 命令来获取实际的 javadoc

另外，也许下一个链接可以帮助你：

1. https://maven.apache.org/plugins/maven-javadoc-plugin/examples/selective-javadocs-report.html
2. https://maven.apache.org/plugins/maven-javadoc-plugin/examples/test-javadocs.html

所以，你可以指定javadoc插件的执行阶段并指定reportSet。