Développer en Java/Construction avec Ant

Logo de Ant qui en anglais signifie fourmi.

Ant est une bibliothèque Java et un outil permettant de lancer des commandes dont le but principal est la construction d'une application Java. Le nom est un acronyme pour "Another Neat Tool" (un autre chouette outil). Ant est un projet Apache :

• http://ant.apache.org/ Site Apache sur Ant,
• http://ant.apache.org/manual/ Manuel d'utilisation en ligne.

Utilisation dans Eclipse

Eclipse est un IDE pour Java intégrant l'outil Ant. Il est principalement utiliser pour créer des fichiers JAR (archives Java) exécutable ou non.

Ant s'exécute en utilisant un fichier script XML contenant la liste des actions possibles. Ce fichier XML s'apparente à un makefile. Son nom porte l'extension .xml.

Créer un fichier script Ant automatiquement

L'export d'un projet depuis Eclipse pour produire sa documentation javadoc ou un JAR exécutable (Runnable JAR) se fait en utilisant le clic-droit sur le projet dans le « Package Explorer » d'Eclipse, et en choisissant Export.... La boîte de dialogue permet d'enregistrer un fichier script Ant. Ce fichier permet de réaliser la même action avec les mêmes options automatiquement sans passer par l'interface graphique ni reconfigurer l'action.

Exécuter un fichier script Ant

Pour lancer un fichier script Ant existant dans un projet Eclipse :

1. Cliquez avec le bouton droit sur le fichier XML,
2. Sélectionnez le menu « Run As »
3. Sélectionnez ensuite :
   • « Ant Build » si le script n'a pas besoin de paramètres, comme ceux générés automatiquement par Eclipse,
   • « Ant Build... » si le script a besoin de paramètres.

Le résultat de l'exécution du script est visible dans la fenêtre « Console » d'Eclipse.

Après l'exécution récente du script, il est également disponible dans le menu déroulant du bouton de lancement des outils (Ce bouton ressemble à celui permettant d'exécuter une application mais comporte en plus une caisse à outils). Le bouton lui-même permet de relancer le dernier outil.

Syntaxe

Un script Ant est un fichier XML décrivant les actions à effectuer sous la forme de balises et d'attributs.

Exemple de fichier généré par Eclipse pour créer une archive JAR exécutable pour un projet simple :

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project default="create_run_jar" name="Create Runnable Jar for Project UnProjetSimple">
	<!--this file was created by Eclipse Runnable JAR Export Wizard-->
	<!--ANT 1.7 is required                                        -->
	<target name="create_run_jar">
		<jar destfile="/workspace/UnProjetSimple/export/simple.jar">
			<manifest>
				<attribute name="Main-Class" value="org.wikibooks.fr.ClasseSimple"/>
				<attribute name="Class-Path" value="."/>
			</manifest>
			<fileset dir="/workspace/UnProjetSimple/bin"/>
		</jar>
	</target>
</project>

Exemple de fichier généré par Eclipse pour créer une archive JAR exécutable contenant les classes de deux projets (UnSuperProjet et UnSuperAutreProjet) et utilisant un autre JAR (autreprojet.jar spécifié dans l'attribut Class-Path du manifest) :

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project default="create_run_jar" name="Create Runnable Jar for Project UnSuperProjet">
	<!--this file was created by Eclipse Runnable JAR Export Wizard-->
	<!--ANT 1.7 is required                                        -->
	<target name="create_run_jar">
		<jar destfile="/workspace/UnSuperProjet/export/superprojet.jar" filesetmanifest="mergewithoutmain">
			<manifest>
				<attribute name="Main-Class" value="org.wikibooks.fr.UneClassePrincipale"/>
				<attribute name="Class-Path" value=". autreprojet.jar"/>
			</manifest>
			<fileset dir="/workspace/UnSuperProjet/bin"/>
			<fileset dir="/workspace/UnSuperAutreProjet/bin"/>
		</jar>
	</target>
</project>