CreateStartScripts

创建用于启动 JVM 应用程序的启动脚本。

示例

task createStartScripts(type: CreateStartScripts) {
  outputDir = file('build/sample')
  mainClass = 'org.gradle.test.Main'
  applicationName = 'myApp'
  classpath = files('path/to/some.jar')
}

注意：Gradle 的 "application" 插件会添加一个预配置的此类型任务，名为 "startScripts"。

该任务会生成分别面向 Microsoft Windows 环境和类 UNIX 环境（例如 Linux、macOS）的脚本。实际生成由 CreateStartScripts.getWindowsStartScriptGenerator() 和 CreateStartScripts.getUnixStartScriptGenerator() 属性实现，这些属性的类型为 ScriptGenerator。

示例

task createStartScripts(type: CreateStartScripts) {
  unixStartScriptGenerator = new CustomUnixStartScriptGenerator()
  windowsStartScriptGenerator = new CustomWindowsStartScriptGenerator()
}

class CustomUnixStartScriptGenerator implements ScriptGenerator {
  void generateScript(JavaAppStartScriptGenerationDetails details, Writer destination) {
    // implementation
  }
}

class CustomWindowsStartScriptGenerator implements ScriptGenerator {
  void generateScript(JavaAppStartScriptGenerationDetails details, Writer destination) {
    // implementation
  }
}

默认生成器类型为 TemplateBasedScriptGenerator，并使用默认模板。可以通过 TemplateBasedScriptGenerator.setTemplate(org.gradle.api.resources.TextResource) 方法更改模板。

此任务使用的默认实现使用 Groovy 的 SimpleTemplateEngine 解析模板，并提供以下变量：

编码后的路径预期脚本中存在一个名为 APP_HOME 的变量，该变量设置为应用程序主目录，可以使用 appHomeRelativePath 解析。

示例

task createStartScripts(type: CreateStartScripts) {
  unixStartScriptGenerator.template = resources.text.fromFile('customUnixStartScript.txt')
  windowsStartScriptGenerator.template = resources.text.fromFile('customWindowsStartScript.txt')
}