Gradle Operations TODEPLETE
Internal
Overview
Command Line
Some command line options have the same effect as setting corresponding properties or environment variables. When a command line option is present, it has precedence over the equivalent properties or environment variables. More details in Gradle Variables and Properties.
gradle --help
-q, --quiet
Quiet.
-m, --dry-run
Executes a dry run.
-D, --system-prop
'-D' can be used to set a system property in the JVM:
... -Dmyprop=myvalue ...
The property can then by accessed from various Gradle scripts as described here:
--build-cache
Runtime Configuration
Various aspects of the runtime configuration are controlled with Gradle properties:
- org.gradle.console: console output coloring and verbosity.
- org.gradle.debug: starts the JVM in debug mode, listening on port 5005. This is equivalent with adding the following on the JVM command line:
-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5005
- org.gradle.java.home, org.gradle.jvmargs specifies the Java home and JVM arguments for the Gradle build process.
Operations
Start a Project
gradle init
Creates a project structure that includes:
- build.gradle
- settings.gradle
- a project-level gradle directory
- a project-level .gradle directory
- gradlew, gradlew.bat
List Sub-Projects
gradle projects
Inspect Dependencies
The full graph of the project's dependencies can be rendered. The selection reason and origin for a dependency can also be displayed.
To display the dependency trees for all dependency configurations of the project, execute:
gradle -q dependencies
The result is called a dependency report. Any dependency that could not be resolved is marked with FAILED in red color. Dependencies with the same coordinates that can occur multiple times in the graph are omitted and indicated by an asterisk. Dependencies that had to undergo conflict resolution render the requested and selected version separated by a right arrow character. The dependency report provides the raw list of dependencies but does not explain why they have been selected or which dependency is responsible for pulling them into the graph. These explanations can though be generated, see Identify Why a Specific Dependency was Selected.
To display the dependency tree for just one dependency configuration:
gradle -q dependencies --configuration <configuration-name>
Identify Why a Specific Dependency was Selected
gradle -q dependencyInsight --dependency <dependency-name> [--configuration <configuration-name>]
Print the Runtime Classpath
task printClasspath {
doLast {
configurations.runtimeClasspath.each { print it; print ':' }
}
}
Artifact Publishing Operations
Command-Line Interface
Tasks
build
Build without tests. Works with simple projects or multi-project builds.
gradle build -x test gradle build -x :some-project:test
Build a sub-project:
gradle :<sub-project-name>:build
projects
gradle projects
tasks
properties
Displays project properties, properties added by various plugins and their default values.
gradle properties