TP1.2 — Installation de Maven 3.9.x

Objectifs

Ce travail pratique vous permettra de:

• Installer Apache Maven 3.9.x sur votre système d'exploitation
• Configurer les variables d'environnement nécessaires
• Vérifier que l'installation fonctionne correctement
• Comprendre le rôle de Maven dans un projet Spring Boot

Durée estimée: 30-45 minutes

---

Pourquoi Maven?

Apache Maven est l'outil de build standard pour les projets Java et Spring Boot. Il gère:

• Les dépendances : téléchargement automatique des librairies nécessaires
• Le build : compilation, tests, packaging de l'application
• Le cycle de vie : clean → compile → test → package → install → deploy

Votre code Java  ──►  Maven  ──►  Application prête (.jar)
                        │
                        ├── Télécharge les dépendances
                        ├── Compile le code
                        ├── Exécute les tests
                        └── Crée le fichier .jar

Version recommandée

Nous utilisons Maven 3.9.x pour sa compatibilité optimale avec Java 17+ et Spring Boot 3.x.

---

Prérequis

Avant d'installer Maven, vous devez avoir Java JDK 17 ou supérieur installé.

Vérifier Java

java -version

Résultat attendu (exemple):

openjdk version "17.0.x" 2024-xx-xx
OpenJDK Runtime Environment ...
OpenJDK 64-Bit Server VM ...

Si Java n'est pas installé, consultez notre guide détaillé :

👉 TP : Installation de Java JDK 17

Ou téléchargez-le directement depuis :

• Eclipse Adoptium (Temurin) (recommandé)
• Oracle JDK

---

Installation sur Windows

Étape 1: Télécharger Maven

1. Allez sur https://maven.apache.org/download.cgi
2. Téléchargez le fichier Binary zip archive : apache-maven-3.9.9-bin.zip

Lien direct

apache-maven-3.9.9-bin.zip

Si la version 3.9.9 n'est plus disponible, prenez la dernière version 3.9.x sur la page de téléchargement.

Étape 2: Extraire l'archive

1. Créez un dossier C:\Program Files\Maven (ou C:\maven)
2. Extrayez le contenu du ZIP dans ce dossier
3. Vous devriez avoir : C:\Program Files\Maven\apache-maven-3.9.9

C:\Program Files\Maven\
└── apache-maven-3.9.9\
    ├── bin\
    │   ├── mvn.cmd        ← L'exécutable Maven
    │   └── mvnDebug.cmd
    ├── boot\
    ├── conf\
    │   └── settings.xml
    └── lib\

Étape 3: Configurer la variable MAVEN_HOME

1. Ouvrez le menu Démarrer → tapez "variables d'environnement"
2. Cliquez sur "Modifier les variables d'environnement système"
3. Cliquez sur "Variables d'environnement..."
4. Dans Variables système, cliquez sur Nouveau :
   • Nom de la variable : MAVEN_HOME
   • Valeur de la variable : C:\Program Files\Maven\apache-maven-3.9.9
5. Cliquez sur OK

Étape 4: Ajouter Maven au PATH

1. Dans Variables système, trouvez la variable Path
2. Cliquez sur Modifier
3. Cliquez sur Nouveau
4. Ajoutez : %MAVEN_HOME%\bin
5. Cliquez sur OK pour fermer toutes les fenêtres

Étape 5: Vérifier l'installation

Fermez tous les terminaux ouverts, puis ouvrez un nouveau terminal (CMD ou PowerShell):

mvn -version

Résultat attendu:

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: C:\Program Files\Maven\apache-maven-3.9.9
Java version: 17.0.x, vendor: Eclipse Adoptium
Default locale: fr_CA, platform encoding: UTF-8
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

Important

Si mvn n'est pas reconnu après avoir configuré le PATH, redémarrez votre terminal ou même votre ordinateur. Les variables d'environnement ne sont pas rechargées dans les terminaux déjà ouverts.

Alternative Windows : Installation avec Chocolatey

Si vous avez Chocolatey installé, l'installation est plus simple :

choco install maven --version=3.9.9

Alternative Windows : Installation avec Scoop

Si vous avez Scoop installé :

scoop install maven

---

Installation sur macOS

Option 1 : Homebrew (Recommandé)

Homebrew est le gestionnaire de paquets le plus populaire sur macOS.

