Gradle Properties - Runtime and Project Configuration: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
Line 17: Line 17:
The external configuration and extra properties become part of the state of various objects of the build, such as projects or tasks. The state of build objects can be read from the build scripts via dedicated accessors.  
The external configuration and extra properties become part of the state of various objects of the build, such as projects or tasks. The state of build objects can be read from the build scripts via dedicated accessors.  


<span id='Project_State'></span>A '''project''' exposes coordinates such as [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Name|name]], [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Group|group]] and [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Version|version]], various other state elements such as the [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Description|description]], [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Path|path]], and externally configured properties that come from [[gradle.properties]] file hierarchy. More details about accessing the state of the project is available in: {{Internal|Gradle Project Coordinates and State Properties|Gradle Project Coordinates and State Properties}}
<span id='Project_State'></span>A '''project''' exposes coordinates such as [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Name|name]], [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Group|group]] and [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Version|version]], various other state elements such as the [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Description|description]], [[Gradle_Project_Coordinates,_State_and_Configured_Properties#Path|path]], and externally configured properties that come from [[gradle.properties]] file hierarchy. More details about accessing the state of the project is available in: {{Internal|Gradle_Project_Coordinates,_State_and_Configured_Properties|Gradle Project Coordinates, State and Configured Properties}}


<span id='Task_State'></span>A '''task''' also exposes its state ([[Gradle_Task#Task_Name|name]], [[Gradle_Task#Description|description]], whether it is [[Gradle_Task#Enabled|enabled]] or not) through getters and DLS elements.
<span id='Task_State'></span>A '''task''' also exposes its state ([[Gradle_Task#Task_Name|name]], [[Gradle_Task#Description|description]], whether it is [[Gradle_Task#Enabled|enabled]] or not) through getters and DLS elements.

Revision as of 05:49, 5 October 2020

External

Internal

Overview

"Properties" in this context represent external configuration elements passed to a Gradle build to modify the behavior of the Gradle runtime itself, or the behavior of tasks being executed by various projects that are part of the build. Gradle supports many kinds of "properties": configuration can be passed as command line flags, system properties, Gradle properties, environment variables and project properties. Some of these properties can be declared in the gradle.properties hierarchy. All these configuration elements are provided externally and injected into the build.

Gradle Command Line Flags
Gradle System Properties
Gradle Properties
Gradle Environment Variables
Gradle Project Properties

It is also possible to define properties in settings.gradle and build.gradle scripts and pass configuration around between different elements of the build. Those properties are named extra properties.

Gradle Extra Properties

Since build scripts may include executable code, it is also possible to use local variables, which are a feature of the underlying Groovy language.

Gradle Local Variables

The external configuration and extra properties become part of the state of various objects of the build, such as projects or tasks. The state of build objects can be read from the build scripts via dedicated accessors.

A project exposes coordinates such as name, group and version, various other state elements such as the description, path, and externally configured properties that come from gradle.properties file hierarchy. More details about accessing the state of the project is available in:

Gradle Project Coordinates, State and Configured Properties

A task also exposes its state (name, description, whether it is enabled or not) through getters and DLS elements.

TO DEPLETE

Gradle_Variables_and_Properties
Gradle Configuration