Les fichiers de construction de Ant sont écrits en XML. Chacun d'eux correspond à ce que nous appelerons un projet i.e, project. Ce dernier peut posséder jusqu'à quatre attributs et constitue la partie essentielle du fichier :

Supposons que nous souhaitions créer un projet HelloWorld à la racine du système, en l'occurence C:\\HelloWorld, dans lequel nous placerions le fichier de construction. La déclaration du projet se ferait alors ainsi et la tâche main serait celle appelée par défaut :

<?xml version="1.0" encoding="UTF-8"?>
   <project name="HelloWord" default="main" basedir=".">
   <description>
        Notre HelloWorld build file.
   </description>
   </project>

Chaque projet défini une ou plusieurs cibles i.e., target. Une cible est un ensemble de tâches que nous souhaitons exécuter. Quand nous lançons Ant, nous pouvons sélectionner la cible principale. Si nous n'en spécifions aucune, celle par défaut sera lancée.

Une cible peut dépendre d'autres cibles. Nous pourrions par exemple avoir une cible de compilation et une autre pour créer un exécutable. Or, nous ne pouvons créer l'exécutable qu'une fois les sources compilées, la cible d'exécution dépend donc de la cible de compilation.

Une cible peut contenir les attributs suivants :

Définissons alors quatre cibles : l'initialisation init dont dépend la tâche de compilation compil dont dépend elle-même la tâche principale main et enfin, une tâche de nettoyage clean

<?xml version="1.0" encoding="UTF-8"?>
   <project name="HelloWord" default="main" basedir=".">
   <description>
        Notre HelloWorld build file.
   </description>
   <target name="init" description="construit l'arborescence cible" >
   </target>
   <target name="compil" depends="init" description="compile les sources" >
   </target>
   <target name="main" depends="compil" description="génère l'archive" >
   </target>
   <target name="clean" description="nettoie tous les répertoires générés" >
   </target>
   </project>

Un projet peut contenir un ensemble de propriétés. Une propriété i.e, property a un nom et une valeur. Par exemple, s' il y a une propriété « builddir » avec la valeur « build », alors elle peut être utilisée comme valeur d'argument ${builddir}/classes (équivaut à build/classes). Une propriété est « case-sensitive ».

Il est ainsi possible de définir plusieurs répertoires de travail :

<?xml version="1.0" encoding="UTF-8"?>
   <project name="HelloWord" default="main" basedir=".">
   <description>
        Notre HelloWorld build file.
   </description>

   <property environment="env"/>
   <property name="src" value="${basedir}/src"/>
   <property name="build" value="${basedir}/build"/>

   <target name="init" description="construit l'arborescence cible" >
   </target>
   <target name="compil" depends="init" description="compile les sources" >
   </target>
   <target name="main" depends="compil" description="génère l'archive" >
   </target>
   <target name="clean" description="nettoie tous les répertoires générés" >
   </target>
   </project>

Ant possède lui aussi quelques propriétés qui lui sont propres i.e, built-in property : vous pouvez constater l'emploi de basedir dans le fichier de construction ci-dessus.

Par héritage, il permet l'accés à toutes les propriétés du système comme si elles avaient été définies en tant que simples propriétés. Par exemple, ${os.name} renvoie le nom du système opérant. La classe System Java maintient un ensemble de propriétés, des paires clé/valeur qui définissent des attributs du système de travail. Quand le Runtime démarre, les propriétés de système sont initialisées pour contenir des informations sur l'environnement système comprenant entre autres, l'utilisateur, la version du Runtime Java et même le type de séparateur fichier. (À lire : Setting Java Properties with Ant).

Une tâche i.e, task est une partie de code pouvant être exécutée. Elle peut avoir de multiples arguments et possède la structure suivante :

1. <taskname attribute1="value1" attribute2="value2" ... /> où taskname est le nom de la tâche, attributeN est le nom de l'argument et valueN est la valeur de cet argument ;
2. <taskname id="taskID" ... /> où taskname est le nom de la tâche et taskID est un identifiant pour cette tâche.

Bien que nous puissions implémenter nos propres tâches, un certain nombre d'entre elles sont fournies par défaut. Parmi lesquelles :

