Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.gradle.api.tasks.wrapper
Class Wrapper

    java.lang.Object
      org.gradle.api.internal.AbstractTask
          org.gradle.api.DefaultTask
              org.gradle.api.tasks.wrapper.Wrapper

All Implemented Interfaces:
  groovy.lang.GroovyObject, java.lang.Comparable<Task>, org.gradle.api.internal.TaskInternal, Task

    public class Wrapper

extends org.gradle.api.DefaultTask

The wrapper task generates scripts (for *nix and windows) which enable to build your project with Gradle, without having to install Gradle. The scripts generated by this task are supposed to be commited to your version control system. This tasks also copies a gradle-wrapper.jar to your project dir which needs also be commited into your VCS. The scripts delegates to this jar. If a user execute a wrapper script the first time, the script downloads the gradle-distribution and runs the build against the downloaded distribution. Any installed Gradle distribution is ignored when using the wrapper scripts. Alternatively you can store the distribution for the wrapper in your version control system.

Nested Class Summary
`static class` | `Wrapper.PathBase`

Field Summary
`static java.lang.String` | `DEFAULT_ARCHIVE_CLASSIFIER`
`static java.lang.String` | `DEFAULT_ARCHIVE_NAME`
`static java.lang.String` | `DEFAULT_DISTRIBUTION_PARENT_NAME`
`static java.lang.String` | `DEFAULT_URL_ROOT`
`static java.lang.String` | `WRAPPER_JAR_BASE_NAME`

Fields inherited from interface org.gradle.api.Task
`AUTOSKIP_PROPERTY_PREFIX, TASK_ACTION, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_NAME, TASK_OVERWRITE, TASK_TYPE`

Constructor Summary
`Wrapper(Project project, java.lang.String name)`

Method Summary
`Wrapper.PathBase` | `getArchiveBase()` Returns the archive base.
`java.lang.String` | `getArchiveClassifier()` Returns the archive classifier.
`java.lang.String` | `getArchiveName()` Returnes the archive name.
`java.lang.String` | `getArchivePath()` Returns the archive path.
`Wrapper.PathBase` | `getDistributionBase()` Returns the distribution base.
`java.lang.String` | `getDistributionPath()` Returns the distribution path.
`java.lang.String` | `getGradleVersion()` Returns the gradle version for the wrapper.
`java.lang.String` | `getJarPath()` Returns the jar path.
`java.lang.String` | `getScriptDestinationPath()` Returns the script destination path.
`WrapperScriptGenerator` | `getUnixWrapperScriptGenerator()`
`java.lang.String` | `getUrlRoot()`
`void` | `setArchiveBase(Wrapper.PathBase archiveBase)` The distribution base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.
`void` | `setArchiveClassifier(java.lang.String archiveClassifier)` Specifies the classifier of the archive as part of the download URL.
`void` | `setArchiveName(java.lang.String archiveName)` Specifies the name of the archive as part of the download URL.
`void` | `setArchivePath(java.lang.String archivePath)` Set's the path where the gradle distributions archive should be saved (i.e.
`void` | `setDistributionBase(Wrapper.PathBase distributionBase)` The distribution base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.
`void` | `setDistributionPath(java.lang.String distributionPath)` Set's the path where the gradle distributions needed by the wrapper are unzipped.
`void` | `setGradleVersion(java.lang.String gradleVersion)` The version of the gradle distribution required by the wrapper.
`void` | `setJarPath(java.lang.String jarPath)` When executing the wrapper task, the jar path specifies the path where the gradle-wrapper.jar is copied to.
`void` | `setScriptDestinationPath(java.lang.String scriptDestinationPath)` Specifies a path as the parent dir of the scripts which are generated when executing the wrapper task.
`void` | `setUnixWrapperScriptGenerator(WrapperScriptGenerator wrapperScriptGenerator)`
`void` | `setUrlRoot(java.lang.String urlRoot)` A URL where to download the gradle distribution from.

Methods inherited from class org.gradle.api.DefaultTask
`configure, doFirst, doLast, leftShift, methodMissing, propertyMissing, setProperty`

Methods inherited from class org.gradle.api.internal.AbstractTask
`captureStandardOutput, compareTo, defineProperty, deleteAllActions, dependsOn, dependsOnTaskDidWork, disableStandardOutputCapture, doFirst, doLast, equals, execute, getActions, getAdditionalProperties, getAnt, getConvention, getDependsOn, getDescription, getDidWork, getDynamicObjectHelper, getEnabled, getExecuted, getLogger, getName, getPath, getProject, getSkipProperties, getStandardOutputCapture, getTaskDependencies, hashCode, hasProperty, isDidWork, isEnabled, isExecuted, onlyIf, onlyIf, property, setActions, setAdditionalProperties, setDependsOn, setDescription, setDidWork, setEnabled, setExecuted, setName, setProject, setSkipProperties, setStandardOutputCapture, toString`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Methods inherited from interface groovy.lang.GroovyObject
`getMetaClass, getProperty, invokeMethod, setMetaClass`

Field Detail

### DEFAULT_URL_ROOT

    public static final java.lang.String DEFAULT_URL_ROOT

See Also:
  Constant Field Values

### WRAPPER_JAR_BASE_NAME

    public static final java.lang.String WRAPPER_JAR_BASE_NAME

See Also:
  Constant Field Values

### DEFAULT_DISTRIBUTION_PARENT_NAME

    public static final java.lang.String DEFAULT_DISTRIBUTION_PARENT_NAME

See Also:
  Constant Field Values

### DEFAULT_ARCHIVE_NAME

    public static final java.lang.String DEFAULT_ARCHIVE_NAME

