Gradle Project and Build Script

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

External

Internal

Overview

A Project is the main API to use to interact with Gradle. All top level statements within a "build.gradle" build script are delegated to the corresponding Project instance and when executed, modify its state.

In case of a multi-project build, It is possible to configure a project build from another build script associated with any project in the hierarchy. This capability is called cross-project configuration. Gradle implements cross-project configuration via configuration injection. Configuration injection is the default way to define common behavior.

Project Coordinates

Gradle reads and builds artifacts that are compatible with Maven repositories, so they are described by Maven project coordinates. Project coordinates artifactId, groupId and version can be read or set in the settings configuration file via the ProjectDescriptor interface, or in the build configuration file via the Project interface, as follows:

Project Name, artifactId

Group, groupId

Version

Top-Level Script Blocks

allprojects{}

Applies the given configuration closure, in order, to the current project and all of its sub-projects.

subprojects{}

Applies the given configuration closure, in order, to all sub-projects of the current project.

artifacts{}

buildscript{}

configurations{}

dependencies{}

repositories{}

sourceSets{}

publishing{}

Multi-Project Builds

Root Project

Multi-Project Build Layout

Project Hierarchy

Sub-Project