Installation

Pré-requis

• jdk 1.4.0 ou supérieur
• utilise environ 50-100Mo (ou plus) d'espace disque pour le référentiel local

Installation

1. télécharger l'archive sur le site officiel (au format choisi: zip, gzip, bzip2 qui a le plus fort taux de compression).  
   • Il est possible de  vérifier l'intégrité du fichier avec la signature MD5 fournie sur     le même site.  
   • on peut téléchager deux autres distributions: une distribution pour l'exécution de maven pilotée par ant, une autre pour embarquer maven dans un autre système (IDE, outil spécifique de construction de projets...)
2. décompresser l'archive dans un endroit adéquat du système. Le répertoire d'installation n'est jamais accéder en écriture par  maven, il peut être éventuellement placé sur un disque partagé en réseau. Par exemple:  
   • sous Unix: /usr/local/maven-2.x.y et faire un lien /usr/local/maven2 --> /usr/local/maven-2.x.y
   • sous Windows:  C:\Program Files\Apache Software Foundation\maven-2
   • sous Mac OS X: /Library/opt/apache/maven/current --> /Library/opt/apache/maven/maven-2.0
3. ajuster les variables d'environnement nécessaires:
   • le PATH pour pointer vers l'exécutable mvn
   • la variable JAVA_HOME pour lui permettre de trouver l'installation locale de Java
   • éventuellement la variable MAVEN_OPTS[1] qui permet de définir des propriétés systémes Java (utile pour l'accés à des référentiels et des serveurs par HTTPS)
4. exécuter mvn -v pour vérifier que tout est OK.

Détail des éléments installés

• maven/bin: contient les scripts shell UNIX et Windows mvn et mvn.bat
• maven/conf: fichier de configuration settings.xml global pour tous les utilisateurs. Cette configuration peut être modifiée par un fichier settings.xml dans le répertoire $HOME/.m2 (personnalisation de la configuration par utilisateur: identifiants, mots de passe...)
• maven/core: application  
• maven/lib: enesemble minimal de bibliothèques
• répertoire utilisateur  ($HOME/.m2 sous UNIX, %HOMEPATH%/m2 sous Windows): créé lors de la premiẽre exécution de maven, contient la configuration personnelle de l'utilisateur et par défaut le référentiel local

Exécution

Détail des options de la ligne de commande:

nono@osquare:~/enseign/maven$ mvn --help


usage: mvn [options] [<goal(s)>] [<phase(s)>]


Options:
 -C,--strict-checksums         Fail the build if checksums don't match
 -c,--lax-checksums            Warn if checksums don't match
 -P,--activate-profiles        Comma-delimited list of profiles to
                               activate
 -ff,--fail-fast               Stop at first failure in reactorized builds
 -fae,--fail-at-end            Only fail the build afterwards; allow all
                               non-impacted builds to continue
 -B,--batch-mode               Run in non-interactive (batch) mode
 -fn,--fail-never              NEVER fail the build, regardless of project
                               result
 -up,--update-plugins          Synonym for cpu
 -N,--non-recursive            Do not recurse into sub-projects
 -npr,--no-plugin-registry     Don't use ~/.m2/plugin-registry.xml for
                               plugin versions
 -U,--update-snapshots         Update all snapshots regardless of
                               repository policies
 -cpu,--check-plugin-updates   Force upToDate check for any relevant
                               registered plugins
 -npu,--no-plugin-updates      Suppress upToDate check for any relevant
                               registered plugins
 -D,--define                   Define a system property
 -X,--debug                    Produce execution debug output
 -e,--errors                   Produce execution error messages
 -f,--file                     Force the use of an alternate POM file.
 -h,--help                     Display help information
 -o,--offline                  Work offline
 -r,--reactor                  Execute goals for project found in the
                               reactor
 -s,--settings                 Alternate path for the user settings file
 -v,--version                  Display version information

Principales options:

• -o: permet d'exécuter maven sans accés aux référentiels distants  
• -P: activation d'un ou plusieurs profils
• -cpu et -U: mise à jour des plugins et des versions SNAPSHOT des artefacts nécessaires au projet

Le reste de la ligne de commande est constitué de buts (goals) et de phases à exécuter (eg. install ou site:deploy).

index

Footnotes:  [1]  Sous Unix, cette variable peut-être définie dans un fichier $HOME/.mavenrc qui est lu à chauque exécution de maven.