scala - 如何在 Maven 中包含 ScalaDoc 选项

Question

我可以通过手动使用“scaladoc -diagrams ...”生成类层次结构图

我还可以通过“mvn scala:doc”使用 Maven 生成基本的 ScalaDoc

但是，当我从 Maven 运行 ScalaDoc 时，如何放入“-diagrams”？通常，我如何输入“scaladoc -help”中列出的任何选项。

我的 pom.xml 中有这个，但它不起作用。

        <plugin>
            <groupId>org.scala-tools</groupId>
            <artifactId>maven-scala-plugin</artifactId>
            <version>2.14-SNAPSHOT</version>
            <configuration>
                <args>
                    <arg>-diagrams</arg>
                </args>
            </configuration>
         </plugin>

更新

这也行不通:

        <plugin>
            <groupId>org.scala-tools</groupId>
            <artifactId>maven-scala-plugin</artifactId>

            <executions>
                <execution>
                    <id>generate-scaladoc</id>
                    <phase>generate-sources</phase>
                    <goals>
                        <goal>doc</goal>
                    </goals>
                    <configuration>
                        <diagrams>true</diagrams>
                        <args>
                            <arg>-diagrams</arg>
                        </args>
                    </configuration>
                </execution>
            </executions>
      </plugin>

Answer 1

我可以使用 scala-maven-plugin attach-javadocs 执行为 scala maven 项目生成 java-docs，如下所示:

                 <plugin>
                    <groupId>net.alchim31.maven</groupId>
                    <artifactId>scala-maven-plugin</artifactId>
                    <version>3.2.0</version>
                    <executions>
                        <execution>
                            <!-- this is so we don't end with a compile error in maven-compiler-plugin -->
                            <phase>process-sources</phase>
                            <goals>
                                <goal>compile</goal>
                                <goal>testCompile</goal>
                            </goals>
                            <configuration>
                            </configuration>
                        </execution>
                        <execution>
                            <id>attach-javadocs</id>
                            <goals>
                                <goal>doc-jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>

一旦添加了上述指定的插件配置，只需运行mvn clean install，它将生成 javadoc 的 jar 和源代码 jar