Script (Gradle API 8.14) (original) (raw)

• Method Details

  • apply

  Configures the delegate object for this script using plugins or scripts.
  The given closure is used to configure an ObjectConfigurationAction which is then used to configure the delegate object.
  Parameters:
  closure - The closure to configure the ObjectConfigurationAction.

  • apply

  Configures the delegate object for this script using plugins or scripts.
  The following options are available:
  * from: A script to apply to the delegate object. Accepts any path supported by uri(Object).
  * plugin: The id or implementation class of the plugin to apply to the delegate object.
  * to: The target delegate object or objects.
  For more detail, see ObjectConfigurationAction.
  Parameters:
  options - The options to use to configure the ObjectConfigurationAction.

  • getBuildscript

  Returns the script handler for this script. You can use this handler to manage the classpath used to compile and execute this script.
  Returns:
  the classpath handler. Never returns null.

  • buildscript

  void buildscript(Closure configureClosure)
  Configures the classpath for this script.
  The given closure is executed against this script's ScriptHandler. The ScriptHandler is passed to the closure as the closure's delegate.
  Parameters:
  configureClosure - the closure to use to configure the script classpath.

  • file

  Resolves a file path relative to the directory containing this script. This works as described for Project.file(Object)
  Parameters:
  path - The object to resolve as a File.
  Returns:
  The resolved file. Never returns null.

  • file

  Resolves a file path relative to the directory containing this script and validates it using the given scheme. See PathValidation for the list of possible validations.
  Parameters:
  path - An object to resolve as a File.
  validation - The validation to perform on the file.
  Returns:
  The resolved file. Never returns null.
  Throws:
  [InvalidUserDataException](InvalidUserDataException.html "class in org.gradle.api") - When the file does not meet the given validation constraint.

  • uri

  Resolves a file path to a URI, relative to the directory containing this script. Evaluates the provided path object as described for file(Object), with the exception that any URI scheme is supported, not just 'file:' URIs.
  Parameters:
  path - The object to resolve as a URI.
  Returns:
  The resolved URI. Never returns null.

  • files

  Parameters:
  paths - The paths to the files. May be empty.
  Returns:
  The file collection. Never returns null.

  • files

  Creates a new ConfigurableFileCollection using the given paths. The file collection is configured using the given closure. This method works as described for Project.files(Object, groovy.lang.Closure). Relative paths are resolved relative to the directory containing this script.
  Parameters:
  paths - The contents of the file collection. Evaluated as per files(Object...).
  configureClosure - The closure to use to configure the file collection.
  Returns:
  the configured file tree. Never returns null.

  • relativePath

  Returns the relative path from the directory containing this script to the given path. The given path object is (logically) resolved as described for file(Object), from which a relative path is calculated.
  Parameters:
  path - The path to convert to a relative path.
  Returns:
  The relative path. Never returns null.

  • fileTree

  Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as per file(Object).
  The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
  Parameters:
  baseDir - The base directory of the file tree. Evaluated as per file(Object).
  Returns:
  the file tree. Never returns null.

  • fileTree

  Creates a new ConfigurableFileTree using the provided map of arguments. The map will be applied as properties on the new file tree. Example:
  fileTree(dir:'src', excludes:['/ignore/','/.svn/'])

  The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
  Parameters:
  args - map of property assignments to ConfigurableFileTree object
  Returns:
  the configured file tree. Never returns null.

  • fileTree

  Creates a new ConfigurableFileTree using the given base directory. The given baseDir path is evaluated as per file(Object). The closure will be used to configure the new file tree. The file tree is passed to the closure as its delegate. Example:
  fileTree('src') {
  exclude '/.svn/'
  }.copy { into 'dest'}

  The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
  Parameters:
  baseDir - The base directory of the file tree. Evaluated as per file(Object).
  configureClosure - Closure to configure the ConfigurableFileTree object.
  Returns:
  the configured file tree. Never returns null.

  • zipTree

  Creates a new FileTree which contains the contents of the given ZIP file. The given zipPath path is evaluated as per file(Object). You can combine this method with the copy(groovy.lang.Closure) method to unzip a ZIP file.
  The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
  Parameters:
  zipPath - The ZIP file. Evaluated as per file(Object).
  Returns:
  the file tree. Never returns null.

  • tarTree

  Creates a new FileTree which contains the contents of the given TAR file. The given tarPath path can be:
  * an instance of Resource
  * any other object is evaluated as per file(Object)
  The returned file tree is lazy, so that it scans for files only when the contents of the file tree are queried. The file tree is also live, so that it scans for files each time the contents of the file tree are queried.
  Unless custom implementation of resources is passed, the tar tree attempts to guess the compression based on the file extension.
  You can combine this method with the copy(groovy.lang.Closure) method to untar a TAR file:
  task untar(type: Copy) {
  from tarTree('someCompressedTar.gzip')
  //tar tree attempts to guess the compression based on the file extension
  //however if you must specify the compression explicitly you can:
  from tarTree(resources.gzip('someTar.ext'))
  //in case you work with unconventionally compressed tars
  //you can provide your own implementation of a ReadableResource:
  //from tarTree(yourOwnResource as ReadableResource)
  into 'dest'
  }

  Parameters:
  tarPath - The TAR file or an instance of Resource.
  Returns:
  the file tree. Never returns null.

  • copy

  Copy the specified files. The given closure is used to configure a CopySpec, which is then used to copy the files. Example:
  copy {
  from configurations.runtimeClasspath
  into 'build/deploy/lib'
  }

  Note that CopySpecs can be nested:
  copy {
  into 'build/webroot'
  exclude '/.svn/'
  from('src/main/webapp') {
  include '/*.jsp'
  filter(ReplaceTokens, tokens:[copyright:'2009', version:'2.3.1'])
  }
  from('src/main/js') {
  include '/*.js'
  }
  }

  Parameters:
  closure - Closure to configure the CopySpec
  Returns:
  WorkResult that can be used to check if the copy did any work.

  • copySpec

  Creates a CopySpec which can later be used to copy files or create an archive. The given closure is used to configure the CopySpec before it is returned by this method.
  Parameters:
  closure - Closure to configure the CopySpec
  Returns:
  The CopySpec

  • mkdir

  Creates a directory and returns a file pointing to it.
  Parameters:
  path - The path for the directory to be created. Evaluated as per file(Object).
  Returns:
  the created directory
  Throws:
  [InvalidUserDataException](InvalidUserDataException.html "class in org.gradle.api") - If the path points to an existing file.

  • delete

  boolean delete(Object... paths)
  Deletes files and directories.
  Parameters:
  paths - Any type of object accepted by Project.files(Object...)
  Returns:
  true if anything got deleted, false otherwise

  • javaexec

  Executes a Java main class. The closure configures a JavaExecSpec.
  Parameters:
  closure - The closure for configuring the execution.
  Returns:
  the result of the execution

  • javaexec

  Executes a Java main class.
  Parameters:
  action - The action for configuring the execution.
  Returns:
  the result of the execution

  • exec

  Executes an external command. The closure configures a ExecSpec.
  Parameters:
  closure - The closure for configuring the execution.
  Returns:
  the result of the execution

  • exec

  Executes an external command.
  Parameters:
  action - The action for configuring the execution.
  Returns:
  the result of the execution

  • getLogging

  Returns the LoggingManager which can be used to receive logging and to control the standard output/error capture for this script. By default, System.out is redirected to the Gradle logging system at the QUIET log level, and System.err is redirected at the ERROR log level.
  Returns:
  the LoggingManager. Never returns null.

  • getLogger

  Returns the logger for this script. You can use this in your script to write log messages.
  Returns:
  The logger. Never returns null.

  • getResources

  Provides access to resource-specific utility methods, for example factory methods that create various resources.
  Returns:
  Returned instance contains various resource-specific utility methods.

  • provider

  Creates a Provider implementation based on the provided value.
  Parameters:
  value - The java.util.concurrent.Callable use to calculate the value.
  Returns:
  The provider. Never returns null.
  Throws:
  [InvalidUserDataException](InvalidUserDataException.html "class in org.gradle.api") - If the provided value is null.
  Since:
  4.0
  See Also:
  * ProviderFactory.provider(Callable)