1. Des tâches d'archivage : À noter que la tâche JLink est dépréciée.

   Tâche	Description
   gunzip/bunzip2	Défait une archive GZip/BZip2
   gzip/bzip2	Génère une archive GZip/BZip2
   cab	Génère une archive CAB Microsoft
   ear	Génère une archive EAR
   jar	Génère une archive JAR
   war	Génère une archive WAR
   manifest	Crée un fichier Manifest
   rpm	Génère une archive RPM
   signjar	Signe une archive jar par le biais de javasign
   tar	Génère une archive TAR
   unjar	Défait une archive JAR
   untar	Défait une archive TAR
   unwar	Défait une archive WAR
   unzip	Défait une archive ZIP
   zip	Génère une archive ZIP

   build.xml

   Sélectionnez

   <?xml version="1.0" encoding="UTF-8"?>
      <project name="HelloWord" default="main" basedir=".">
      <description>
           Notre HelloWorld build file.
      </description>
   
      <property environment="env"/>
      <property name="src" value="${basedir}/src"/>
      <property name="build" value="${basedir}/build"/>
   
      <target name="init" description="construit l'arborescence cible" >
      </target>
   
      <target name="compil" depends="init" description="compile les sources" >
      </target>
   
      <target name="main" depends="compil" description="génère l'archive" >
        <jar jarfile="${build}/HelloWorld.jar" basedir="${build}" >
          <manifest>
            <attribute name="MAIN-CLASS" value="HelloWorld" />
          </manifest>
        </jar>
      </target>
   
      <target name="clean" description="nettoie tous les répertoires générés" >
      </target>
      </project>
   

2. Des tâches d'audit :

   Tâche	Description
   jdepend	Invoque JDepend (Infos produit)
   jprobe	Invoque JProbe (Infos produit)
   mmetrics	Invoque Metamata Metrics/WebGain Quality Analyzer sur des sources Java (Détails)
   maudit	Invoque Metamata Metrics/WebGain QA à la fois sur les sources et le Byte-code résultant (Détails)

3. Des tâches de compilation :

   Tâche	Description
   depend	Détermine les classes compilées dépréciées avec leurs sources respectives
   javac	Compile des sources java
   jspC	Lance le compilateur JSP
   netrexxc	Compile des sources netrexx
   rmic	Lance le compilateur rmic
   wljspc	Lance le compilateur JSP associé à la solution Weblogic

   build.xml

   Sélectionnez

   <?xml version="1.0" encoding="UTF-8"?>
      <project name="HelloWord" default="main" basedir=".">
      <description>
           Notre HelloWorld build file.
      </description>
   
      <property environment="env"/>
      <property name="src" value="${basedir}/src"/>
      <property name="build" value="${basedir}/build"/>
   
      <target name="init" description="construit l'arborescence cible" >
      </target>
   
      <target name="compil" depends="init" description="compile les sources" >
        <javac  srcdir="${src}" destdir="${build}" debug="on" deprecation="on" optimize="off" >
          <include name="HelloWorld.java" />
        </javac>
      </target>
   
      <target name="main" depends="compil" description="génère l'archive" >
        <jar jarfile="${build}/HelloWorld.jar" basedir="${build}" includes="META-INF/**">
          <manifest>
            <attribute name="MAIN-CLASS" value="HelloWorld" />
          </manifest>
        </jar>
      </target>
   
      <target name="clean" description="nettoie tous les répertoires générés" >
      </target>
      </project>
   

4. Des tâches de déploiement :

   Tâche	Description
   serverdeploy	Lance le service de déploiement à chaud spécifique au serveur d'application utilisé (Weblogic ou JOnAS)

5. Des tâches de documentation :

   Tâche	Description
   javadoc/javadoc2	Génère une documentation par le biais de javadoc
   stylebook	Génère une documentation par le biais de Apache Stylebook

6. Des tâches liées aux EJB :

   Tâche	Description
   blgenclient	Borland Application Server 4.5 et 5.x
   ddcreator	Weblogic 4.5.1
   ejbc	Weblogic 4.5.1
   iplanet-ejbc	iPlanet Application Server 6.0
   ejbjar	Borland Application Server 4.5 et 5.x, iPlanet Application Server 6.0, JBoss, JOnAS 2.4.x et 2.5, Weblogic 5.1 à 7.0, IBM WebSphere 4.0
   wlrun	Weblogic 5.1 à 7.0
   wlstop	Weblogic 5.1 à 7.0

7. Des tâches d'exécution :

   Tâche	Description
   ant	Lance Ant sur un autre fichier
   antcall	Appelle une autre cible au sein d'une première
   apply	Exécute une commande système
   dependset	Gère les dépendances entre fichiers
   exec	Exécute une commande système
   java	Exècute des classes java au sein d'une même VM ou de processus fils
   parallel	Exécute plusieurs tâches en parallèle
   sequential	Exècute des tâches en séquentiel
   sleep	Endort le processus pendant une certaine durée
   subant	Appelle une cible dans un ensemble de sous projets
   waitfor	Bloque l'exécution jusqu'à ce qu'un certain nombre de conditions soient respectées

