Comment installer Apache Maven sur Ubuntu 24.04, 22.04 ou 20.04

Apache Maven est un outil d'automatisation de construction et de gestion de projet largement utilisé, principalement utilisé dans le développement Java. Il simplifie le processus de création, de packaging et de gestion des dépendances pour les projets Java en utilisant une structure de projet standardisée et un référentiel central pour les bibliothèques et les plugins. La capacité d'Apache Maven à rationaliser les flux de travail des projets en fait un outil essentiel pour les développeurs travaillant sur des applications Java à grande échelle.

Sur Ubuntu 24.04, 22.04 ou 20.04, vous pouvez installer Apache Maven via deux méthodes principales. La première méthode consiste à utiliser le référentiel par défaut d'Ubuntu, qui fournit une installation stable et simple adaptée à la plupart des utilisateurs. Alternativement, pour ceux qui ont besoin de la dernière version ou d’une version spécifique de Maven, vous pouvez télécharger et installer Maven manuellement à partir de l’archive source. Ce guide vous guidera à travers les deux méthodes d'installation, vous permettant de choisir la meilleure option pour vos besoins de développement.

Méthode 1 : installer Apache Maven via les commandes du terminal APT

Mettre à jour le système Ubuntu avant l'installation d'Apache Maven

Avant de plonger dans le processus d'installation, il est crucial de s'assurer que votre système Ubuntu est à jour. Cette étape permet d'éviter les conflits potentiels et garantit que vous disposez des derniers correctifs de sécurité et améliorations du système. Pour mettre à jour votre système, vous devrez exécuter la commande suivante dans votre terminal :

sudo apt update && sudo apt upgrade

Cette commande fait deux choses. sudo apt update met à jour les listes de packages pour les mises à niveau des packages qui nécessitent une mise à niveau, ainsi que pour les nouveaux packages qui viennent d'arriver dans les référentiels.

Installer Apache Maven via la commande APT

Une fois votre système mis à jour, vous êtes maintenant prêt à installer Apache Maven. Comme mentionné, Ubuntu inclut Apache Maven dans son référentiel par défaut, simplifiant ainsi le processus d'installation. Pour installer Apache Maven, exécutez la commande suivante :

sudo apt install maven

Cette commande indique à APT d'installer le package maven. Le préfixe sudo garantit que la commande est exécutée avec les privilèges de superutilisateur nécessaires aux installations à l'échelle du système.

Vérifier l'installation d'Apache Maven via APT

Après l'installation, vérifiez que vous avez correctement installé Apache Maven et vérifiez sa version. Cette étape garantit un processus d'installation fluide et confirme que vous disposez de la version Maven appropriée. Pour vérifier l'installation et déterminer la version, utilisez la commande suivante :

mvn -version

Cette commande demande à Maven d'afficher son numéro de version, ce qui devrait afficher des informations sur la version installée de Maven.

Méthode 2 : installer Apache Maven via la source

Étape 1 : Installer le kit de développement Java (JDK) par défaut

Tout d’abord, pour installer Apache Maven sur Ubuntu via l’archive source, assurez-vous que Java est installé sur votre système Ubuntu. Apache Maven a besoin de Java pour fonctionner. Installez le JDK par défaut sur Ubuntu avec cette commande :

sudo apt install default-jdk -y

Cette commande demande à APT d'installer le package default-jdk. L'indicateur -y confirme automatiquement l'installation, vous évitant ainsi d'avoir à l'approuver manuellement.

Télécharger les archives Apache Maven

Avec Java installé, nous pouvons maintenant télécharger l'archive Apache Maven. Nous utiliserons pour cela la commande wget, un utilitaire de téléchargement non interactif de fichiers depuis le Web.

Pour trouver la dernière version d'Apache Maven, vous pouvez visiter le Page de téléchargement d'Apache Maven. Pour les besoins de ce guide, supposons que la dernière version soit la 3.9.2. Pour télécharger cette version, utilisez la commande suivante :