Installer Homebrew (si ce n'est pas déjà fait):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Installer Maven:

brew install maven

Vérifier:

mvn -version

astuce

Homebrew installe automatiquement la dernière version stable de Maven 3.9.x et configure le PATH pour vous.

Option 2 : Installation manuelle

Étape 1: Télécharger Maven

cd ~/Downloads
curl -O https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

Étape 2: Extraire l'archive

sudo mkdir -p /opt/maven
sudo tar -xzf apache-maven-3.9.9-bin.tar.gz -C /opt/maven

Étape 3: Configurer les variables d'environnement

Ouvrez votre fichier de profil shell :

Pour zsh (macOS par défaut depuis Catalina):

nano ~/.zshrc

Pour bash:

nano ~/.bash_profile

Ajoutez les lignes suivantes à la fin du fichier:

# Apache Maven
export MAVEN_HOME=/opt/maven/apache-maven-3.9.9
export PATH=$MAVEN_HOME/bin:$PATH

Sauvegardez (Ctrl+O, Enter, Ctrl+X), puis rechargez le profil:

source ~/.zshrc

Étape 4: Vérifier

mvn -version

Résultat attendu:

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: /opt/maven/apache-maven-3.9.9
Java version: 17.0.x, vendor: Eclipse Adoptium
...
OS name: "mac os x", ...

Option 3 : SDKMAN!

SDKMAN! est un outil qui gère les versions de Java, Maven, Gradle, etc.

# Installer SDKMAN!
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# Installer Maven
sdk install maven 3.9.9

---

Installation sur Linux

Option 1 : Gestionnaire de paquets (Ubuntu/Debian)

sudo apt update
sudo apt install maven

Attention à la version

Les dépôts officiels Ubuntu/Debian peuvent contenir une version ancienne de Maven. Vérifiez la version installée:

mvn -version

Si la version est inférieure à 3.9, préférez l'installation manuelle ci-dessous.

Option 2 : Installation manuelle (Recommandé)

Étape 1: Télécharger Maven

cd /tmp
wget https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

Étape 2: Extraire et installer

sudo mkdir -p /opt/maven
sudo tar -xzf apache-maven-3.9.9-bin.tar.gz -C /opt/maven

Étape 3: Configurer les variables d'environnement

Créez un fichier de configuration Maven:

sudo nano /etc/profile.d/maven.sh

Ajoutez le contenu suivant:

#!/bin/bash
export MAVEN_HOME=/opt/maven/apache-maven-3.9.9
export PATH=$MAVEN_HOME/bin:$PATH

Rendez le fichier exécutable et chargez-le:

sudo chmod +x /etc/profile.d/maven.sh
source /etc/profile.d/maven.sh

Étape 4: Vérifier

mvn -version

Résultat attendu:

Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: /opt/maven/apache-maven-3.9.9
Java version: 17.0.x, vendor: Eclipse Adoptium
...
OS name: "linux", ...

Option 3 : SDKMAN! (fonctionne aussi sur Linux)

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

sdk install maven 3.9.9

Option 4 : Fedora / CentOS / RHEL

sudo dnf install maven

---

Vérification finale (tous les OS)

Après l'installation, ouvrez un nouveau terminal et exécutez ces commandes :

# Vérifier Java
java -version

# Vérifier Maven
mvn -version

# Vérifier que JAVA_HOME est défini
echo $JAVA_HOME       # macOS/Linux
echo %JAVA_HOME%      # Windows CMD
$env:JAVA_HOME        # Windows PowerShell

Résultat attendu

Vous devez voir :

• Java : version 17 ou supérieure
• Maven : version 3.9.x
• JAVA_HOME : pointe vers votre installation JDK

Si JAVA_HOME n'est pas défini

Maven a besoin de la variable JAVA_HOME. Si elle n'est pas définie :

Windows : Ajoutez JAVA_HOME dans les variables d'environnement système, pointant vers votre dossier JDK (ex: C:\Program Files\Eclipse Adoptium\jdk-17.0.x)

macOS/Linux : Ajoutez dans votre ~/.zshrc ou ~/.bashrc :

export JAVA_HOME=$(/usr/libexec/java_home -v 17)   # macOS
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 # Linux (chemin peut varier)

---

Test Maven : Premier build

Pour confirmer que Maven fonctionne, créons un projet de test:

mvn archetype:generate \
  -DgroupId=com.test \
  -DartifactId=test-maven \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DarchetypeVersion=1.4 \
  -DinteractiveMode=false

Si Maven télécharge les dépendances et affiche BUILD SUCCESS, votre installation est complète.

cd test-maven
mvn clean package

[INFO] BUILD SUCCESS
[INFO] Total time:  X.XXX s

Vous pouvez supprimer ce dossier de test:

cd ..
rm -rf test-maven       # macOS/Linux
rmdir /s /q test-maven   # Windows CMD

---

Résumé des commandes par OS

Action	Windows	macOS (Homebrew)	Linux (Manuel)
Installer	Télécharger ZIP + configurer PATH	brew install maven	wget + extraire + PATH
Configurer PATH	Variables d'environnement système	Automatique	/etc/profile.d/maven.sh
Vérifier	mvn -version	mvn -version	mvn -version
Mettre à jour	Retélécharger	brew upgrade maven	Retélécharger

---

Résolution de problèmes

mvn n'est pas reconnu

Cause	Solution
PATH non configuré	Ajouter MAVEN_HOME/bin au PATH
Terminal pas rechargé	Fermer et rouvrir le terminal
Mauvais chemin	Vérifier que le dossier bin de Maven existe bien au chemin configuré

JAVA_HOME is not defined correctly

Cause	Solution
JAVA_HOME non défini	Définir la variable d'environnement JAVA_HOME
JAVA_HOME pointe vers JRE	Pointer vers le JDK (pas le JRE)
Espace dans le chemin	Utiliser des guillemets : "C:\Program Files\Java\jdk-17"

Maven télécharge lentement

Le premier build Maven télécharge beaucoup de dépendances dans le dossier ~/.m2/repository. C'est normal et ne se produit qu'une seule fois.

---

Checklist de validation

Avant de passer au Module 2, assurez-vous que tout est en place:

• Java 17+ installé et java -version fonctionne
• Maven 3.9.x installé et mvn -version fonctionne
• JAVA_HOME est défini correctement
• Le test mvn archetype:generate a fonctionné
• Visual Studio Code installé avec les extensions Java

---

Prochaines Étapes

Votre environnement est prêt! Vous pouvez maintenant passer au Module 2:

➡️ Module 2: Premiers Pas avec Spring Boot

---

⬅️ Retour au Module 1