Java. Gestion de projet avec Ant. Université de Caen. Master MI3 - M2. Antoine WIDLÖCHER

Transcription

1 Java Gestion de projet avec Ant Master MI3 - M2 Antoine WIDLÖCHER Université de Caen

2 Plan de l exposé Introduction Principes Principales tasks A. WIDLÖCHER 17 janvier 2008 diapo 1 sur 6

3 Plan de l exposé Introduction Principes Principales tasks A. WIDLÖCHER 17 janvier 2008 diapo 1 sur 6

4 Objectifs Au-delà d un premier niveau de développement d applications «élémentaires» La mise en place d applications s accompagne d un certain nombre d opérations récurrentes (d un projet à l autre) et répétitives (d une session de développement à l autre) On pourra citer par exemple définition d un classpath pour la compilation et/ou l exécution compilation et détermination du chemin d accueil du code exécutable réalisation d une archive jar, war... production d une documentation associée (Javadoc, Docbook...) nettoyage de l arborescence du projet déploiement de l application (par exemple sur un serveur)

5 définition du composant principal à exécuter exécution de l application Or ces opérations s appellent souvent les unes et les autres il est par exemple logique de compiler avant d exécuter et il devient rapidement fastidieux et difficile de mémoriser chemins, enchaînements de tâches... surtout pour un travail collaboratif ou étalé dans le temps Dans certains cas (... trop nombreux) on se contente d un script (shell ou autre) qui automatise tant bien que mal ces opérations Dans les autres cas... A. WIDLÖCHER 17 janvier 2008 diapo 1 sur 6

6 Objectifs make et le Makefile un Makefile définit les opérations associées au projet qui constituent autant de targets nommées en indiquant les dépendances immédiates de chacune la commande make qui utilise le Makefile présent dans le répertoire courant permet d invoquer telle ou telle target (en gérant les dépendances) make [targetname] ant et le build.xml sont l équivalent «moderne» dans la sphère Java / XML A. WIDLÖCHER 17 janvier 2008 diapo 2 sur 6

7 Plan de l exposé Introduction Principes Principales tasks A. WIDLÖCHER 17 janvier 2008 diapo 3 sur 6

8 Principes généraux le build.xml il définit, en XML un ensemble de targets, utilisant différentes tasks en précisant leurs dépendances qui pourront être invoquées par la commande ant la task nommée par exemple (conventionnellement) clean pourra être appelée par ant clean le build.xml aura la forme générale <?xml version="1.0" encoding="iso "?> <project basedir="." default="compile" name="nomduprojet"> <!-- définition des targets --> </project>

9 le répertoire de base du projet NomDuProjet est celui contenant le build.xml appelée sans argument, la commande ant invoquera la cible compile A. WIDLÖCHER 17 janvier 2008 diapo 3 sur 6

10 Définitions des targets nous allons donc définir un ensemble de targets en précisant leurs relations de dépendance <?xml version="1.0" encoding="iso "?> <project basedir="." default="compile" name="monapplication"> <target name="compile"></target> <target name="dist" depends="compile"></target> <target name="clean"></target> <target name="run" depends="dist"></target> </project> les noms (attribut name) peuvent être arbitrairement choisis mais certains sont conventionnels (compile, clean, dist, run, deploy...)

11 la définition du contenu des targets passe par l appel à différentes tasks opérations plus ou moins élémentaires reconnues par ant distribuées en core tasks, optional tasks ensemble extensible la définition du contenu d une target sera de la forme <target name="run" depends="dist"> <java classname="main" /> </target> où java est une core task ant run lancera ainsi le main() de la classe Main, sans argument après avoir invoqué la cible dist A. WIDLÖCHER 17 janvier 2008 diapo 4 sur 6

12 Autres éléments du projet Il est possible de définir pour l ensemble du projet différents éléments pouvant être utilisés par différentes targets plutôt que de les redéfinir à chaque appel de task particulièrement utile pour nommer valeurs et classpathes Pour nommer une valeur nous pouvons utilser la task property <project basedir="." default="compile" name="monapplication"> <property name="application.version" value="0.0.1"/> </project> qui sera partout utilisable grâce à l appel ${application.version}

13 Pour nommer un classpath nous pouvons utilser le tag path <project basedir="." default="compile" name="monapplication"> <path id="monappli.classpath"> <pathelement location="classes"/> </path> </project> qui sera utilisable dans différentes tasks grâce à l appel <classpath refid="monappli.classpath"/> même si, évidemment, un classpath pourra aussi être défini localement en supplément ou remplacement de ce classpath A. WIDLÖCHER 17 janvier 2008 diapo 5 sur 6

14 Plan de l exposé Introduction Principes Principales tasks A. WIDLÖCHER 17 janvier 2008 diapo 6 sur 6

15 Principales tasks Sans pouvoir évidemment être exhaustifs... on pourra se reporter à compilation avec javac <path id="monappli.classpath"> <pathelement location="classes"/> </path> <target name="compile"> <javac srcdir="src" source="1.4" destdir="classes"> <classpath refid="monappli.classpath"/> </javac> </target> nettoyage avec delete <target name="clean"> <delete> <fileset dir="classes" includes="**/*.class"/> <fileset dir="src" includes="**/*~" defaultexcludes="no"/> </delete> <delete file="dist/application-${application.version}.jar"/> </target>

16 création de jar avec jar <target name="dist" depends="compile"> <delete file="dist/application-${application.version}.jar"/> <jar jarfile="dist/application-${application.version}.jar"> <fileset dir="src" includes="**/*.gif,**/*.png,**/*.html"/> <fileset dir="classes" includes="**/*.class"/> <manifest> <attribute name="main-class" value="fr.unicaen.le.main"/> <attribute name="class-path" value="lib/mysql.jar"/> </manifest> </jar> </target> exécution avec java <target name="run" depends="dist"> <java jar="dist/application-${application.version}.jar" fork="true" /> </target> A. WIDLÖCHER 17 janvier 2008 diapo 6 sur 6