Property Detail

• static final java.lang.String INSTALLER_VERSION

• static final boolean IS_WINDOWS

Constructor Detail

• protected AbstractDistributionInstaller(java.lang.String distributionName, java.lang.String distributionVersion, java.lang.String basePath, org.gradle.api.Project project)

  Creates setup for installing to a local cache.

  Parameters:

  distributionName - Descriptive name of the distribution

  distributionVersion - Version of the distribution to obtain

  basePath - Relative path below Gradle User Home to create cache for all version of this distribution type.

  project - Gradle project that this downloader is attached to.

Method Detail

• void addExecPattern(java.lang.String... relPaths)

  Add patterns for files to be marked executable, Calling this method multiple times simply appends for patterns

  Parameters:

  relPaths - One or more ANT-stype include patterns

• protected java.io.File getAndVerifyDistributionRoot(java.io.File distDir, java.lang.String distributionDescription)

  Validates that the unpacked distirbution is good. The default implementation simply checks that only one directory should exist.

  Returns:

  The directory where the real distribution now exists. In the default implementation it will be the single directory that exists below distDir.

  Parameters:

  distDir - Directory where distribution was unpacked to.

  distributionDescription - A descriptive name of the distribution

  Throws:

  DistributionFailedException if distribution failed to meet criteria.

• java.io.File getDistributionRoot()

  Returns the location which is the top or home folder for a distribution. This value is affected by setDownloadRoot(java.io.File) and the parameters passed in during construction time.

  Returns:

  Location of the distribution.

• protected ProgressLogger getLogger()

  Returns the logger currently in use.

  Returns:

  Wrapper logger instance

• protected org.gradle.api.Project getProject()

  Returns the attached project

  Returns:

  Attached project instance

• protected java.util.List<java.io.File> listDirs(java.io.File distDir)

  Provides a list of directories below an unpacked distribution

  Returns:

  List of directories. Can be empty is nothing was unpacked or only files exist within the supplied directory.

  Parameters:

  distDir - Unpacked distribution directory

• java.io.File locateDistributionInCustomLocation(java.lang.String version)

  Override this method to provide alternative means to look for distributions.

  Returns:

  Location of distribution or null if none were found.

  Version:

  Version of distribution to locate

• void setChecksum(java.lang.String cs)

  Set a checksum that needs to be verified against downloaded archive

  Parameters:

  cs - SHA-256 Hex-encoded checksum

• void setDownloadRoot(java.io.File downloadRootDir)

  Sets a download root directory for the distribution. If not supplied the default is to use the Gradle User Home. This method is provided for convenience and is mostly only used for testing purposes. The fodler will be created at download time if it does not exist.

  Parameters:

  downloadRootDir - Any writeable directory on the filesystem.

• void setSdkManCandidateName(java.lang.String sdkCandidateName)

  Set candidate name for SdkMan if the latter should be searched for installed versions

  Parameters:

  sdkCandidateName - SDK Candidate name. This is the same names that will be shown when running sdk list candidates on the command-line.

• @groovy.transform.CompileDynamic protected void unpack(java.io.File srcArchive, java.io.File destDir)

  Unpacks a downloaded archive. The default implementation supports

  • zip
  • tar
  • tar.gz & tgz
  • tar.bz2 & tbz

  Parameters:

  srcArchive - The location of the download archive

  destDir - The directory where the archive needs to be unpacked into

• java.net.URI uriFromVersion(java.lang.String version)

  Creates a download URI from a given distribution version

  Returns:

  Parameters:

  version - Version of the distribution to download

• protected void verifyDownloadChecksum(java.lang.String sourceUrl, java.io.File localCompressedFile, java.lang.String expectedSum)

  Verifies the checksum (if provided) of a newly downloaded distribution archive.

  Parameters:

  sourceUrl - The URL/URI where it was downloaded from

  localCompressedFile - The location of the downloaded archive

  expectedSum - The expected checksum. Can be null in which case no checks will be performed.

  Throws:

  ChecksumFailedException if the checksum did not match