Création d'un fichier de génération Ant pour compilateur de projet

Pour comprendre le fonctionnement de compilateurs de projets, nous allons créer un projet simple comportant un seul fichier source et un fichier de génération Ant générant un seul fichier de classes. Bien que cet exemple utilise Java, il est important de signaler que les compilateurs de projets sont disponibles pour tous les projets, quel que soit le langage.

  1. Créez un projet Java nommé HW.
  2. Créez un fichier source Java nommé HelloWorld comportant une méthode principale.
  3. Placez une instruction System.out.println() dans cette méthode, en lui associant une salutation de votre choix.
  4. Sauvegardez les modifications.
  5. Créez le fichier nommé projectBuilder.xml, ouvrez-le dans l'éditeur Ant, entrez le contenu suivant, puis enregistrez les modifications.
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">
      <target name ="makejar" description="Création d'un fichier jar pour le projet HW">
        <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
      </target>
    </project>
    
  6. Dans l'une des vues de navigation, sélectionnez le projet HW, puis choisissez Propriétés dans son menu contextuel.
  7. Dans la boîte de dialogue des propriétés du projet, sélectionnez Compilateurs, puis cliquez sur Nouveau....
  8. Dans la boîte de dialogue Choix d'un type de configuration, sélectionnez Compilation Ant, puis cliquez sur OK.
  9. La boîte de dialogue Outils externes apparaît. Attribuez le nom Makejar. Dans l'onglet Principal, cliquez sur Fichier de génération Parcourir l'espace de travail pour affecter à la zone Emplacement le fichier de génération projectBuilder.xml créé précédemment. Cliquez ensuite sur Répertoire de base Parcourir l'espace de travail..., puis paramétrez le répertoire de base sur le projet HW.

    Onglet principal de la boîte de dialogue Outils externes

  10. Dans l'onglet Régénérer, vérifiez que HelloWorld.jar est visible dans Eclipse au moment de sa création. Par défaut, aucune régénération n'est effectuée à la fin de l'exécution d'un compilateur de projet ; aussi, sélectionnez Régénérer les ressources à la fin de l'opération, puis Le projet contenant la ressource sélectionnée dans la liste des variables de portée. Comme la régénération peut être onéreuse, il est conseillé de traiter la plus petite entité contenant toutes les ressources qui seront affectées par le fichier de génération.

    Onglet Régénérer de la boîte de dialogue Outils externes

  11. Dans l'onglet Cibles, vous pouvez spécifier quand sont exécutés ce compilateur de projet et les cibles. Par défaut, la cible par défaut (default) est configurée pour s'exécuter après un "nettoyage" et une génération manuelle. Vous pouvez spécifier d'autres cibles et d'autres déclencheurs. L'exécution du générateur est possible lors de génération automatiques, mais déconseillée car elle réduit les performances de l'ordinateur. Pour plus d'informations sur les types de génération, cliquez ici.

    Onglet Cibles de la boîte de dialogue Outils externes

  12. Validez les modifications, puis cliquez sur OK.
  13. De retour dans la boîte de dialogue des propriétés du projet, vous pouvez remarquer le compilateur de projets Makejar configuré pour s'exécuter après le compilateur Java par défaut. Cliquez sur OK pour sauvegarder le compilateur de projets, puis refermez la boîte de dialogue.
    Remarque :Vous pourriez placer le fichier de génération Ant avant le compilateur Java, , mais cela ne présenterait pas d'intérêt dans cet exemple.

    Boîte de dialogue de propriétés du projet

Le compilateur Java exécute le compilateur Java interne d'Eclipse qui, à son tour, indexe le fichier source pour que les fonctions de recherche et de propagation des modifications soient disponibles. Il n'est donc pas possible de remplacer le compilateur Java d'Eclipse par un compilateur de projets. Vous pouvez désactiver le compilateur Java et contrôler à quel moment il s'exécute en ce qui concerne les compilateurs de projet que vous définissez.

Tâches connexes
Création des fichiers de génération Ant
Cibles Ant du générateur de projet
Edition des fichiers de génération Ant
Sauvegarde & réutilisation des options Ant
Exécution des fichiers de génération Ant
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