避免为多模块 Maven 项目中的单个模块暂存和部署 Javadoc答案

【问题标题】：Avoid staging and deploying Javadoc for individual modules in multi-module Maven project避免为多模块 Maven 项目中的单个模块暂存和部署 Javadoc
【发布时间】：2021-08-20 12:53:22
【问题描述】：

我有一个多模块 Maven 项目。我已经设置了父 POM 来生成聚合的 Javadoc，比如

...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.3.0</version>
        <reportSets>
          <reportSet>
            <id>aggregate</id>
            <inherited>false</inherited>        
            <reports>
              <report>aggregate</report>
              <report>test-aggregate</report>
            </reports>
          </reportSet>
          <reportSet>
            <id>default</id>
            <reports>
              <report>javadoc</report>
              <report>test-javadoc</report>
            </reports>
          </reportSet>
        </reportSets>
...

这具有暂存和部署 Javadoc 的效果，既可以在项目级别聚合，也可以用于单个模块。删除最后一个 reportSet 没有任何区别。由于所有信息都已存在于聚合的 Javadoc 中，因此我不希望它位于各个模块下。我该如何避免呢？

【问题讨论】：

标签： maven javadoc multi-module maven-javadoc-plugin

【解决方案1】：

答案很简单，您将第二个reportSet 定义为有一组空报告，例如

...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.3.0</version>
        <reportSets>
          <reportSet>
            <id>aggregate</id>
            <inherited>false</inherited>        
            <reports>
              <report>aggregate</report>
              <report>test-aggregate</report>
            </reports>
          </reportSet>
          <reportSet>
            <id>default</id>
            <reports>
            </reports>
          </reportSet>
        </reportSets>
...
´´´

【讨论】：