TOC

Un guide rapide sur Maven Wrapper

Un guide rapide sur Maven Wrapper

1. Vue d'ensemble

LeMaven Wrapper est un excellent choix pour les projets qui nécessitent une version spécifique de Maven (ou pour les utilisateurs qui ne veulent pas du tout installer Maven). Instead of installing many versions of it in the operating system, we can just use the project-specific wrapper script.

Dans cet article rapide, nous allons montrer comment configurer un wrapper Maven pour un projet Maven existant.

2. Configuration du Maven Wrapper

Il existe deux façons de le configurer dans un projet, la plus simple étant d'utiliser un plug-in approprié pour l'automatiser ou en appliquant l'installation manuelle.

2.1. Brancher

Utilisons cesMaven Wrapper plugin pour effectuer une installation automatique dans un simple projet Spring Boot.

Tout d’abord, nous devons aller dans le dossier principal du projet et lancer cette commande: 

mvn -N io.takari:maven:wrapper

Nous pouvons également spécifier la version de Maven: 

mvn -N io.takari:maven:wrapper -Dmaven=3.5.2

L'option-N signifie–non-recursive de sorte que le wrapper ne sera appliqué qu'au projet principal du répertoire courant, pas dans les sous-modules.

Après avoir exécuté l'objectif, nous aurons plus de fichiers et de répertoires dans le projet:

  • mvnw: c'est un script shell Unix exécutable utilisé à la place d'un Maven entièrement installé

  • mvnw.cmd: c'est la version Batch du script ci-dessus

  • mvn: le dossier caché qui contient la bibliothèque Java Maven Wrapper et son fichier de propriétés

2.2. Manuel

Avec une approche manuelle, nous pouvons copier les fichiers et les dossiers vus ci-dessus d'un autre projet dans le dossier principal du projet actuel.

Ensuite, nous devons spécifier la version de Maven à utiliser dans le fichier de propriétés du wrapper situé dans le fichier.mvn/wrapper/maven-wrapper.properties.

Par exemple, notre fichier de propriétés a la ligne suivante: 

distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.2/apache-maven-3.5.2-bin.zip

Par conséquent, la version 3.5.2 sera téléchargée et utilisée.

3. Cas d'utilisation

Le wrapper doit fonctionner avec différents systèmes d'exploitation tels que:

  • Linux

  • OSX

  • les fenêtres

  • Solaris

Après cela, nous pouvons définir nos objectifs comme ceci pour le système Unix: 

./mvnw clean install

Et la commande suivante pour Batch: 

./mvnw.cmd clean install

Si nous n'avons pas le Maven spécifié dans les propriétés du wrapper, il sera téléchargé et installé dans le dossier$USER_HOME/.m2/wrapper/dists du système.

Lançons notre projet Spring-Boot: 

./mvnw spring-boot:run

La sortie est la même que pour un Maven entièrement installé:

image

Remarque: nous utilisons l'exécutablemvnw à la place demvn, qui est maintenant le programme de ligne de commande Maven.

4. Conclusion

Dans ce didacticiel, nous avons vu comment configurer et utiliser Maven Wrapper dans un projet Maven.

Comme toujours, le code source de cet article peut être trouvéover on GitHub.

Related