gradle/org.gradle.kotlin.dsl/KotlinProjectScriptTemplate

KotlinProjectScriptTemplate

abstract class KotlinProjectScriptTemplate(host: KotlinScriptHost<Project>) : DefaultKotlinScript(source)

Base class for Gradle Kotlin DSL standalone Project scripts IDE support, aka. build scripts.

This class has the Incubating-level compatibility guarantees but is not annotated as such to avoid Unstable API warnings caused by the IDE using this class as the Kotlin DSL script template. When the IDE chooses to use this script template, there is no direct usage of an incubating API by the build author, but usages of the members, such as plugins, are still reported as unstable API usages. See: issue 34820.

Since

8.1

Constructors

KotlinProjectScriptTemplate

constructor(host: KotlinScriptHost<Project>)

Properties

open override val logger: Logger

Logger for scripts. You can use this in your script to write log messages.

open override val logging: LoggingManager

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.

open override val resources: ResourceHandler

Provides access to resource-specific utility methods, for example factory methods that create various resources.

Functions

open fun buildscript(block: ScriptHandlerScope.() -> Unit)

Configures the build script classpath for this project.

open override fun copy(configuration: Action<CopySpec>): WorkResult

Copies the specified files.

open override fun copySpec(): CopySpec

open override fun copySpec(configuration: Action<CopySpec>): CopySpec

Creates a {@link CopySpec} which can later be used to copy files or create an archive.

open override fun delete(configuration: Action<DeleteSpec>): WorkResult

Deletes the specified files.

open override fun delete(vararg paths: Any): Boolean

Deletes files and directories.

open override fun file(path: Any): File

open override fun file(path: Any, validation: PathValidation): File

Resolves a file path relative to this script's target base directory.

open override fun files(vararg paths: Any): ConfigurableFileCollection

open override fun files(paths: Any, configuration: Action<ConfigurableFileCollection>): ConfigurableFileCollection

Creates a ConfigurableFileCollection containing the given files.

open override fun fileTree(baseDir: Any): ConfigurableFileTree

open override fun fileTree(baseDir: Any, configuration: Action<ConfigurableFileTree>): ConfigurableFileTree

Creates a new ConfigurableFileTree using the given base directory.

fun getBuildscript(): ScriptHandler

The ScriptHandler for this script.

open override fun mkdir(path: Any): File

Creates a directory and returns a file pointing to it.

fun plugins(block: PluginDependenciesSpecScope.() -> Unit)

Configures the plugin dependencies for this project.

open override fun relativePath(path: Any): String

Returns the relative path from this script's target base directory to the given path.

open override fun tarTree(tarPath: Any): FileTree

Creates a new FileTree which contains the contents of the given TAR file.

open override fun uri(path: Any): URI

Resolves a file path to a URI, relative to this script's target base directory.

open override fun zipTree(zipPath: Any): FileTree

Creates a new FileTree which contains the contents of the given ZIP file.