Gradle

gradle

A highly scalable build automation tool designed to handle everything from large, multi-project enterprise builds to quick development tasks.

Detected by gradle, gradlew | macOS, Linux, Windows |gradle.org

Sync it gradle.toml

Sync rules

What travels, what stays, what never leaves

Synced4 paths, copied whole to your other machines

~/.gradle/gradle.properties

~/.gradle/init.gradle

~/.gradle/init.gradle.kts

~/.gradle/init.d/directory

Secret fieldsInside a file that otherwise syncs

~/.gradle/gradle.propertieslines starting with

signing.passwordgradle.publish.keygradle.publish.secretsystemProp.gradle.wrapperPasswordsystemProp.http.proxyPasswordsystemProp.https.proxyPassword

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Stays on this machineInside a file that otherwise syncs

~/.gradle/gradle.propertieslines starting with org.gradle.java.home, signing.keyId, signing.secretKeyRingFile, systemProp.http.proxyHost, systemProp.https.proxyHost

…

org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g

# This machine's JDK.

org.gradle.java.home=/Users/octocat/Library/Java/JavaVirtualMachines/temurin-21/Contents/Homemachine-local

# Corporate proxy on this machine's network.

systemProp.http.proxyHost=proxy.example.commachine-local

systemProp.http.proxyPort=8080

systemProp.http.proxyUser=octocat

systemProp.http.proxyPassword=FAKEproxypassword0000

systemProp.https.proxyHost=proxy.example.commachine-local

systemProp.https.proxyPort=8080

systemProp.https.proxyPassword=FAKEproxypassword1111

…

systemProp.gradle.wrapperPassword=FAKEwrapperpassword0000

# OpenPGP signatory held on this machine.

signing.keyId=FAKE5D73machine-local

signing.password=FAKEsigningpassword0000

signing.secretKeyRingFile=/Users/octocat/.gnupg/secring.gpgmachine-local

# Gradle Plugin Portal credentials.

gradle.publish.key=FAKEpublishkey00000000000000000000

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded4 paths, state rather than configuration — never uploaded

~/.gradle/caches/directory

~/.gradle/daemon/directory

~/.gradle/jdks/directory

~/.gradle/wrapper/directory

Not a subtraction from the paths above: this is everything else Gradle writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

Gradle in your home directory Every rule on this page, by file

…

org.gradle.jvmargs=-Xmx4g -XX:MaxMetaspaceSize=1g

# This machine's JDK.

org.gradle.java.home=/Users/octocat/Library/Java/JavaVirtualMachines/temurin-21/Contents/Homemachine-local

# Corporate proxy on this machine's network.

systemProp.http.proxyHost=proxy.example.commachine-local

systemProp.http.proxyPort=8080

systemProp.http.proxyUser=octocat

systemProp.http.proxyPassword=FAKEproxypassword0000

systemProp.https.proxyHost=proxy.example.commachine-local

systemProp.https.proxyPort=8080

systemProp.https.proxyPassword=FAKEproxypassword1111

…

systemProp.gradle.wrapperPassword=FAKEwrapperpassword0000

# OpenPGP signatory held on this machine.

signing.keyId=FAKE5D73machine-local

signing.password=FAKEsigningpassword0000

signing.secretKeyRingFile=/Users/octocat/.gnupg/secring.gpgmachine-local

# Gradle Plugin Portal credentials.

gradle.publish.key=FAKEpublishkey00000000000000000000

…

Each machine keeps its own copy of these.

signing.passwordgradle.publish.keygradle.publish.secretsystemProp.gradle.wrapperPasswordsystemProp.http.proxyPasswordsystemProp.https.proxyPassword

Lifted into your secret store; the rest of the file syncs.

· init.gradle Sync

· init.gradle.kts Sync

· init.d/ Sync

· caches/ Exclude

· daemon/ Exclude

· jdks/ Exclude

· wrapper/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/gradle.tomlThe file this page is generated from

id = "gradle"

name = "Gradle"

homepage = "https://gradle.org"

description = "A highly scalable build automation tool designed to handle everything from large, multi-project enterprise builds to quick development tasks."

icon = "theSVG:gradle"

detect = ["gradle", "gradlew"]

# https://docs.gradle.org/current/userguide/directory_layout.html — "By

# default, the Gradle User Home (~/.gradle or C:\Users\<USERNAME>\.gradle)

# stores global configuration properties, initialization scripts, caches, and

# log files", overridable with GRADLE_USER_HOME. The Windows spelling is the

# user profile root, which resolves to this same ~/.gradle.

# https://docs.gradle.org/current/userguide/init_scripts.html adds the two

# places Gradle picks up initialization scripts on its own:

# $GRADLE_USER_HOME/init.gradle(.kts) and $GRADLE_USER_HOME/init.d/.

paths = [

"~/.gradle/gradle.properties",

"~/.gradle/init.gradle",

"~/.gradle/init.gradle.kts",

"~/.gradle/init.d/",

]

# The same directory_layout page lists these as the rest of the Gradle User

# Home: downloaded dependencies and build state, daemon registries and logs,

# toolchain JDKs, and distributions fetched by the wrapper.

exclude = [

"~/.gradle/caches/",

"~/.gradle/daemon/",

"~/.gradle/jdks/",

"~/.gradle/wrapper/",

]

# gradle.properties mixes credentials with ordinary build settings, so it is

# not a whole-file secret; the fields are lifted out below.

secret = []

# https://docs.gradle.org/current/userguide/signing_plugin.html — "a good

# practice is to store them in the gradle.properties file in the user's Gradle

# home directory", listing signing.keyId / signing.password /

# signing.secretKeyRingFile.

# https://docs.gradle.org/current/userguide/publishing_gradle_plugins.html —

# "Provide the credentials as Gradle properties (gradle.publish.key and

# gradle.publish.secret), usually in $HOME/.gradle/gradle.properties".

# https://docs.gradle.org/current/userguide/networking.html shows

# systemProp.http.proxyPassword in gradle.properties, and

# https://docs.gradle.org/current/userguide/gradle_wrapper.html shows

# systemProp.gradle.wrapperPassword for distributions behind HTTP Basic auth.

[[secret_paths]]

file = "~/.gradle/gradle.properties"

match = { prefix = [

"signing.password",

"gradle.publish.key",

"gradle.publish.secret",

"systemProp.gradle.wrapperPassword",

"systemProp.http.proxyPassword",

"systemProp.https.proxyPassword",

] }

# signing.keyId names the OpenPGP key this machine holds and

# signing.secretKeyRingFile is an absolute path to the keyring on its disk;

# org.gradle.java.home is documented as "the Java home for the Gradle build

# process", another absolute path; the proxy host is the network this machine

# sits behind. Everything else — org.gradle.parallel, org.gradle.caching,

# org.gradle.jvmargs — is a preference the user wants on every machine.

# All five are this user's own: the JDK they installed under their home, the

# signatory they hold, the network this box sits behind. Every one has to be

# set up by hand again after a rebuild, so they are kept: backup.

[[machine_lines]]

file = "~/.gradle/gradle.properties"

match = { prefix = [

"org.gradle.java.home",

"signing.keyId",

"signing.secretKeyRingFile",

"systemProp.http.proxyHost",

"systemProp.https.proxyHost",

] }

scope = "backup"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/gradle. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits org.gradle.java.home and signing.keyId for you — that part is Otty’s own sync, or a template you write by hand.