wget https://dlcdn.apache.org/maven/maven-3/3.9.2/binaries/apache-maven-3.9.2-bin.tar.gz

Remarque : La commande ci-dessus est un exemple, assurez-vous d'obtenir le lien de la dernière version, car copier ce qui précède vous obtiendra une version obsolète.

Extraire les archives Apache Maven

Après avoir téléchargé l'archive Apache Maven, nous devons l'extraire. Nous extrairons l'archive dans le répertoire /opt/, qui est un répertoire standard pour stocker les logiciels facultatifs ou complémentaires. Pour extraire l'archive, utilisez la commande suivante :

sudo tar xzf apache-maven-3.9.2-bin.tar.gz -C /opt/

Cette commande utilise l'utilitaire tar pour extraire l'archive. Les indicateurs -xzf indiquent à tar d'extraire (-x) le fichier gzippé (-z), et l'indicateur -C spécifie le répertoire cible pour l'extraction.

cd /opt/

Créer un lien symbolique vers le répertoire Apache Maven

Après avoir extrait l'archive, nous créerons un lien symbolique vers le répertoire Apache Maven. Cette étape est facultative mais recommandée, vous permettant de vous référer plus facilement au répertoire. Pour créer un lien symbolique, utilisez la commande suivante :

sudo ln -s apache-maven-3.9.2 maven

Cette commande crée un lien symbolique nommé maven qui pointe vers le répertoire apache-maven-3.9.2.

Configuration de l'environnement Apache Maven

Ensuite, nous devons configurer l'environnement Apache Maven en définissant certaines variables d'environnement. Nous allons créer un nouveau fichier de script dans le répertoire /etc/profile.d/, un répertoire standard pour ajouter des scripts qui définissent des variables d'environnement. Pour créer le fichier script, utilisez la commande suivante :

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

Cette commande ouvre un nouveau fichier nommé maven.sh dans l'éditeur de texte nano. Dans ce fichier, ajoutez les lignes suivantes :

export M2_HOME=/opt/maven
export PATH=${M2_HOME}/bin:${PATH}

Ces lignes définissent deux variables d'environnement : M2_HOME, qui pointe vers le répertoire Apache Maven, et PATH, qui inclut le chemin d'accès aux binaires Apache Maven. Pour enregistrer le fichier et quitter l'éditeur, appuyez sur CTRL+O puis CTRL+X.

Alternativement, nous pouvons utiliser la commande echo et la commande sudo tee pour y parvenir. La commande echo générera les lignes nécessaires et sudo tee écrira ces lignes dans le fichier. Voici comment procéder :

echo -e "export M2_HOME=/opt/maven\nexport PATH=\${M2_HOME}/bin:\${PATH}" | sudo tee /etc/profile.d/maven.sh

Cette commande effectue les opérations suivantes :

La commande echo -e permet d'interpréter les échappements de barre oblique inverse et génère les lignes à ajouter au fichier.
Le | (pipe) prend la sortie de la commande à sa gauche et l'utilise comme entrée pour la commande à sa droite.
La commande sudo tee /etc/profile.d/maven.sh écrit l'entrée qu'elle reçoit de la commande echo dans le fichier /etc/profile.d/maven.sh. La commande tee est utilisée conjointement avec sudo pour écrire dans des fichiers appartenant à l'utilisateur root.

Cette commande crée efficacement le fichier maven.sh avec les variables d'environnement nécessaires sans avoir besoin d'ouvrir et de modifier le fichier manuellement.

Activer l'environnement Apache Maven

Une fois les variables d'environnement définies, nous devons les activer. Nous ferons cela en recherchant le fichier de script que nous venons de créer. Rechercher un fichier de script signifie exécuter le fichier dans le shell actuel, ce qui permet aux variables d'environnement d'être disponibles dans votre session en cours. Pour sourcer le fichier de script, utilisez la commande suivante :

source /etc/profile.d/maven.sh

