Les scripts Ant sont généralement générés à l'aide de l'environnement
de développement de plug-in (PDE), mais ils peuvent également être générés
manuellement ou à partir d'autres scripts.
PDE propose effectivement des tâches Ant permettant de générer divers
scripts de génération. Les fonctions de génération de scripts de
compilation se trouvent dans les tâches suivantes. Des arguments
sont également répertoriés pour chaque tâche.
elements : entrée à rechercher. Cette entrée doit être au format type@id, comme indiqué dans le format du fichier de répertoires ;
buildDirectory : répertoire dans lequel les scripts recherchés sont générés et dans lequel les projets de plug-in et de fonctions sont contrôlés ;
directory : chemin d'accès à un fichier de répertoires ;
children : indique si la génération de scripts doit être appelée pour les plug-ins et les fragments imbriqués (facultatif). La valeur par défaut est true ;
cvspassfile : nom d'un fichier de mots de passe CVS (facultatif) ;
fetchTag : remplace la balise prédéfinie dans le fichier de répertoires par la valeur donnée (facultatif) ;
configInfo : configurations, séparées par une perluète, indiquant la configuration ciblée (facultatif). Par défaut, cette liste est configurée comme étant indépendante de la plateforme ;
recursiveGeneration : indique si les scripts de recherche doivent être générés pour les fonctions imbriquées (facultatif). La valeur par défaut est true.
elements : entrée à rechercher à partir du référentiel. Cette entrée doit être au format type@id, comme indiqué dans le format du fichier de répertoires ;
buildDirectory : répertoire contenant les fonctions et les plug-ins à générer ;
children : indique si la génération de scripts doit être appelée pour les plug-ins et les fragments imbriqués (facultatif). La valeur par défaut est true ;
recursiveGeneration : indique si la génération de scripts pour les dispositifs imbriqués doit être appelée (facultatif). La valeur par défaut est true ;
devEntries : liste de répertoires, séparés par une virgule, devant être indiquée dans le chemin d'accès aux classes de compilation (facultatif) ;
buildingOSGi : indique si la cible est la version 3.x. ou 2.1 (facultatif) ;
baseLocation : indique un dossier contenant les fonctions et les dossiers installés (facultatif) ;
configInfo : liste de configurations, séparées par une perluète, indiquant la configuration ciblée (facultatif). Par défaut, cette liste est configurée comme étant indépendante de la plateforme ;
pluginPath : liste d'URL, séparées par une virgule, et pointant sur les plug-ins installés (facultatif). Si elle est spécifiée, cette liste doit inclure tous les plug-ins à compiler ;
archivesFormat : liste de configurations, séparées par une perluète, et le format de sortie attendu pour chacune d'entre elles (facultatif). Le format est séparé de la configuration par un tiret (-). Les valeurs supportées sont : folder, tar, zip, antZip, impliquant respectivement que le format tar est utilisé pour créer les archives, qui utilisent la version info zip disponible sur la platforme, qui elle-même utilise le format antZip. La valeur par défaut est antZip.
product : '/' chemin séparé indiquant l'emplacement d'un produit RCP en cours de compilation (facultatif). Le premier segment du chemin doit se référer à l'ID du plug-in d'un plug-in contenant le fichier .product.
signJars : indique si les scripts générés doivent signer les fichiers JAR des fonctions et des plug-ins (facultatif). La valeur par défaut est false. Les paramètres du processus de signature sont contrôlés par les propriétés Ant suivantes : sign.alias, sign.keystore et sign.storepass qui sont respectivement transférées vers les paramètres de l'alias, du keystore et du storepass de la tâche signJar de Ant. La valeur par défaut est false.
generateJnlp : indique si un fichier JNLP doit être généré pour l'ensemble des fonctions en cours de génération (facultatif).
outputUpdateJars : génère (s'il a été configuré) des plug-ins et des fonctions dans le format du site de mise à jour (facultatif). La valeur par défaut est false. Notez que le fichier site.xml n'est ni généré, ni mis à jour.
forceContextQualifier : utilise une valeur donnée pour remplacer le fichier .qualifier existant par des plug-ins et des fonctions (facultatif).
<eclipse.fetch elements="bundle@org.eclipse.osgi" buildDirectory="c:\toBuild" directory="directory.txt" configInfo="win32,win32,x86 & linux, motif, x86" /> <eclipse.buildScript elements="bundle@org.eclipse.osgi" buildDirectory="c:\toBuild" archivesFormat="macosx, carbon, ppc - tar"/>
Les tâches précédemment décrites ne fonctionnent que si Eclipse est exécuté. Lorsqu'il s'agit plus particulièrement d'exécuter des scripts Ant à l'aide de tâches Eclipse, ces scripts doivent s'exécuter via l'application Eclipse Ant Runner. Dans ce cas précis, la ligne de commande est la suivante :
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Notez que les paramètres qui figurent après l'application sont ceux transmis à Ant.