Edition des fichiers de compilation Ant

Comme il s'agit de fichiers texte simples, les fichiers de compilation Ant sont modifiables dans n'importe quel éditeur de texte standard. Cependant, l'éditeur Ant d'Eclipse possède de multiples atouts, comme la coloration syntaxique, un assistant de contenu, la navigation, un marquage des occurrences et une vue de structure. Pour vous familiariser avec l'éditeur Ant, utilisez-le pour créer un fichier de génération Ant simple.

  1. Créez un fichier de génération Ant appelé HelloWorld.xml.
  2. Ouvrez l'éditeur Ant sur le fichier en sélectionnant Ouvrir avec>Editeur Ant dans le menu contextuel du fichier.
    Remarque : L'éditeur par défaut d'un fichier .xml est un éditeur de texte simple tant que ce fichier n'a pas le contenu d'un fichier de génération. Ce paramètre peut cependant être modifié dans la page de préférences Ouvre la page de préférences Associations de fichiers Fenêtre > Préférences > Général > Editeurs >Associations de fichiers.
  3. Entrez le code suivant dans l'éditeur :
    <?xml version="1.0" encoding="UTF-8" ?>
    <project name="Hello World" default="Hello" basedir="."> 
      <property name="HelloText" value="Hello"/>
      <target name="Hello">
        <echo>${HelloText}</echo>
      </target>
    </project>
    

    Contenu du fichier HelloWorld.xml

  4. Notez la couleur de la syntaxe pour les valeurs de propriété.
  5. Commencez la saisie d'une seconde cible en entrant <tar, puis appuyez sur Ctrl-espace pour activer l'assistant de contenu. Une liste de valeurs valides s'affiche. Sélectionnez l'exécution <cible>. Vous pouvez constater que l'éditeur insère les balises d'ouverture et de fermeture et laisse le curseur positionné pour la saisie des attributs de cette balise.
  6. Nommez cette cible World.
  7. Entrez une tâche echo similaire à celle de la cible Hello, mais en remplaçant le texte par ${WorldText}.
  8. Ajoutez une dépendance à la cible World à partir de la cible Hello. Placez le curseur après la définition de l'attribut du nom, appuyez sur Ctrl-espace puis sélectionnez l'exécution de l'attribut depends. Appuyez encore une fois sur Ctrl-espace pour obtenir l'exécution de l'autre cible World dans le fichier de génération.
  9. Enregistrez le contenu du fichier de compilation.
  10. Le contenu complet est à présent :
    <?xml version="1.0" encoding="UTF-8" ?>
    <project name="Hello World" default="Hello" basedir=".">
      <property name="HelloText" value="Hello"/>
      <property name="WorldText" value="World"/>
      <target name="Hello">
        <echo>${HelloText}</echo>
      </target>
    
      <target name="World">
        <echo>${WorldText}</echo>
      </target>
    </project>
    
  11. Sauvegardez les modifications dans HelloWorld.xml.
  12. Affichez la vue Structure ; vous pouvez alors constater que chaque propriété et chaque structure sont renseignées. En outre, chaque tâche figurant sous une cible est renseignée.

    Vue Structure pour un fichier de compilation Ant

  13. Cliquer sur une entrée de la vue Structure permet de l'atteindre directement dans l'éditeur. En outre, quand la vue Présentation est active, la saisie d'un caractère place la sélection de la vue devant la prochaine entrée visible commençant par ce caractère.
  14. Placez le curseur immédiatement après la balise de fermeture de l'un des deux éléments <target>, entrez <tar, puis appuyez sur les touches Ctrl-espace pour activer l'assistant de contenu. Vous pouvez constater que désormais les seules valeurs proposées sont </target> et la balise tar. En effet, les cibles imbriquées sont interdites dans l'éditeur Ant.

    Assistant de code de l'éditeur Ant
  15. Refermez l'éditeur sans enregistrer les modifications.

Tâches connexes
Création des fichiers de génération Ant
Exécution des fichiers de génération Ant
Sauvegarde & réutilisation des options Ant
Exécution des fichiers de génération Ant
Création d'un fichier de génération Ant pour compilateur de projet
Fichiers de génération Ant comme compilateurs de projet
Exécution des compilateurs de projet
Outils externes
Compilateurs de projet non Ant
Outils externes autonomes