在不重复执行阶段生成源的情况下生成 Javadoc。

  • 标准目标javadoctest-javadoc调用单独的生命周期generate-sourcesgenerate-test-sources
  • 在 CI 环境中,您现在可以执行类似mvn clean deploy site site-deploy 的操作
  • 站点构建期间,标准报告将再次触发generate-sourcesgenerate-test-sources,这取决于您的构建,这可能需要一些时间,因为将再次调用诸如执行器或从 WDSL 生成存根之类的东西,这可能会导致更长的构建次。
  • 另请参阅MJAVADOC-369
  • 从 2.10 版开始,定义了两个新报告,javadoc-no-forktest-javadoc-no-fork,它们不会再次触发上述阶段。
  • 在您的报告部分进行如下配置:
    <project>
      ...
      <reporting>
        <excludeDefaults>true</excludeDefaults>
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>3.3.2</version>
            <reportSets>
              <reportSet>
                <reports>
                  <report>javadoc-no-fork</report>
                  <report>test-javadoc-no-fork</report>
                </reports>
              </reportSet>
            </reportSets>
          </plugin>
        </plugins>
      </reporting>
      ...
    </project>
    

    注意:这些报告不能用于汇总报告。对于那些,请参阅在不执行阶段编译的情况下生成聚合 Javadocs的示例。