gradle - 如何在 gradle 构建中生成 Enunciate 文档

Question

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

Answer 1

我发现在从命令行运行它时，我需要提供各种 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()
  }
}