8

在某处是否有可用的 Maven 插件GroovyDoc，最好是作为报告？

我猜GMaven会是查看的地方，但文档是古老的（1.0，而当前版本是 1.3）并且 GMaven 插件没有任何适合您的魔力，如您所见：

mvn help:describe -DgroupId=org.codehaus.gmaven -DartifactId=gmaven-plugin

这个插件有 9 个目标：

groovy:compile
描述：编译 Groovy 源代码。

groovy:console
描述：启动 Groovy GUI 控制台。

groovy:execute
描述：执行 Groovy 脚本。

groovy:generateStubs
描述：从 Groovy 源代码生成 Java 存根。

groovy:generateTestStubs
描述：从 Groovy 测试源生成 Java 存根。

groovy:help
描述：显示 gmaven-plugin 的帮助信息。
调用
mvn groovy:help -Ddetail=true -Dgoal=<goal-name>
以显示参数详细信息。

groovy:providers
描述：显示有关已配置和选择的 Groovy 运行时提供程序的信息。

groovy:shell
描述：启动 Groovy Shell（又名 groovysh）。

groovy:testCompile
描述：编译 Groovy 测试源。

那么有没有人有任何指向 maven groovydoc 插件的指针？谷歌没有想出任何有意义的东西。

4

4 回答 4

8

尽管没有任何与 Groovydoc maven 兼容的插件，但使用 Maven 为您的 groovy 类生成文档非常容易。这是我们在项目中的做法：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-antrun-plugin</artifactId>
  <version>1.7</version>
  <executions>
    <execution>
      <id>groovydoc</id>
      <phase>site</phase>
      <goals>
        <goal>run</goal>
      </goals>
      <configuration>
        <target>
          <taskdef name="groovydoc"
            classname="org.codehaus.groovy.ant.Groovydoc" 
            classpathref="maven.compile.classpath"
          />
          <groovydoc destdir="${project.reporting.outputDirectory}/groovydoc"
            sourcepath="${basedir}/src/main/groovy" use="true"
            windowtitle="${project.name}"
            doctitle="${project.name}"
          >
            <link packages="java.,org.xml.,javax.,org.xml."
              href="http://download.oracle.com/javase/6/docs/api" />
            <link packages="org.apache.tools.ant." 
              href="http://evgeny-goldin.org/javadoc/ant/api" />
            <link packages="org.junit.,junit.framework."
              href="http://kentbeck.github.com/junit/javadoc/latest" />
            <link packages="groovy.,org.codehaus.groovy."
              href="http://groovy.codehaus.org/api/" />
            <link packages="org.codehaus.gmaven."
              href="http://evgeny-goldin.org/javadoc/gmaven" />
          </groovydoc>
        </target>
      </configuration>
    </execution>
  </executions>
</plugin>
于 2011-12-07T14:01:05.313 回答
3

我认为 Groovydoc 没有 Maven 插件，但您可以使用Ant task。GMaven 采用不同的方法：generateStubs为 Groovy 类创建 Java 存根，然后可以由常规 Javadoc 插件处理。但是，我不知道这种方法在实践中的效果如何，特别是因为新版本的 GMaven 使用了 Groovy 编译器的存根生成器，而创建它的目的并不是为了生成正确的 Javadoc。

于 2011-03-16T22:52:55.077 回答
2

你想要 gmavenplus 插件：http ://groovy.github.io/GMavenPlus/groovydoc-mojo.html

<project>
  <build>
    <plugins>
      <plugin>
        <groupId>org.codehaus.gmavenplus</groupId>
        <artifactId>gmavenplus-plugin</artifactId>
        <version>1.5</version>
      </plugin>
    </plugins>
  </build>
  <dependencies>
    <dependency>
      <groupId>org.codehaus.groovy</groupId>
      <artifactId>groovy-all</artifactId>
      <!-- any version of Groovy \>= 1.5.0 (except 1.6 RC 1) should work here -->
      <version>2.4.7</version>
    </dependency>
  </dependencies>
</project>

并运行：mvn gplus:generateStubs gplus:groovydoc

于 2017-01-18T19:04:40.130 回答
0

Groovydoc Maven 插件为我工作：https ://github.com/rvowles/groovydoc-maven-plugin

于 2014-08-05T23:52:03.510 回答