• 20 heures
  • Moyenne

Ce cours est visible gratuitement en ligne.

course.header.alt.is_video

course.header.alt.is_certifying

J'ai tout compris !

Mis à jour le 29/07/2024

Configurez votre environnement de développement

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 » :

    1. Ajoutez une propriété nommée JAVA_HOME avec la valeur (à adapter) :

      C:\chemin\vers\repertoire\env\java\jdk1.8.0_131
    2. 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)

  1. Exécutez la commande suivante :

    mvn -v
  2. 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 :

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 :

      1. Ajoutez une nouvelle installation externe :

      2. 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)

Exemple de certificat de réussite
Exemple de certificat de réussite