Génération de scripts Ant

Ant est un moteur de script Open Source capable d'exécuter des scripts écrits en XML. Ant est idéal pour l'exécution de tâches figurant habituellement dans les générations automatisées.

Les variables définies dans le fichier build.properties du plug-in, du fragment ou du dispositif sont utilisés par les scripts Ant de génération automatique.  PDE génère des scripts Ant pour la création des fichiers de génération de plug-in et de fragment individuels, et un script global de génération du fichier JAR du dispositif. Ce script "principal" est également chargé de l'exécution des fichiers de scripts individuels selon l'ordre approprié (défini par la chaîne des dépendances des plug-ins). Chaque fichier de génération porte le même nom (build.xml) et est créé en tant qu'élément apparenté des fichiers manifestes dans les projets correspondants.

Comme les scripts Ant utilisent les variables de remplacement de build.properties, vous pouvez généralement les utiliser "en l'état" sans modifier les scripts générés. Si vous les modifiez, il est inutile de recréer les scripts à chaque régénération du composant. Pour cette raison, la génération et l'exécution des scripts peuvent être contrôlées individuellement.

Pour créer des scripts, il suffit de cliquer sur le bouton Package... dans le manifeste du dispositif. Si le manifeste est fermé, vous pouvez sélectionner le fichier, puis la commande Créer un fichier JAR de composant dans le menu en incrustation (il existe une commande pour les manifestes de plug-in et de fragment). La commande génère le script de compilation et ouvre l'assistant Ant permettant de l'exécuter :

Assistant d'exécution Ant affichant les cibles disponibles

L'assistant Ant standard offre deux possibilités de personnalisation : en fournissant les arguments d'exécution et en sélectionnant une ou plusieurs cibles de compilation.

En général, les arguments Ant sont utilisés pour fournir des valeurs de propriétés en remplacement des valeurs par défaut et pour contrôler le processus de compilation. Les arguments sont définis à l'aide de "-Dproperty=valeur". Les propriétés reconnues sont les suivantes :

Lors de l'exécution des scripts de compilation de dispositif, les cibles suivantes sont utilisées pour appeler des cibles individuelles de plug-ins ou fragments. Pour indiquer la cible à exécuter, vous devez définir la propriété target (par ex. -Dtarget=refresh):

Dans ce scénario, l'une des cibles all.* fait office d'itérateur, tandis que la cible réelle à exécuter est désignée par la propriété target comme indiqué ci-dessus.

Les cibles suivantes génèrent des JAR et des sources pour tous les enfants du dispositif :

Vous pouvez sélectionner la cible build.update.jar pour générer un JAR de dispositif au format qu'utilise le mécanisme d'installation/mise à jour. Vous pouvez utiliser la propriété feature.destination mentionnée ci-dessus pour définir l'emplacement du JAR et plugin.destination pour contrôler l'emplacement des JAR de mise à jour des plug-ins et des fragments.

La cible zip.distribution crée un fichier zip du dispositif et de ses plug-ins et fragments dans une structure de type SDK mais n'inclut pas de code source. La source peut être générée à l'aide de la cible zip.sources.

Utilisez la cible clean pour supprimer tous les éléments produits par l'exécution des cibles. Enfin, la cible refresh effectue une "régénération" du projet en cours, de sorte que les nouvelles ressources générées soient visibles dans le Navigateur ou la vue Package.

Lorsque vous exécutez des scripts de compilation de plug-ins et de fragments individuels, vous disposez d'une cible supplémentaire nommée zip.plugin. Elle crée un fichier zip des contenus source et binaire d'un plug-in en respectant la structure suivante :

id_version/
    contenu

où 'id' est l'identificateur unique du plug-in et 'version' la version du plug-in. Ce fichier zip peut être décompressé directement dans le répertoire d'installation d'Eclipse pour une sorte de déploiement manuel rapide.

 

Copyright IBM Corporation and others 2000, 2002