Gradle-.gitignore-Vorlage erklärt
Erklärt die Struktur von Gradle.gitignore, die die Ordner .gradle und build ignoriert, build-Ordner unter src und das Gradle-Wrapper-jar aber per Negationsmuster wieder aufnimmt.
Gradle.gitignore hat nur 9 Zeilen, nutzt aber drei Negationsmuster, um genau das zu schützen, was nicht ignoriert werden darf. Meist wird sie zusammen mit den Vorlagen Java oder Kotlin verwendet.
Der Gradle-Wrapper (gradlew, gradle/wrapper/gradle-wrapper.jar, gradle-wrapper.properties) ermöglicht auch Personen ohne installiertes Gradle einen Build mit derselben Version und muss daher unbedingt committet werden. Auch die offizielle Gradle-Dokumentation empfiehlt, die Wrapper-Dateien unter Versionskontrolle zu stellen.
Regeln im Einzelnen
| Muster | Was ignoriert wird und warum |
|---|---|
.gradle | Gradle-CacheOrdner, in dem der projektspezifische Task-Cache und Datei-Hashes gespeichert werden. Nach dem Löschen wird er beim nächsten Build neu angelegt. |
**/build/!**/src/**/build/ | Build-Ordner und AusnahmenSchließt den Ausgabeordner build/ aller Module aus, nimmt aber ein Paket oder einen Ordner namens build wieder auf, der zufällig im Quellbaum (src/) liegt. So wird etwa verhindert, dass src/main/java/com/example/build/ für ein Build-Artefakt gehalten wird und verschwindet. |
!gradle-wrapper.jar!gradle-wrapper.properties | Schutz des WrappersNimmt das Wrapper-jar wieder auf, damit die Regel *.jar der Java- und Kotlin-Vorlagen es nicht ignoriert. Da git der zuletzt passenden Regel folgt, wirkt diese Zeile nur, wenn sie nach *.jar steht. |
gradle-app.setting.gradletasknamecache | GUI- und Task-CachesEinstellungen der Gradle-GUI und Cache der Task-Namen für die Shell-Autovervollständigung. |
.project.classpath | Von Eclipse erzeugte DateienProjektdateien, die Eclipse Buildship aus der Gradle-Konfiguration erzeugt. Sie lassen sich jederzeit aus den Build-Skripten neu erstellen. |
Hinweise für die Praxis
- Wählen Sie im Generator zuerst Java (oder Kotlin), danach Gradle. In umgekehrter Reihenfolge steht
!gradle-wrapper.jarvorn, und*.jardahinter ignoriert die Datei erneut. Prüfen können Sie das, indem Siegradle/wrapper/gradle-wrapper.jarin den Mustertester eingeben. gradle.propertieswird nicht ignoriert. Persönliche Signaturdaten oder Tokens gehören jedoch nicht in die Projektdatei, sondern in~/.gradle/gradle.propertiesim Benutzerverzeichnis.local.properties(Android-SDK-Pfad) ist in dieser Vorlage nicht enthalten; bei Android-Projekten verwenden Sie zusätzlich die Android-Vorlage.
Originalvorlage
.gradle**/build/!**/src/**/build/# Ignore Gradle GUI configgradle-app.setting# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)!gradle-wrapper.jar# Avoid ignore Gradle wrapper properties!gradle-wrapper.properties# Cache of project.gradletasknamecache# Eclipse Gradle plugin generated files# Eclipse Core.project# JDT-specific (Eclipse Java Development Tools).classpath
Vorlagenquelle: github/gitignore/Gradle.gitignore @356fd7b (2026-09-11) · CC0-1.0