See Also:
  Constant Field Values

### DEFAULT_ARCHIVE_CLASSIFIER

    public static final java.lang.String DEFAULT_ARCHIVE_CLASSIFIER

See Also:
  Constant Field Values

Constructor Detail

### Wrapper

    public Wrapper(Project project,
                   java.lang.String name)

Method Detail

### getScriptDestinationPath

    public java.lang.String getScriptDestinationPath()

  Returns the script destination path.

  See Also:
    `setScriptDestinationPath(String)`

### setScriptDestinationPath

    public void setScriptDestinationPath(java.lang.String scriptDestinationPath)

  Specifies a path as the parent dir of the scripts which are generated when executing the wrapper task. This path specifies a directory relative to the project dir. Defaults to empty string, i.e. the scripts are placed into the project root dir.

  Parameters:
    `scriptDestinationPath` - Any object which `toString` method specifies the path. Most likely a String or File object.

### getJarPath

    public java.lang.String getJarPath()

  Returns the jar path.

  See Also:
    `setJarPath(String)`

### setJarPath

    public void setJarPath(java.lang.String jarPath)

  When executing the wrapper task, the jar path specifies the path where the gradle-wrapper.jar is copied to. The jar path must be a path relative to the project dir. The gradle-wrapper.jar must be submitted to your version control system. Defaults to empty string, i.e. the jar is placed into the project root dir.

  Parameters:
    `jarPath` -

### getDistributionPath

    public java.lang.String getDistributionPath()

  Returns the distribution path.

  See Also:
    `setDistributionPath(String)`

### setDistributionPath

    public void setDistributionPath(java.lang.String distributionPath)

  Set's the path where the gradle distributions needed by the wrapper are unzipped. The path is relative to the dir specified with `distributionBase`.

  Parameters:
    `distributionPath` -

### getGradleVersion

    public java.lang.String getGradleVersion()

  Returns the gradle version for the wrapper.

  See Also:
    `setGradleVersion(String)`

### setGradleVersion

    public void setGradleVersion(java.lang.String gradleVersion)

  The version of the gradle distribution required by the wrapper. This is usually the same version of Gradle you use for building your project.

  Parameters:
    `gradleVersion` -

### getUrlRoot

    public java.lang.String getUrlRoot()

### setUrlRoot

    public void setUrlRoot(java.lang.String urlRoot)

  A URL where to download the gradle distribution from. The pattern used by the wrapper for downloading is: ``getUrlRoot()`/`getArchiveName()`-`getArchiveClassifier()`-`getGradleVersion()`.zip`. The default for the URL root is `DEFAULT_URL_ROOT`. The wrapper downloads a certain distribution only ones and caches it. If your `getDistributionBase()` is the project, you might submit the distribution to your version control system. That way no download is necessary at all. This might be in particular interesting, if you provide a custom gradle snapshot to the wrapper, because you don't need to provide a download server then.

  Parameters:
    `urlRoot` -

### getDistributionBase

    public Wrapper.PathBase getDistributionBase()

  Returns the distribution base.

  See Also:
    `setDistributionBase(org.gradle.api.tasks.wrapper.Wrapper.PathBase)`

### setDistributionBase

    public void setDistributionBase(Wrapper.PathBase distributionBase)

  The distribution base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir. The path specified in `distributionPath` is a relative path to either of those dirs.

  Parameters:
    `distributionBase` -

### getArchivePath

    public java.lang.String getArchivePath()

  Returns the archive path.

  See Also:
    `setArchivePath(String)`

### setArchivePath

    public void setArchivePath(java.lang.String archivePath)

  Set's the path where the gradle distributions archive should be saved (i.e. the parent dir). The path is relative to the parent dir specified with `getArchiveBase()`.

  Parameters:
    `archivePath` -

### getArchiveBase

    public Wrapper.PathBase getArchiveBase()

  Returns the archive base.

  See Also:
    `setArchiveBase(org.gradle.api.tasks.wrapper.Wrapper.PathBase)`

### setArchiveBase

    public void setArchiveBase(Wrapper.PathBase archiveBase)

  The distribution base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir. The path specified in `getArchivePath()` is a relative path to etiher of those dirs.

  Parameters:
    `archiveBase` -

### getArchiveName

    public java.lang.String getArchiveName()

  Returnes the archive name.

  See Also:
    `setArchiveName(String)`

### setArchiveName

    public void setArchiveName(java.lang.String archiveName)

  Specifies the name of the archive as part of the download URL. The download URL is assembled by the pattern: ``getUrlRoot()`/`getArchiveName()`-`getArchiveClassifier()`-`getGradleVersion()`.zip` The default for the archive name is `DEFAULT_ARCHIVE_NAME`.

  Parameters:
    `archiveName` -

### getArchiveClassifier

    public java.lang.String getArchiveClassifier()

  Returns the archive classifier.

  See Also:
    `setArchiveClassifier(String)`

### setArchiveClassifier

    public void setArchiveClassifier(java.lang.String archiveClassifier)

  Specifies the classifier of the archive as part of the download URL. The download URL is assembled by the pattern: ``getUrlRoot()`/`getArchiveName()`-`getArchiveClassifier()`-`getGradleVersion()`.zip` The default for the archive classifier is `DEFAULT_ARCHIVE_CLASSIFIER`.

  Parameters:
    `archiveClassifier` -

### getUnixWrapperScriptGenerator

    public WrapperScriptGenerator getUnixWrapperScriptGenerator()

### setUnixWrapperScriptGenerator

    public void setUnixWrapperScriptGenerator(WrapperScriptGenerator wrapperScriptGenerator)

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD