Installez les pré-requis
Avant de commencer, je vous conseille de créer un répertoire dédié pour votre environnement de développement, surtout si vous suivez l'un des parcours Java sur OpenClassrooms. En effet, au fur et à mesure que vous allez avancer dans votre formation, vous allez utiliser de plus en plus d'outils et de frameworks. Ce répertoire va contenir tous ceux-ci (les différentes versions du JDK, Apache Maven, serveur Apache Tomcat...).
Voici un exemple de l'arborescence que vous pouvez envisager :
🗁 env
├── 🗁 java
│ ├── 🗁 jdk1.7.0_80
│ ├── 🗁 jdk1.8.0_131
│ ├── 🗁 jre1.7.0_80
│ └── 🗁 jre1.8.0_131
├── 🗁 maven
│ ├── 🗁 apache-maven-3.5.0
│ └── 🗁 repository
└── 🗁 tomcat
├── 🗁 apache-tomcat-7.0.78
└── 🗁 apache-tomcat-8.5.15
Maven est un outil écrit en Java et faisant de la compilation Java. Il vous faut donc avoir un JDK Java SE sur votre machine (à l'heure ou j'écris ces lignes, Maven requiert le JDK 1.7 minimum).
Mais comme vous êtes déjà un développeur Java, ceci doit très certainement être déjà le cas ! ;) Sinon, téléchargez le JDK de Java SE depuis le site d'Oracle et installez-le : http://www.oracle.com/technetwork/java/javase/downloads/index.html
Installez Apache Maven
Téléchargement et installation
Téléchargez Apache Maven depuis le site officiel (les checksums sont aussi fournis sur la page de téléchargement) : https://maven.apache.org/download.cgi
Prenez la version :
Binary tar.gz archive si vous êtes sous Linux ou Mac OS
Binary zip archive si vous êtes sous Windows
Décompressez l'archive dans votre répertoire d'environnement de développement. Par exemple, si la version de Maven est 3.5.0 : /chemin/vers/repertoire/env/maven/apache-maven-3.5.0
.
Définir les variables d'environnement
Ensuite, il faut définir le chemin vers le JDK grâce à la variable d'environnement JAVA_HOME
et ajouter les binaires du JDK et de Maven au PATH
:
sous Linux : ajoutez ces lignes, en les adaptant, à la fin de votre fichier
~/.bashrc
(ou~/.zshrc
si vous utilisez Zsh) :# Java export JAVA_HOME="/chemin/vers/repertoire/env/java/jdk1.8.0_131" MAVEN_HOME="/chemin/vers/repertoire/env/maven/apache-maven-3.5.0" PATH="$PATH:$JAVA_HOME/bin:$MAVEN_HOME/bin"
Si votre fichier contient déjà une ligne du type
PATH=...
, conservez-la et ajoutez aussi la ligne ci-dessus dans le fichier.sous Mac OS : Même principe que pour Linux.
sous Windows : Ouvrez les propriétés système (avec la commande Win + Pause), dans l'onglet « Avancé », cliquez sur le bouton « Variables d'environnement » :
Ajoutez une propriété nommée
JAVA_HOME
avec la valeur (à adapter) :C:\chemin\vers\repertoire\env\java\jdk1.8.0_131
Modifiez la propriété nommée
Path
en ajoutant ceci (à adapter) à la fin de la valeur déjà renseignée :;C:\chemin\vers\repertoire\env\java\jdk1.8.0_131\bin;C:\chemin\vers\repertoire\env\maven\apache-maven-3.5.0\bin
Remarquez l'utilisation du caractère
;
comme séparateur de chemin dans le Path.
Tester l'installation
Testez maintenant l'installation de Maven :
sous Linux / Mac OS : ouvrez un nouveau terminal
sous Windows : ouvrez une nouvelle console (Win + R, puis taper
cmd
, puis Entrée)
Exécutez la commande suivante :
mvn -v
Vous devriez obtenir un résultat ressemblant à ceci :
Apache Maven 3.5.0 (ff8f5e7444045639af65f6095c62210b5713f426; 2017-04-03T21:39:06+02:00) Maven home: /chemin/vers/repertoire/env/maven/apache-maven-3.5.0 Java version: 1.8.0_131, vendor: Oracle Corporation Java home: /chemin/vers/repertoire/env/java/jdk1.8.0_131/jre Default locale: fr_FR, platform encoding: UTF-8 OS name: "linux", version: "4.9.0-3-amd64", arch: "amd64", family: "unix"
Configurez Apache Maven
La configuration de Maven se fait dans le fichier .m2/settings.xml
, dans le répertoire home de l'utilisateur (~/.m2/settings.xml
sous Linux). Ce fichier n'existe pas par défaut, copiez celui contenu dans le répertoire conf
de l'installation de Maven.
Maven télécharge les dépendances dans un repository local pour les gérer. Par défaut, il est situé dans le répertoire .m2/repository
dans le home de l'utilisateur (~/.m2/repository
sous Linux). Ce répertoire peut vite prendre beaucoup de place et je vous conseille de le sortir de votre home pour le mettre dans le répertoire d'environnement de développement. Pour cela, il faut modifier le fichier settings.xml
comme ceci :
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
...
<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ${user.home}/.m2/repository -->
<localRepository>/chemin/vers/repertoire/env/maven/repository</localRepository>
...
</settings>
Vous trouverez plus de détails sur la configuration de Maven dans la documentation officielle :
Configuration : https://maven.apache.org/configure.html
Fichier
settings.xml
: https://maven.apache.org/settings.html
Utilisez Apache Maven avec votre IDE
Eclipse
Installation
Si vous avez téléchargé le package Eclipse IDE for Java EE Developpers ou Eclipse IDE for Java Developpers, le plugin de support de Maven est déjà embarqué.
Sinon, vous pouvez installer le plugin M2Eclipse.
Installez également, si ce n'est pas déjà le cas, le plugin m2e-wtp afin d'intéger la gestion de Maven à la Web Tools Platform d'Eclipse.
Configuration
Ouvrez les préférences (Window > Preferences) :
Maven
Installations :
Ajoutez une nouvelle installation externe :
Cochez la nouvelle installation que vous venez de créer pour qu'elle devienne celle par défaut.
User Settings :
User Settings :
/chemin/vers/home/utilisateur/.m2/settings.xml
IntelliJ
Le support de Maven est embarqué par défaut dans JetBrains IntelliJ.
Configuration
Ouvrez les préférences par défaut (File > Other Settings > Default Settings...) :
Build, Execution Deployment > Build Tools > Maven :
Maven home directory :
/chemin/vers/repertoire/env/maven/apache-maven-3.5.0
User settings file :
/chemin/vers/home/utilisateur/.m2/settings.xml
(si le chemin par défaut est incorrect, cochez la case Override et saisissez le bon chemin)