8. Des tâches de manipulation de fichiers :

   Tâche	Description
   attrib	Change les attributs et permissions de fichiers/répertoires sous Windows
   checksum	Créer un checksum pour un fichier
   chgrp	Change le groupe propriétaire sous Unix
   chmod	Change les permissions sur un fichier
   chown	Change le propriétaire d'un fichier sous Unix
   concat	Assemble un ensemble de fichiers vers une cible
   copy	Copie un ensemble de fichiers dans un autre ou vers un répertoire
   delete	Efface un fichier, un répertoire et toute sa sous-arborescence
   filter	Remplace les tokens posés par une nouvelle valeur
   fixclrf	Ajuste un fichier texte aux règles de convention d'une locale
   get	Récupère un fichier posé sur un point distant par son url
   mkdir	Crée un répertoire
   move	Déplace un fichier vers un autre ou un répertoire
   patch	Applique un patch aux sources originales
   replace	Remplace l'occurence d'une chaîne de caractères par une autre
   sync	Synchronise un répertoire cible avec un ensemble de fichiers
   tempfile	Pose un propriété sur un fichier temporaire
   touch	Change l'heure de modification d'un fichier

   build.xml

   Sélectionnez

   <?xml version="1.0" encoding="UTF-8"?>
      <project name="HelloWord" default="main" basedir=".">
      <description>
           Notre HelloWorld build file.
      </description>
   
      <property environment="env"/>
      <property name="src" value="${basedir}/src"/>
      <property name="build" value="${basedir}/build"/>
   
      <target name="init" description="construit l'arborescence cible" >
        <mkdir  dir="${build}"/>
      </target>
   
      <target name="compil" depends="init" description="compile les sources" >
        <javac  srcdir="${src}" destdir="${build}" debug="on" deprecation="on" optimize="off" >
          <include name="HelloWorld.java" />
        </javac>
      </target>
   
      <target name="main" depends="compil" description="génère l'archive" >
        <jar jarfile="${build}/HelloWorld.jar" basedir="${build}" includes="META-INF/**">
          <manifest>
            <attribute name="MAIN-CLASS" value="HelloWorld" />
          </manifest>
        </jar>
      </target>
   
      <target name="clean" description="nettoie tous les répertoires générés" >
        <delete includeEmptyDirs="true" >
           <fileset dir="${build}" />
        </delete>
   
      </target>
      </project>
   

9. Des tâches d'extension Java :

   Tâche	Description
   jarlib-available	Vérifie et établit la présence d'une extension dans un FileSet ou un ExtensionSet
   jarlib-display	Affiche les informations « Optional Package » et « Package Specification » contenues dans une archive JAR
   jarlib-manifest	Génère un fichier Manifest déclarant toutes les dépendances d'une archive JAR
   jarlib-resolve	Place le chemin d'une archive JAR dans une propriété spécifiée aprés validation

10. Des tâches de logging :

    Tâche	Description
    record	Enregistre-les évenements survenus lors d'un build

11. Des tâches d'emailing : À noter que la tâche mimemail est dépréciée :

    Tâche	Description
    mail	Envoie un email par SMTP

12. Des tâches DotNet :

    Tâche	Description
    csc	Compile du code C#
    vbc	Compile du code VB.NET
    jsharpc	Compile du code J#
    ildasm	Désassemble du code et des librairies .NET
    ilasm	Assemble des fichiers .il
    wsdltodotnet	Génère du code C# ou VB.NET à partir de fichier WSDL
    importtypelib	Importe une librairie COM vers .NET

13. Des tâches de préprocessing :

    Tâche	Description
    antlr	Invoque ANTLR sur une grammaire
    antstructure	Génère une DTD correspondante au fichier de construction
    icontract	Utilise IContract sur ces classes Java
    import	Importe un autre fichier de construction au sein d'un projet
    javacc	Invoque JavaCC sur une grammaire
    javah	Génère des entêtes JNI à partir d'une classe Java
    jjdoc	Invoque JJDoc pour JavaCC
    jjtree	Invoque JJTree pour JavaCC
    macrodef	Définit une nouvelle tâche comme template
    mparse	Invoque MParse sur une grammaire
    nativetoascii	Convertit des fichier natifs en ASCII
    presetdef	Génère une définition basée sur la définition courante
    translate	Identifie des tokens dans un fichier pour les remplacer par celles définies dans un fichier tiers
    xslt/style	Gère un ensemble de documents via XSLT

