Gradle Concepts

External

• DSL reference https://docs.gradle.org/current/dsl/

Internal

• Gradle

Overview

Gradle is a general-purpose build tool, which can build pretty much anything its configuration scripts declare. It is primarily used to build Java and Groovy, but it can build other languages as well.

Configuration Scripts

The configuration scripts are written in the Gradle build language, which is a DSL and a Groovy extension. A build is configured by three types of configuration scripts, which together express build requirements and inform the build runtime: build scripts, a settings script and an init script. Each of those scripts contains executable statements and script blocks, which are a special case of executable statement, consisting in a method invocation on a closure. The logic expressed in a specific script applies to its delegate object. Though syntax is similar for all three scripts, specific blocks must make sense with the delegate object. The corresponding delegate objects for all three types of configuration scripts will be described below.

A configuration script may contain statements, script blocks, and any elements allowed in a Groovy script, such as method and class definitions.

A statement may be a method call, property assignment and local variable definition.

A script block is method call that takes a configuration closure as an argument. Executing the script block results in modification of the associated delegate object, based on the content of the closure. For all Groovy closures, it is the default parameter passed to the closure.

Each configuration script implements the Script interface, which exposes a number of useful methods and properties.

Settings Script

Settings Script

Build Script

Build Script

Init Script

Init Script

Build Lifecycle and Gradle Objects

Each build run results in the instantiation of one or more of these core Gradle types. It starts with a Settings and a Gradle instance, one or more Projects. A Gradle execution results in instantiation and execution of task. Depending on the actual configuration of the build, many others objects are instantiated and used.

Settings

Settings

Gradle

Gradle

Project

A Project is the main API to use to interact with Gradle.

Project

Task

A Task represents a single atomic piece of work for a build.

Task

• Configuration https://docs.gradle.org/current/dsl/org.gradle.api.artifacts.Configuration.html

• A build consists of executing a series of tasks in succession.

• Extensions, as in publishing extension.

• Go through the lifecycle without plugins. Understand. Then introduce essential plugins.

• Most of Gradle's power comes from external plugins

• Java plugin.

• Maven publishing plugin.