10. Ant et Eclipse

<?xml version="1.0"?>
<project name="TestAnt1" default="bonjour">
  <target name="bonjour">
    <echo message="Premier test avec Ant!"/>
  </target>
</project>

Les erreurs dans le fichier de configuration sont signalées dans l'éditeur avec possibilité d'obtenir une bulle d'aide précisant le problème en laissant le curseur de la souris sur la petite icônes rouge avec une croix blanche.

A la sauvegarde du fichier de configuration, les erreurs persistantes sont signalées dans la vue « Erreurs »

L'éditeur de fichier de configuration de Ant propose une complétion de code avec une bulle d'aide qui permet de fournir des informations sur l'entité sélectionnée.

L'éditeur propose des modèles de code utilisable via la combinaison de touches Ctrl+espace.

Par exemple, à la création d'un fichier build.xml vide, il est possible de demander l'insertion d'un modèle contenant deux cibles. Une bulle d'aide fournit un aperçu du code qui sera inséré.

Il existe aussi des modèles pour de nombreuses tâches Ant.

L'éditeur de fichier de configuration d'Ant peut formater le code source XML du fichier de configuration en sélectionnant l'option « Formater » du menu contextuel ou en utilisant la combinaison de touches Ctrl+Maj+F.

Buildfile: I:\eclipse\workspace\test_junit\build.xml

bonjour:
        [echo] Premier test avec Ant!
BUILD SUCCESSFUL
Total time: 401 milliseconds

<?xml version="1.0" encoding="ISO-8859-1" ?>

Buildfile: I:\eclipse\workspace\test_junit\build.xml
init:
        [echo] Generation numero : 7 du July 2 2003
compil:
doc:
     [javadoc] Generating Javadoc
     [javadoc] Javadoc execution
     [javadoc] BUILD FAILED: file:I:/eclipse/workspace/test_junit/build.xml:37: 
     Javadoc failed: java.io.IOException: CreateProcess: javadoc.exe -d "I:\eclipse 
    \workspace\test_junit\build\doc" -use -package -classpath "I:\eclipse\s
     tartup.jar;I:\eclipse\workspace\test_junit\junit.jar" -version
     -author "I:\eclipse\workspace\test_junit\src\MaClasse.java" "I:\eclipse
    \workspace\test_junit\src\MaClasse2.java" error=2
Total time: 681 milliseconds

Buildfile: I:\eclipse\workspace\test_junit\build.xml
init:
        [echo] Generation numero : 13 du July 2 2003
compil:
test:
       [junit] BUILD FAILED: file:I:/eclipse/workspace/test_junit/build.xml:62:
 Could not create task or type of type: junit.
Ant could not find the task or a class this task relies upon.

<?xml version="1.0" encoding="ISO-8859-1" ?>
<project name="TestAnt1" default="all">
  <description>
    Génération de l'application
  </description>

  <property name="bin" location="bin"/>
  <property name="src" location="src"/>
  <property name="build" location="build"/>
  <property name="doc" location="${build}/doc"/>
  <property name="lib" location="${build}/lib"/>
  <property name="junit_path" value="junit.jar"/>

  <target name="init" description="Initialisation">
    <tstamp/>
    <buildnumber file="numerobuild.txt" />
    <echo message="Generation numero : ${build.number} du ${TODAY}"/>
  </target>

  <target name="compil" depends="init" description="Compilation">
    <javac srcdir="${src}" destdir="${bin}">
          <classpath>
        <pathelement path="${java.class.path}"/>
        <pathelement location="${junit_path}"/>
      </classpath>
    </javac>
  </target>

  <target name="all" depends="init, compil, test, doc" 
    description="Generation complete">
    <echo message="Generation complete."/>
  </target>
  <target name="doc" depends="compil" description="Generation documentation">
    <javadoc destdir="${doc}" author="true" version="true" use="true" 
      package="true">
      <fileset dir = "${src}">
        <include name="**/*.java"/>
        <exclude name="**/*Test*"/>
      </fileset>
      <classpath>
        <pathelement path="${java.class.path}"/>
        <pathelement location="${junit_path}"/>
      </classpath>
    </javadoc>
  </target>

  <target name="test" depends="compil" description="Executer tests avec JUnit">
    <junit fork="yes" haltonerror="true" printsummary="on">
      <formatter type="plain" usefile="false" />
      <test name="ExecuterLesTests"/>
      <classpath>
        <pathelement location="${bin}"/>
        <pathelement location="${junit_path}"/>
      </classpath>
    </junit>
  </target>
</project>

Buildfile: I:\eclipse\workspace\test_junit\build.xml
init:
    [echo] Generation numero : 16 du July 2 2003
compil:
test:
   [junit] Running ExecuterLesTests
   [junit] Tests run: 3, Failures: 0, Errors: 0, Time elapsed: 0,02 sec
   [junit] Testsuite: ExecuterLesTests
   [junit] Tests run: 3, Failures: 0, Errors: 0, Time elapsed: 0,02 sec
   [junit] 
   [junit] Testcase: testCalculer took 0,01 sec
   [junit] Testcase: testCalculer took 0 sec
   [junit] Testcase: testSommer took 0 sec
doc:
 [javadoc] Generating Javadoc
 [javadoc] Javadoc execution
 [javadoc] Loading source file I:\eclipse\workspace\test_junit\src\MaClasse.java...
 [javadoc] Loading source file I:\eclipse\workspace\test_junit\src\MaClasse2.java...
 [javadoc] Constructing Javadoc information...
 [javadoc] Standard Doclet version 1.4.1
 [javadoc] 
 [javadoc] Building tree for all the packages and classes...
 [javadoc] Building index for all the packages and classes...
 [javadoc] Building index for all classes...
all:
    [echo] Generation complete.
BUILD SUCCESSFUL
Total time: 4 seconds

Eclipse 3.1 propose un éditeur dédié à la mise à jour de script Ant. Cet éditeur est utilisé est par défaut utilisé pour éditer les scripts Ant. Il propose des fonctionnalités qui facilitent leur rédaction.

Dans un fichier build.xml vide, il est possible de demander la création un fichier xml type avec deux targets en utilisant la combinaison de touches Ctrl+espace

Chaque partie qui compose le fichier build.xml est marquée avec une petite icône  dans la partie gauche. Chacune de ces icônes permet de masquer la partie qu'elle désigne. Lorsque le curseur passe au dessus de cette partie, une ligne désigne la partie.

Un clic sur l'icône permet de masquer la partie concernée.

L'icône se transforme en un petit signe plus : . En cliquant, sur cette icône, la partie masquée est de nouveau affichée. En laissant le curseur de la souris sur cette icône, la partie masquée est affichée dans une bulle d'aide.

Il est possible d'obtenir de l'aide à partir de l'éditeur. Il suffit de sélectionner un tag et d'appuyer sur la combinaison de touches Shift + F2.

Attention, une connexion internet est nécessaire pour utilisé en oeuvre cette fonctionnalité. Le navigateur interne s'ouvre avec une aide en ligne concernant le tag.

Cette documentation permet d'obtenir un descriptif du tag, un détail de ces paramètres et des exemples.

L'éditeur est capable de synchroniser les modifications apportées à un élément : pour cela il faut positionner le curseur sur l'élément et d'utiliser l'option « Renommer dans le fichier » du menu contextuel.

Toutes les occurrences sont marquées par un cadre. La modification de l'élément entraîne automatiquement la modification de toutes ces utilisations dans le fichier.

L'option « Formater » du menu contextuel permet de mettre en forme le code source du script Ant.