LinuxCommandLibrary

gradle-properties

TLDR

Display all project properties

$ gradle properties
copy

Display properties with detailed output
$ gradle properties [[-i|--info]]
copy

Display properties for a specific subproject
$ gradle :[subproject]:properties
copy

Display a specific property value
$ gradle properties | grep [property_name]
copy

SYNOPSIS

gradle properties [--all] [--console=|--gradle-user-home=

|--project-cache-dir=|--project-dir=] []

PARAMETERS

--all
    Include non-public properties in output

-P=
    Set project property overriding defaults

--console=
    Set logging verbosity (plain, verbose, debug)

--info
    Set log level to info

--debug
    Set log level to debug

--stacktrace
    Print full stacktrace on error

--no-daemon
    Disable Gradle daemon

--offline
    Work offline, no dependency downloads

-b
    Use specific build file (default build.gradle)

DESCRIPTION

The gradle-properties is not a standard standalone Linux command but refers to the gradle properties task or related property handling in Gradle build tool. When invoked as gradle properties within a Gradle project directory, it lists all available properties for the build script, including system properties, environment variables translated to properties, project properties set via -P, and Gradle-specific properties from gradle.properties files. This is invaluable for debugging build configurations, verifying property inheritance from global/user/project levels, and inspecting effective settings.

Output categorizes properties into sections like 'Build script', 'Gradle properties', and 'System properties'. Use --all flag to include non-public properties. It requires Gradle installed (via package manager or wrapper gradlew) and execution from a project root with build.gradle. Not a native Unix utility but a JVM-based task essential for Java/Android/Kotlin developers managing complex builds.

CAVEATS

Requires Gradle 1.0+ installed; run from project directory; output verbose without --all; daemon recommended for speed but use --no-daemon for isolation.

USAGE EXAMPLE

gradle properties --all
Lists all properties; pipe to grep: gradle properties | grep 'version'

GRADLE.PROPERTIES FILE

Key config file (~/.gradle/gradle.properties for global, project/gradle.properties for local). Edit to set org.gradle.jvmargs=-Xmx2048m.

ALTERNATIVES

Use ./gradlew properties for wrapper; IDEs like IntelliJ show properties in Gradle tool window.

HISTORY

Introduced in Gradle 1.0 (2012) as core task for transparency; enhanced with --all in 2.1 (2014); integrated into Gradle Wrapper since inception for reproducible builds.

SEE ALSO

gradle(1), gradlew(1), java(1)

Copied to clipboard