scala - 如何为 Maven 站点生成聚合的 scaladoc？

我有一个多模块 Maven 构建，我想在我的根模块中生成一个聚合的 Scaladoc，类似于 maven-javadoc-plugin 的聚合目标。我的第一次尝试是:

<project ...>
    <build>
        <pluginManagement>
            <plugins>
                <plugin>
                    <artifactId>maven-site-plugin</artifactId>
                    <configuration>
                        <reportPlugins>
                            <plugin>
                                <artifactId>maven-project-info-reports-plugin</artifactId>
                            </plugin>
                            <plugin>
                                <groupId>net.alchim31.maven</groupId>
                                <artifactId>scala-maven-plugin</artifactId>
                                <reports>
                                    <report>doc</report>
                                </reports>
                                <configuration>
                                    <aggregateDirectOnly>false</aggregateDirectOnly>
                                    <sendJavaToScalac>false</sendJavaToScalac>
                                </configuration>
                            </plugin>
                            <plugin>
                                <artifactId>maven-javadoc-plugin</artifactId>
                                <reports>
                                    <report>aggregate</report>
                                </reports>
                            </plugin>
                        </reportPlugins>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

但是，aggregateDirectOnly 属性似乎没有任何效果。我总是只为单个 jar 类型的 POM 获取 Scaladoc。

我还尝试将 forceAggregate 设置为 true，但它也没有效果。

这个怎么做？

最佳答案

这并没有完全按照要求回答问题，但是在 ScalaDoc 能够解析 JavaDoc 注释之前，它实际上可能是混合 java/scala 项目的首选解决方案。它生成单个聚合的 JavaDoc，其中还包括来自项目的所有 Scala 源文件的文档。

解决方法很简单:配置 Maven 使用 GenJavaDoc Scala 编译器插件，以便 ScalaDocs 可以转换为 JavaDocs。然后，使用正常的 javadoc:aggregate 目标来正常聚合项目。

这是执行此操作的示例 Maven 配置文件。它配置Scala编译器生成Scala源对应的JavaDocs，配置Maven将Scala编译器创建的genjavadoc目录作为源目录，然后配置javadoc插件本身(如果你没有特殊JavaDoc 插件配置要求)。

<profile>
  <id>javadoc</id>
  <build>
    <plugins>
      <plugin>
        <groupId>net.alchim31.maven</groupId>
        <artifactId>scala-maven-plugin</artifactId>
        <executions>
          <execution>
            <id>doc</id>
            <phase>generate-sources</phase>
            <goals>
              <goal>compile</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <args>
            <arg>-P:genjavadoc:out=${project.build.directory}/genjavadoc</arg>
          </args>
          <compilerPlugins>
            <compilerPlugin>
              <groupId>com.typesafe.genjavadoc</groupId>
              <artifactId>genjavadoc-plugin_${scala.binary.full.version}</artifactId>
              <version>0.4</version>
            </compilerPlugin>
          </compilerPlugins>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>build-helper-maven-plugin</artifactId>
        <executions>
          <execution>
            <phase>generate-sources</phase>
            <goals>
              <goal>add-source</goal>
            </goals>
            <configuration>
              <sources>
                <source>${project.build.directory}/genjavadoc</source>
              </sources>
            </configuration>
          </execution>
        </executions>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <configuration>
          <minmemory>64m</minmemory>
          <maxmemory>2g</maxmemory>
          <outputDirectory>${project.build.directory}</outputDirectory>
          <detectLinks>true</detectLinks>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

关于scala - 如何为 Maven 站点生成聚合的 scaladoc？，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/12301620/