Gradle System Properties

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

Internal

Overview

System properties can be provided with the -D command-line options, loaded from ~/.gradle/gradle.properties or from the project's gradle.properties. Explain precedence.

Properties

org.gradle.console

Sets console output coloring and verbosity.

org.gradle.daemon

org.gradle.debug

Starts Gradle in debug mode with the JVM listening on port 5005. Used together with --no-daemon. For more details see:

Gradle Operations | Debug a Gradle Build | External Gradle Process

org.gradle.java.home

Specifies the Java home for the Gradle build process.

org.gradle.jvmargs

Specifies the JVM arguments for the Gradle build process. TODO: https://docs.gradle.org/current/userguide/build_environment.html#sec:configuring_jvm_memory

Attaching a Debugger to a Gradle Daemon

A Gradle daemon can be started in debug mode, so an IDE can attach and debug a build, by specifying JVM debug flags which ensure the JVM starts in suspend mode, as follows:

org.gradle.jvmargs="-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=10001"

Note that once a Gradle daemon starts in debug mode, it remains in debug mode so the IDE can attach to it and debug successive builds without restarting the daemon. More details about Gradle debugging are available in:

Gradle Operations | Debug a Gradle Build | External Gradle Process

org.gradle.logging.level

https://docs.gradle.org/current/userguide/logging.html#sec:choosing_a_log_level

org.gradle.warning.mode

org.gradle.parallel

Parallel mode configuration.

org.gradle.workers.max

Parallel mode configuration.