Overview | Package | Class | Deprecated | Index | Help
| Groovy Documentation
| FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.gradle
Class StartParameter

    java.lang.Object
      org.gradle.StartParameter

    class StartParameter
    extends java.lang.Object

`StartParameter` defines the configuration used by a org.gradle.Gradle instance to execute a build. The properties of `StartParameter` generally correspond to the command-line options of Gradle. You pass a `StartParameter` instance to Gradle#newInstance(StartParameter) when you create a new `Gradle` instance.

You can obtain an instance of a `StartParameter` by either creating a new one, or duplicating an existing one using #newInstance or #newBuild.

author:
  Hans Dockter

see:
  org.gradle.Gradle

Nested Class Summary
`enum` | `StartParameter.ShowStacktrace`

Constructor Summary
`StartParameter()` Creates a {

Method Summary
`boolean` | `equals(java.lang.Object obj)`
`BuildExecuter` | `getBuildExecuter()` Returns the {
`File` | `getBuildFile()` Returns the build file to use to select the default project.
`ScriptSource` | `getBuildScriptSource()` Returns the {
`CacheUsage` | `getCacheUsage()`
`File` | `getCurrentDir()` Returns the directory to use to select the default project, and to search for the settings file.
`File` | `getDefaultImportsFile()`
`ProjectSpec` | `getDefaultProjectSelector()` Returns the selector used to choose the default project of the build.
`File` | `getGradleHomeDir()`
`File` | `getGradleUserHomeDir()`
`LogLevel` | `getLogLevel()`
`File` | `getPluginPropertiesFile()`
`ProjectDependenciesBuildInstruction` | `getProjectDependenciesBuildInstruction()`
`java.util.Map` | `getProjectProperties()`
`ScriptSource` | `getSettingsScriptSource()` Returns the {
`ShowStacktrace` | `getShowStacktrace()`
`java.util.Map` | `getSystemPropertiesArgs()`
`java.util.List` | `getTaskNames()` Returns the names of the tasks to execute in this build.
`int` | `hashCode()`
`boolean` | `isDryRun()`
`boolean` | `isNoOpt()`
`boolean` | `isSearchUpwards()`
`boolean` | `isShowHelp()`
`boolean` | `isShowVersion()`
`StartParameter` | `newBuild()` Creates the parameters for a new build, using these parameters as a template.
`StartParameter` | `newInstance()` Duplicates this {
`void` | `setBuildExecuter(BuildExecuter buildExecuter)` Sets the {
`void` | `setBuildFile(File buildFile)` Sets the build file to use to select the default project.
`void` | `setCacheUsage(CacheUsage cacheUsage)`
`void` | `setCurrentDir(File currentDir)` Sets the directory to use to select the default project, and to search for the settings file.
`void` | `setDefaultImportsFile(File defaultImportsFile)`
`void` | `setDefaultProjectSelector(ProjectSpec defaultProjectSelector)` Sets the selector used to choose the default project of the build.
`void` | `setDryRun(boolean dryRun)`
`void` | `setGradleHomeDir(File gradleHomeDir)`
`void` | `setGradleUserHomeDir(File gradleUserHomeDir)`
`void` | `setLogLevel(LogLevel logLevel)`
`void` | `setNoOpt(boolean noOpt)`
`void` | `setPluginPropertiesFile(File pluginPropertiesFile)`
`void` | `setProjectDependenciesBuildInstruction(ProjectDependenciesBuildInstruction projectDependenciesBuildInstruction)`
`void` | `setProjectDir(File projectDir)` Sets the project directory to use to select the default project.
`void` | `setProjectProperties(java.util.Map projectProperties)`
`void` | `setSearchUpwards(boolean searchUpwards)`
`void` | `setSettingsFile(File settingsFile)` Sets the settings file to use for the build.
`void` | `setSettingsScriptSource(ScriptSource settingsScriptSource)` Sets the {
`void` | `setShowHelp(boolean showHelp)`
`void` | `setShowStacktrace(ShowStacktrace showStacktrace)`
`void` | `setShowVersion(boolean showVersion)`
`void` | `setSystemPropertiesArgs(java.util.Map systemPropertiesArgs)`
`void` | `setTaskNames(java.util.List taskNames)` Sets the tasks to execute in this build.
`StartParameter` | `useEmbeddedBuildFile(java.lang.String buildScript)` Specifies that the given script should be used as the build file for this build.
`StartParameter` | `valueOf(java.lang.String name)` Returns the enum constant of this type with the specified name.
`org.gradle.StartParameter[]` | `values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Object
hashCode, getClass, equals, toString, wait, wait, wait, notify, notifyAll

Constructor Detail

### StartParameter

    public StartParameter()

  Creates a `StartParameter` with default values. This is roughly equivalent to running Gradle on the command-line with no arguments.

Method Detail

### equals

    public boolean equals(java.lang.Object obj)

### getBuildExecuter

    public BuildExecuter getBuildExecuter()

  Returns the BuildExecuter to use for the build.

  return:
    The BuildExecuter. Never returns null.

### getBuildFile

    public File getBuildFile()

  Returns the build file to use to select the default project. Returns null when the build file is not used to select the default project.
  return:
    The build file. May be null.

### getBuildScriptSource

    public ScriptSource getBuildScriptSource()

  Returns the ScriptSource to use for the build file for this build. Returns null when the default build file(s) are to be used. This source is used for all projects included in the build.

  return:
    The build file source, or null to use the defaults.

### getCacheUsage

    public CacheUsage getCacheUsage()

### getCurrentDir

    public File getCurrentDir()

  Returns the directory to use to select the default project, and to search for the settings file.
  return:
    The current directory. Never returns null.

### getDefaultImportsFile

    public File getDefaultImportsFile()

### getDefaultProjectSelector

    public ProjectSpec getDefaultProjectSelector()

  Returns the selector used to choose the default project of the build. This is the project used as the starting point for resolving task names, and for determining the default tasks.
  return:
    The default project. Never returns null.

### getGradleHomeDir

    public File getGradleHomeDir()

### getGradleUserHomeDir

    public File getGradleUserHomeDir()

### getLogLevel

    public LogLevel getLogLevel()

### getPluginPropertiesFile

    public File getPluginPropertiesFile()

### getProjectDependenciesBuildInstruction

    public ProjectDependenciesBuildInstruction getProjectDependenciesBuildInstruction()

### getProjectProperties

    public java.util.Map getProjectProperties()

### getSettingsScriptSource

    public ScriptSource getSettingsScriptSource()

  Returns the ScriptSource to use for the settings script for this build. Returns null when the default settings script is to be used.

  return:
    The settings script source, or null to use the default.

### getShowStacktrace

    public ShowStacktrace getShowStacktrace()

### getSystemPropertiesArgs

    public java.util.Map getSystemPropertiesArgs()

### getTaskNames

    public java.util.List getTaskNames()

  Returns the names of the tasks to execute in this build. When empty, the default tasks for the project will be executed.
  return:
    the names of the tasks to execute in this build. Never returns null.

### hashCode

    public int hashCode()

### isDryRun

    public boolean isDryRun()

### isNoOpt

    public boolean isNoOpt()

### isSearchUpwards

    public boolean isSearchUpwards()

### isShowHelp

    public boolean isShowHelp()

### isShowVersion

    public boolean isShowVersion()

### newBuild

    public StartParameter newBuild()

  Creates the parameters for a new build, using these parameters as a template. Copies the environmental properties from this parameter (eg gradle user home dir, etc), but does not copy the build specific properties (eg task names).

  return:
    The new parameters.

### newInstance

    public StartParameter newInstance()

  Duplicates this `StartParameter` instance.
  return:
    the new parameters.

### setBuildExecuter

    public void setBuildExecuter(BuildExecuter buildExecuter)

  Sets the BuildExecuter to use for the build. You can use the method to change the algorithm used to execute the build, by providing your own `BuildExecuter` implementation.

  Set to null to use the default executer. When this property is set to a non-null value, the taskNames and mergedBuild properties are ignored.

  param:
    buildExecuter The executer to use, or null to use the default executer.

### setBuildFile

    public void setBuildFile(File buildFile)

  Sets the build file to use to select the default project. Use null to disable selecting the default project using the build file.
  param:
    buildFile The build file. May be null.

### setCacheUsage

    public void setCacheUsage(CacheUsage cacheUsage)

### setCurrentDir

    public void setCurrentDir(File currentDir)

  Sets the directory to use to select the default project, and to search for the settings file. Set to null to use the default current directory.
  param:
    currentDir The directory. Should not be null.

### setDefaultImportsFile

    public void setDefaultImportsFile(File defaultImportsFile)

### setDefaultProjectSelector

    public void setDefaultProjectSelector(ProjectSpec defaultProjectSelector)

  Sets the selector used to choose the default project of the build.
  param:
    defaultProjectSelector The selector. Should not be null.

### setDryRun

    public void setDryRun(boolean dryRun)

### setGradleHomeDir

    public void setGradleHomeDir(File gradleHomeDir)

### setGradleUserHomeDir

    public void setGradleUserHomeDir(File gradleUserHomeDir)

### setLogLevel

    public void setLogLevel(LogLevel logLevel)

### setNoOpt

    public void setNoOpt(boolean noOpt)

### setPluginPropertiesFile

    public void setPluginPropertiesFile(File pluginPropertiesFile)

### setProjectDependenciesBuildInstruction

    public void setProjectDependenciesBuildInstruction(ProjectDependenciesBuildInstruction projectDependenciesBuildInstruction)

### setProjectDir

    public void setProjectDir(File projectDir)

  Sets the project directory to use to select the default project. Use null to use the default criteria for selecting the default project.
  param:
    projectDir The project directory. May be null.

### setProjectProperties

    public void setProjectProperties(java.util.Map projectProperties)

### setSearchUpwards

    public void setSearchUpwards(boolean searchUpwards)

### setSettingsFile

    public void setSettingsFile(File settingsFile)

  Sets the settings file to use for the build. Use null to use the default settings file.
  param:
    settingsFile The settings file to use. May be null.

### setSettingsScriptSource

    public void setSettingsScriptSource(ScriptSource settingsScriptSource)

  Sets the ScriptSource to use for the settings script. Set to null to use the default settings script.

  param:
    settingsScriptSource The settings script source.

### setShowHelp

    public void setShowHelp(boolean showHelp)

### setShowStacktrace

    public void setShowStacktrace(ShowStacktrace showStacktrace)

### setShowVersion

    public void setShowVersion(boolean showVersion)

### setSystemPropertiesArgs

    public void setSystemPropertiesArgs(java.util.Map systemPropertiesArgs)

### setTaskNames

    public void setTaskNames(java.util.List taskNames)

  Sets the tasks to execute in this build. Set to an empty list, or null, to execute the default tasks for the project.

  param:
    taskNames the names of the tasks to execute in this build.

### useEmbeddedBuildFile

    public StartParameter useEmbeddedBuildFile(java.lang.String buildScript)

  Specifies that the given script should be used as the build file for this build. Uses an empty settings file.

  param:
    buildScript The script to use as the build file.
  return:
    this

### valueOf

    StartParameter valueOf(java.lang.String name)

  Returns the enum constant of this type with the specified name.

### values

    org.gradle.StartParameter[] values()

  Returns an array containing the constants of this enum type, in the order they are declared.

Groovy Documentation