Cette commande lit et exécute le fichier maven.sh dans le shell actuel. La « commande source » est une commande intégrée au shell qui lit et exécute les commandes à partir du fichier spécifié comme argument dans l'environnement shell actuel.

Vérification de l'installation d'Apache Maven

Après avoir configuré l'environnement Apache Maven, vérifier la configuration correcte est une bonne pratique. Comme auparavant, vérifiez la version installée d'Apache Maven pour confirmer l'installation. Utilisez la commande suivante :

mvn -version

La commande affichera des informations sur la version installée d'Apache Maven. Si vous avez tout configuré correctement, le numéro de version doit correspondre à la version que vous avez téléchargée.

Créer et tester un projet Maven (facultatif)

Créer un nouveau projet Maven

La première étape de la création d'un projet Maven consiste à générer une nouvelle structure. Maven fournit une commande à cet effet, qui crée une nouvelle structure de répertoires avec un fichier pom.xml par défaut (fichier Project Object Model), l'unité de travail fondamentale dans Maven.

Pour créer un nouveau projet Maven, accédez au répertoire dans lequel vous souhaitez créer le projet et exécutez la commande suivante :

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

Cette commande indique à Maven de générer un nouveau projet à partir d'un archétype. Un archétype est un modèle de projet, qui dans ce cas est maven-archetype-quickstart, un projet Java de base. Les paramètres groupId etartefactId sont utilisés pour identifier de manière unique votre projet dans tous les projets.

Accédez au répertoire du projet Maven

Après avoir créé le projet, accédez au répertoire du projet à l'aide de la commande suivante :

cd my-app

Cette commande remplace le répertoire actuel par le répertoire my-app, qui est le répertoire racine du projet que vous venez de créer.

Construire le projet Maven

Une fois le projet créé et le répertoire du projet défini, vous pouvez maintenant créer le projet. La construction du projet compile le code source et le conditionne dans un format distribuable, tel qu'un fichier JAR. Pour générer le projet, utilisez la commande suivante :

mvn package

Cette commande indique à Maven d'exécuter la phase de package du cycle de vie de build. La phase de package compile le code source, exécute les tests et conditionne le code compilé dans son format distribuable.

Exécutez le projet Maven

Enfin, après avoir construit le projet, vous pouvez l'exécuter pour vérifier que tout fonctionne comme prévu. Pour exécuter le projet, utilisez la commande suivante :

java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App

Cette commande exécute l'application Java contenue dans le fichier JAR produit par la commande mvn package. L'indicateur -cp spécifie le chemin de classe et l'argument de la commande java est la classe principale de l'application.

Avec la configuration correcte, cette commande affichera « Hello World ! » Cela indique que votre projet Maven fonctionne comme prévu.

Pensées finales

En installant Apache Maven sur votre système Ubuntu, vous pouvez rationaliser votre flux de travail de développement Java et gérer efficacement vos projets. Que vous optiez pour la facilité et la stabilité du référentiel par défaut d'Ubuntu ou la flexibilité de télécharger et d'installer manuellement la version la plus récente ou spécifique de Maven, les deux méthodes constituent un moyen fiable de faire fonctionner Maven. Des mises à jour régulières et une gestion des versions garantiront que votre configuration Maven reste à jour, vous permettant de profiter pleinement de ses puissantes fonctionnalités de gestion de projet et d'automatisation de la construction sur Ubuntu.

À propos
Articles récents

Suis-moi

Joshua James

Joshua James est un administrateur système Linux expérimenté et propriétaire de linuxcapable.com. Il a écrit de nombreux tutoriels et guides pour aider les utilisateurs à comprendre les systèmes Linux. L'expertise de Joshua couvre une gamme de distributions Linux, notamment Ubuntu, Fedora, Debian, RHEL, openSUSE et Arch Linux. Sa passion est d'aider les utilisateurs qui découvrent Linux ou les systèmes de type Unix à tirer parti de ses connaissances.