Modèle .gitignore Maven expliqué

Maven.gitignore bloque les fichiers que Maven crée pendant le build et la publication. L'outil étant conçu pour rassembler tous les artefacts dans target/, les règles sont simples.

Pour le wrapper Maven, la pratique recommandée récemment consiste à commiter mvnw, mvnw.cmd et .mvn/wrapper/maven-wrapper.properties, et à ignorer le jar comme le fait le modèle. Le script du wrapper télécharge le jar ou la distribution Maven quand il en a besoin.

Explication règle par règle

Motif	Ce qui est ignoré et pourquoi
target/	Sortie de buildDossier de sortie standard où se rassemblent les classes compilées, les résultats de tests et les jar·war empaquetés. On le supprime avec mvn clean et on le recrée.
pom.xml.tagpom.xml.releaseBackuppom.xml.nextrelease.properties	Fichiers du plugin releaseSauvegardes et fichiers d'état de progression créés par maven-release-plugin pendant release:prepare. Ils deviennent inutiles une fois la publication terminée ou annulée.
pom.xml.versionsBackup	Sauvegardes du plugin versionsSauvegarde de l'original laissée par versions-maven-plugin avant versions:set.
dependency-reduced-pom.xmlbuildNumber.properties	Fichiers générés par des pluginsPOM réduit créé par maven-shade-plugin et fichier de numéro du plugin buildnumber.
.mvn/timing.properties	Mesures localesRésultats de mesure des temps de build, dont les valeurs diffèrent selon la personne.
.mvn/wrapper/maven-wrapper.jar	Jar du wrapperBinaire que le script du wrapper peut télécharger quand il en a besoin. La documentation de Maven Wrapper citée par le modèle explique comment s'en passer.
.project.classpath	Fichiers Eclipse m2eFichiers de projet générés par Eclipse à partir du POM.

Points d'attention en pratique

• .mvn/maven.config et .mvn/jvm.config sont des options de build communes à l'équipe : commitez-les. Ce modèle ne les ignore pas.
• Si vous placez des mots de passe de dépôt dans settings.xml, mettez-les non pas dans le projet mais dans ~/.m2/settings.xml.
• Si vous utilisez IntelliJ, sélectionnez aussi le modèle JetBrains.

Modèle d'origine

target/pom.xml.tagpom.xml.releaseBackuppom.xml.versionsBackuppom.xml.nextrelease.propertiesdependency-reduced-pom.xmlbuildNumber.properties.mvn/timing.properties# https://maven.apache.org/tools/wrapper/#Usage_with_or_without_Binary_JAR.mvn/wrapper/maven-wrapper.jar# Eclipse m2e generated files# Eclipse Core.project# JDT-specific (Eclipse Java Development Tools).classpath

Modèles utilisés ensemble

Autres modèles expliqués