java - Maven Javadoc 报告 : aggregate and detectLinks

Question

在 Maven 站点构建中，我想生成一个聚合的 Javadoc 报告，其中包含指向其他 Javadoc 的链接 (detectLinks = true)。

在我在报告部分定义的父 POM 之一中:

<reporting>
    <plugins>
        ...
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.9</version> 
            <reportSets>
                <reportSet>
                    <id>default</id>
                    <configuration>
                        <detectOfflineLinks>true</detectOfflineLinks>
                    </configuration>
                    <reports>
                        <report>javadoc</report>
                    </reports>
                </reportSet>
                <reportSet>
                    <id>aggregate</id>
                    <reports>
                        <report>aggregate</report>
                    </reports>
                </reportSet>
            </reportSets>
            <configuration>
                <detectLinks>true</detectLinks>
            </configuration>
        </plugin>
    </plugins>
</reporting>

多模块聚合器项目的有效 POM 报告部分是:

  <reporting>
    <outputDirectory>someDir</outputDirectory>
    <plugins>
      ...
      <plugin>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <reportSets>
          <reportSet>
            <reports>
              <report>javadoc</report>
            </reports>
            <configuration>
              <detectOfflineLinks>true</detectOfflineLinks>
              <detectLinks>true</detectLinks>
            </configuration>
          </reportSet>
          <reportSet>
            <id>aggregate</id>
            <reports>
              <report>aggregate</report>
            </reports>
            <configuration>
              <detectLinks>true</detectLinks>
            </configuration>
          </reportSet>
        </reportSets>
        <configuration>
          <detectLinks>true</detectLinks>
        </configuration>
      </plugin>
    </plugins>
  </reporting>

不过，DetectLinks 仅适用于单独的 Javadoc 报告，而不适用于聚合的 Javadoc 报告。

如何为聚合的 Javadoc 报告启用 detectorLinks？

Answer 1

问题在于聚合目标仅检查根项目的依赖项，而不检查模块。刚刚创建了一个补丁问题:http://jira.codehaus.org/browse/MJAVADOC-390

临时解决方案可以是声明对根项目的依赖关系......但这很丑陋

--瓦祖尔