如果创建一个站点,如何避免多次调用javadoc?

时间:2017-12-06 08:46:04

标签: java maven javadoc maven-site-plugin maven-javadoc-plugin

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

clean javadoc:jar site deploy site:deploy

sitesite:deploy之间的分割只是为了避免在deploy失败时部署网站。

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

2 个答案:

答案 0 :(得分:5)

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

答案 1 :(得分:1)

可能使用的解决方案是创建两个不同的脚本进行构建/部署并逐个运行:

  1. 首先 - 使用-Dmaven.javadoc.skip = true进行完全构建,这样可以避免创建javadoc
  2. 另一个 - 只运行mvn javadoc:javadoc命令来获取实际的javadoc
  3. 此外,也许下一个链接可以帮助您:

    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
    3. 因此,您可以指定javadoc插件的执行阶段并指定reportSet。