如何在 gradle 版本中生成发音文档

Question

Enunciate目前没有gradle插件(https://jira.codehaus.org/browse/ENUNCIATE-815). 有没有办法手动触发Gradle的文档构建？

Answer 1

我发现当从命令行运行enunicate时，我需要提供各种JAX-RS JAR文件。使用Gradle中的configurations.runtime.asPath属性，这是非常简单的，它传递了我在构建项目时已经解决的所有RESTEasy工件。

import org.apache.tools.ant.taskdefs.condition.Os

task enunciate(type:Exec) {
  if (Os.isFamily(Os.FAMILY_WINDOWS)) {
      //on windows:
      commandLine 'cmd', '/c', 
      'enunciate-1.29\\bin\\enunciate.bat  -Edocs docs -f enunciate.xml -cp "' + configurations.runtime.asPath + 
      '" src/com/company/rest/RestApi.java'
  } else {
      //on linux
      commandLine './enunciate-1.29/bin/enunciate -Edocs docs -f enunciate.xml -cp "' + configurations.runtime.asPath + 
      " src/com/company/rest/RestApi.java'
  }

  //store the output instead of printing to the console:
  standardOutput = new ByteArrayOutputStream()

  //extension method stopTomcat.output() can be used to obtain the output:
  ext.output = {
    return standardOutput.toString()
  }
}