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
  extended by org.gradle.api.internal.AbstractTask
      extended by org.gradle.api.DefaultTask
          extended by org.gradle.api.tasks.wrapper.Wrapper
All Implemented Interfaces:
Comparable<Task>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.TaskInternal, ExtensionAware, Task, org.gradle.util.Configurable<Task>
public class Wrapper
extends DefaultTask

Generates scripts (for *nix and windows) which allow you to build your project with Gradle, without having to install Gradle.

When a user executes a wrapper script the first time, the script downloads and installs the appropriate Gradle distribution and runs the build against this downloaded distribution. Any installed Gradle distribution is ignored when using the wrapper scripts.

The scripts generated by this task are intended to be committed to your version control system. This task also generates a small gradle-wrapper.jar bootstrap JAR file and properties file which should also be committed to your VCS. The scripts delegates to this JAR.

Nested Class Summary
static class Wrapper.PathBase
          Specifies how the wrapper path should be interpreted.
 
Nested classes/interfaces inherited from interface org.gradle.api.Task
Task.Namer
 
Field Summary
static String DEFAULT_ARCHIVE_CLASSIFIER
           
static String DEFAULT_ARCHIVE_NAME
           
static String DEFAULT_DISTRIBUTION_PARENT_NAME
           
 
Fields inherited from interface org.gradle.api.Task
TASK_ACTION, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE
 
Constructor Summary
Wrapper()
           
 
Method Summary
 Wrapper.PathBase getArchiveBase()
          The archive base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.
 String getArchivePath()
          Returns the path where the gradle distributions archive should be saved (i.e.
 File getBatchScript()
          Returns the file to write the wrapper batch script to.
 Wrapper.PathBase getDistributionBase()
          The distribution base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.
 String getDistributionPath()
          Returns the path where the gradle distributions needed by the wrapper are unzipped.
 String getDistributionUrl()
          The URL to download the gradle distribution from.
 String getGradleVersion()
          Returns the gradle version for the wrapper.
 File getJarFile()
          Returns the file to write the wrapper jar file to.
 File getPropertiesFile()
          Returns the file to write the wrapper properties to.
 File getScriptFile()
          Returns the file to write the wrapper script to.
 void setArchiveBase(Wrapper.PathBase archiveBase)
          The archive base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.
 void setArchivePath(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(String distributionPath)
          Sets the path where the gradle distributions needed by the wrapper are unzipped.
 void setDistributionUrl(String url)
           
 void setGradleVersion(String gradleVersion)
          The version of the gradle distribution required by the wrapper.
 void setJarFile(Object jarFile)
           
 void setScriptFile(Object scriptFile)
           
 
Methods inherited from class org.gradle.api.internal.AbstractTask
addValidator, compareTo, configure, deleteAllActions, dependsOn, dependsOnTaskDidWork, doFirst, doFirst, doLast, doLast, execute, executeWithoutThrowingTaskFailure, getActions, getAnt, getAsDynamicObject, getConvention, getDependsOn, getDescription, getDidWork, getDynamicObjectHelper, getEnabled, getExecuter, getExtensions, getGroup, getInputs, getLogger, getLogging, getName, getOnlyIf, getOutputs, getPath, getProject, getServices, getStandardOutputCapture, getState, getTaskDependencies, getTemporaryDir, getTemporaryDirFactory, getValidators, hasProperty, injectIntoNewInstance, isEnabled, leftShift, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setExecuter, setGroup, setName, setOnlyIf, setOnlyIf, setProject, setProperty, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

DEFAULT_DISTRIBUTION_PARENT_NAME

public static final String DEFAULT_DISTRIBUTION_PARENT_NAME
See Also:
Constant Field Values

DEFAULT_ARCHIVE_NAME

public static final String DEFAULT_ARCHIVE_NAME
See Also:
Constant Field Values

DEFAULT_ARCHIVE_CLASSIFIER

public static final String DEFAULT_ARCHIVE_CLASSIFIER
See Also:
Constant Field Values
Constructor Detail

Wrapper

public Wrapper()
Method Detail

getScriptFile

public File getScriptFile()
Returns the file to write the wrapper script to.

setScriptFile

public void setScriptFile(Object scriptFile)

getBatchScript

public File getBatchScript()
Returns the file to write the wrapper batch script to.

getJarFile

public File getJarFile()
Returns the file to write the wrapper jar file to.

setJarFile

public void setJarFile(Object jarFile)

getPropertiesFile

public File getPropertiesFile()
Returns the file to write the wrapper properties to.

getDistributionPath

public String getDistributionPath()
Returns the path where the gradle distributions needed by the wrapper are unzipped. The path is relative to the distribution base directory

See Also:
setDistributionPath(String)

setDistributionPath

public void setDistributionPath(String distributionPath)
Sets the path where the gradle distributions needed by the wrapper are unzipped. The path is relative to the distribution base directory

See Also:
setDistributionPath(String)

getGradleVersion

public String getGradleVersion()
Returns the gradle version for the wrapper.

See Also:
setGradleVersion(String)

setGradleVersion

public void setGradleVersion(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.

getDistributionUrl

public String getDistributionUrl()
The URL to download the gradle distribution from.

If not set, the download URL is the default for the specified getGradleVersion().

If getGradleVersion() is not set, will return null.

The wrapper downloads a certain distribution only once and caches it. If your distribution base 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.

setDistributionUrl

public void setDistributionUrl(String url)

getDistributionBase

public Wrapper.PathBase getDistributionBase()
The distribution base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.

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.

getArchivePath

public String getArchivePath()
Returns the path where the gradle distributions archive should be saved (i.e. the parent dir). The path is relative to the archive base directory.

setArchivePath

public void setArchivePath(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().

getArchiveBase

public Wrapper.PathBase getArchiveBase()
The archive base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.

setArchiveBase

public void setArchiveBase(Wrapper.PathBase archiveBase)
The archive base specifies whether the unpacked wrapper distribution should be stored in the project or in the gradle user home dir.

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