14. Des tâches propriété :

    Tâche	Description
    available	Instancie une propriété si une ressource est disponible
    basename	Détermine le nom d'un fichier spécifié
    buildnumber	Comptabilise le nombre de builds
    condition	Pose une propriété si la condition est applicable
    dirname	Retourne le répertoire où est contenu un fichier spécifié
    echoproperties	Liste les propriétés courantes
    loadfile	Charge un fichier texte au sein d'une propriété
    loadproperties	Charge un fichier en tant que propriétés d'un projet Ant
    pathconvert	Convertie un path vers une OS spécifique
    property	Spécifie les propriétés d'un projet
    propertyfile	Crée ou modifie un fichier de propriétés
    uptodate	Change une propriété si un fichier cible est plus récent qu'un ensemble de sources
    whichresource	Trouve une classe ou une ressource dans le Classpath
    xmlproperty	Charge des propriétés à partir d'un fichier XML

15. Des tâches réseau :

    Tâche	Description
    ftp	Implémente un client FTP capable d'envoyer, recevoir, lister ou effacer des fichiers ainsi que de créer des répertoires
    rexec	Automatise une session Rexec
    scp	Copie des fichiers au travers du protocole SSH
    setproxy	Instancie des propriétés Java's web proxy
    sshexec	Exécute une commande distante au travers de SSH
    telnet	Automatise une session Telnet

16. Des tâches SCM :

    Tâche	Description
    cvs	Permet la gestion des packages à partir de CVS
    cvschangelog	Génère un fichier XML des changes logs d'un dépôt CVS
    cvsversion	Récupère les versions d'un serveur et d'un client CVS
    cvspass	Ajoute des entrées dans le fichier .cvspass
    cvstagfile	Génère un fichier XML sur les différences entre deux TAGs dans le dépôt CVS
    clearcase	Permet d'exécuter les commandes checkin, checkout, uncheckout, update, lock, unlock, mklbtype, rmtype, mklabel, mkattr, mkdir, mkelem, et mkbl (Détails)
    continuus/synergy	Permet d'exécuter les commandes ccmcheckin, ccmcheckout, ccmcheckintask, ccmreconfigure, et ccmcreateTask (Détails)
    microsoft Visual Sourcesafe	Permet d'exécuter les commandes vssget, vsslabel, vsshistory, vsscheckin, vsscheckout, vssadd, vsscp, et vsscreate (Détails)
    perforce	Permet d'exécuter les commandes p4sync, p4change, p4edit, p4submit, p4have, p4label, p4counter, p4reopen, p4revert, et p4add (Détails)
    pvcs	Permet à un utilisateur d'extraire les dernières sources d'un répertoire PVCS
    sourceoffsite	Permet d'exécuter les commandes sosget, soslabel, soscheckin, et soscheckout (Détails)
    starteam	Permet d'exécuter les commandes stcheckout, stcheckin, stlabel, et stlist (Détails)

17. Des tâches test :

    Tâche	Description
    junit	Lance des tests à partir du framework JUnit (Infos produit)
    junitreport	Fusionne différents fichiers XML établis par JUnit pour créer un rapport
    test	Exécute un test unitaire au sein du framezork org.apache.testlet

18. Des tâches diverses :

Bien que ce ne soit pas trés lisible, nous pouvons spécifier les Paths et Classpaths en utilisant « : » ou « ; » comme séparateurs.

<pathelement path="/path/to/file2.jar:/path/to/class2;/path/to/class3" />

Ant convertira directement ces derniers vers le système approprié.

<classpath>
<pathelement  path="${classpath}"/>
<pathelement  location="lib/helper.jar"/>
</classpath>

L'attribut location spécifie un simple fichier ou un répertoire relatif à celui de base d'un projet. De plus :

<classpath>
<pathelement  path="${classpath}"/>
</classpath>

Peut-être abrégé ainsi :

   <classpath path="${classpath}">

Si nous souhaitons utiliser plusieurs fois le même chemin comme attribut, nous pouvons référencer le chemin comme suit. Par emploi de fileset, il devient ainsi possible d'inclure ou d'exclure un ensemble de fichiers des Path/Classpath.

<path id="base.path"/>
<pathelement  path="${classpath}"/>
<fileset  dir="lib">
<include  name="**/*.jar"/>
</fileset>
<pathelement  location="classes"/>
</path>

<path id="tests.path">
<path refid="base.path"/>
<pathelement  location="testclasses"/>
</path>

Le raccourci précédemment mentionné pour <classpath> est aussi valide pour <path>. Par exemple :

<path id="base.path">
<pathelement  path="${classpath}"/>
</path>

Peut-être écrit :

   <path id="base.path" path="${classpath}">