TP Introduction a Maven Installation ligne de commande
Transcription
TP Introduction a Maven Installation ligne de commande
TP Introduction a Maven Author : Cedric Dumoulin Date : 7 déc. 2006 Rev : 9 Dec. 2014 Le but de ce TP est de vous apprendre à vous servir de Maven. A l'origine, Maven a été développé pour être utilisé en ligne de commande. Il est aujourd'hui possible de l'utiliser dans Eclipse. Vous pouvez faire les ateliers soit en ligne de commande, soit dans Eclipse, soit dans les deux (conseillé). Il est plus facile de comprendre le fonctionement de Maven en le testant en ligne de commande. Cependant, il est parfois plus facile de l'utiliser à partir d'Eclipse. Installation ligne de commande Installer Maven http://maven.apache.org/download.html Les instructions d’installation sont en bas de la page html Changer le répertoire du dépositaire : Ouvrir $MAVEN/conf/settings.xml Repérer <localRepository>…</localRepository> Décommenter et spécifier le répertoire du dépositaire (de préférence sur votre disque local). Spécifier le proxy Maven doit accéder aux dépositaires distants. Si vous êtes derrière un firewall, il faut configurer le proxy comme dans l’exemple ci-dessous : <settings> . . <proxies> <proxy> <active>true</active> <protocol>http</protocol> <host>proxy.somewhere.com</host> <port>8080</port> <username>proxyuser</username> <password>somepassword</password> <nonProxyHosts>www.google.com|*.somewhere.com</nonProxyHosts> </proxy> </proxies> . . </settings> Tester mvn –version Installation Eclipse Maven est déjà installé dans Eclipse. Si ce n'est pas la cas, installez le plugin m2eclipse. Tutorial : Si vous ne savez pas comment aborder les ateliers suivants, vous pouvez faire le Tutorial Apache : http://maven.apache.org/guides/getting-started/index.html Atelier 1 - Créer un projet et un sous-projet Créer un projet de type standard, et appelé le 'my-app' compiler, installer et tester Créer un second projet 'my-subapp' ajouter une méthode getHello() : String à la classe java généré Modifier my-app.App.java pour appeler getHello() Ajouter les dépendances dans le fichier POM compiler et installer Atelier 2 - 'Maveniser' un projet (mailreader) Le fichier zip mailreader-with-maven-empty.zip contient les sources d'une application web Java (struts mailreader) sans les librairies, et sans script pour la compiler. Vous êtes chargés de créer un projet Eclipse permettant de compiler et packager l'application à l'aide de Maven. N'oubliez pas de tester le résultat en le déployant dans un serveur web ! Cet atelier doit se faire dans Eclipse. Indications: Vous pouvez ouvrir les sources comme un projet Eclipse Il est plus simple de créer un nouveau projet de type Maven-web, et de copier les sources de l'application dans ce nouveau projet. Créez un projet Maven afin d'avoir la bonne structure de fichiers. Il faut respecter l'organisation des sources de Maven (et non celle d'Eclipse) Eclipse propose un menu pour ajouter des dépendances au pom.xml. Le dialogue propose un contentAssist (vous tapez le début du nom recherché ...). Autre application possible Vous savez maintenant utiliser Maven pour automatiser la gestion de vos projets. Vous pourrez utiliser Maven pour automatiser la construction et le déploiement de votre projet de Master 2 ! Attention : Cela implique peut-être une restructuration des répertoires de votre projet. Votre script Maven devra permettre : La compilation de vos classes Java La construction des artefacts pour le site jar/war/ear… La construction de la documentation Le déploiement des artefacts sur le site o Si vous n’avez pas de site, installez un serveur sur une machine et utilisez celle-ci pour le déploiement. L’exécution des tests Le lancement de métriques et leurs diffusions dans le site de doc. Le synchronisation des sources à partir d’un gestionnaire de version (CVS ou SVN)