Modèle .gitignore Gradle expliqué
Explique la structure de Gradle.gitignore, qui ignore les dossiers .gradle et build tout en réincluant par des motifs de négation les dossiers build situés sous src et le jar du wrapper Gradle.
Gradle.gitignore ne compte que 9 lignes, mais utilise trois motifs de négation pour préserver précisément ce qui ne doit pas être ignoré. On l'emploie presque toujours avec les modèles Java ou Kotlin.
Le wrapper Gradle (gradlew, gradle/wrapper/gradle-wrapper.jar, gradle-wrapper.properties) permet à une personne qui n'a pas installé Gradle de compiler avec la même version : il faut impérativement le commiter. La documentation officielle de Gradle recommande elle aussi de placer les fichiers du wrapper sous contrôle de version.
Explication règle par règle
| Motif | Ce qui est ignoré et pourquoi |
|---|---|
.gradle | Cache GradleDossier où sont stockés le cache des tâches du projet et les empreintes des fichiers. Supprimé, il est recréé au build suivant. |
**/build/!**/src/**/build/ | Dossiers build et exceptionsExclut le dossier de sortie build/ de tous les modules, mais réinclut un paquet ou dossier nommé build qui se trouverait par hasard dans l'arborescence des sources (src/). Cela évite par exemple que src/main/java/com/example/build/ soit pris pour un artefact de build et disparaisse. |
!gradle-wrapper.jar!gradle-wrapper.properties | Protection du wrapperRéinclut le jar du wrapper pour que la règle *.jar des modèles Java·Kotlin ne l'ignore pas. Comme git suit la dernière règle correspondante, cette ligne n'a d'effet que si elle se trouve après *.jar. |
gradle-app.setting.gradletasknamecache | Caches de l'interface graphique et des tâchesRéglages de l'interface graphique de Gradle et cache des noms de tâches pour l'autocomplétion du shell. |
.project.classpath | Fichiers générés par EclipseFichiers de projet générés par Eclipse Buildship à partir de la configuration Gradle. On peut les recréer à tout moment à partir des scripts de build. |
Points d'attention en pratique
- Dans le générateur, sélectionnez d'abord Java (ou Kotlin), puis Gradle. Dans l'ordre inverse,
!gradle-wrapper.jarpasse devant et*.jar, placé après, l'ignore de nouveau. Vous pouvez le vérifier en saisissantgradle/wrapper/gradle-wrapper.jardans le testeur de motifs. gradle.propertiesn'est pas ignoré. En revanche, les informations de signature personnelles et les jetons se placent non pas dans le fichier du projet mais dans~/.gradle/gradle.properties, dans votre dossier personnel.local.properties(chemin du SDK Android) ne figure pas dans ce modèle : pour un projet Android, utilisez aussi le modèle Android.
Modèle d'origine
.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
Source des modèles : github/gitignore/Gradle.gitignore @356fd7b (2026-09-11) · CC0-1.0