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 à extraire. Cette entrée doit être au format type@id, comme indiqué dans le format du fichier de répertoires ; |
buildDirectory: |
répertoire où les scripts d'extraction sont générés, et où les projets de dispositifs et de plug-in seront extraits ; |
directory: |
chemin d'accès au fichier du répertoire ; |
children: |
facultatif. Indique si la génération de script pour les plug-ins et fragments contenus est appelée. La valeur par défaut est true ; |
cvspassfile: |
facultatif. Nom d'un fichier de mots de passe CVS ; |
fetchTag: |
facultatif. Remplace la balise fournie dans le fichier de répertoire par la valeur donnée ; |
configInfo: |
facultatif. Liste de configurations séparées par une perluète indiquant la configuration ciblée. Par défaut, cette liste est configurée comme étant indépendante de la plateforme ; |
recursiveGeneration: |
facultatif. Indique si des scripts d'extraction doivent être générés pour les dispositifs imbriqués. La valeur par défaut est true. |
elements : |
entrée à générer. Cette entrée doit être au format type@id, comme indiqué dans le format du fichier de répertoires ; |
buildDirectory : |
répertoire contenant les dispositifs et les plug-ins à générer ; |
children : |
facultatif. Indique si la génération de script pour les plug-ins et les fragments contenus doit être appelée. La valeur par défaut est true ; |
recursiveGeneration : |
facultatif? Indique si la génération de script pour les dispositifs contenus doit être appelée. La valeur par défaut est true ; |
devEntries : |
facultatif. Liste de répertoires séparés par une virgule à fournir au chemin de classes de compilation ; |
buildingOSGi : |
facultatif. Indique si la cible est 3.x. ou
2.1. La valeur par défaut est true ; |
baseLocation : |
facultatif. Indique un dossier contenant une installation Eclipse cible avec les sous-répertoires features/ etplugins/. |
configInfo : |
facultatif. Liste de configurations séparées par une perluète qui indique la configuration cible. Par défaut, cette liste est configurée comme étant indépendante de la plateforme ; |
pluginPath : |
facultatif. Liste d'emplacements séparés par un séparateur de fichier de plateforme, dans laquelle d'autres plug-ins doivent être recherchés |
archivesFormat : |
facultatif. Liste de configurations séparées par une perluète et format de sortie attendu pour chaque configuration. 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 : |
facultatif. Chemin séparé par '/' de l'emplacement d'un produit RCP à générer. Le premier segment du chemin doit se référer à l'ID du plug-in d'un plug-in contenant le fichier .product. |
signJars : |
facultatif. Indique si les scripts générés doivent signer les fichiers JAR des dispositifs et des plug-ins. 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 : |
facultatif. Indique si un fichier jnlp doit être généré pour tous les dispositifs à générer. |
outputUpdateJars : |
facultatif. Génère les plug-ins et les dispositifs dans le format du site de mise à jour lorsqu'il est défini. La valeur par défaut est false. Notez que le fichier site.xml n'est pas généré, ni mis à jour |
forceContextQualifier : |
facultatif. Utilise la valeur fournie pour remplacer le .qualifier généré en fonction des plug-ins et des dispositifs. (Voir aussi Qualificateurs de version) |
generateFeatureVersionSuffix: | facultatif. Indique si le suffixe de version de dispositif doit être généré. |
groupConfiguration
: |
facultatif. Indique si toutes les configurations à générer doivent être regrouper dans une même archive. |
generateVersionsLists : |
facultatif. Indique si des fichiers de propriétés contenant les versions des dispositifs et des plug-ins générés doivent être générés. |
featureId : |
ID à fournir au dispositif généré. |
buildDirectory : |
répertoire contenant les dispositifs et les plug-ins (dans les sous-répertoires /features et /plugins) à inclure. Le dispositif généré est placé dans le sous-répertoire /features. |
baseLocation : |
facultatif. Indique un dossier contenant les dispositifs et plug-ins installés |
productFile : |
facultatif. Fichier de produit sur lequel est basé le dispositif généré. |
verify : |
Indique s'il est nécessaire d'utiliser le résolveur pour vérifier que les plug-ins et dispositifs sont disponibles. Détermine également si le dispositif peut gérer correctement les fragments et les plug-ins spécifiques de la plateforme, qui sont placés dans des fichiers JAR. Si tous les éléments à inclure dans le dispositif sont disponibles localement, affectez la valeur true à verify. Si les éléments doivent être extraits d'un référentiel, affectez la valeur false à verify, utilisez le dispositif résultant pour extraire les plug-ins et dispositifs nécessaires, puis régénérez la fonction de conteneur en utilisant verify = True. |
pluginPath : |
facultatif. Liste d'emplacements séparés par un séparateur de fichier de plateforme dans laquelle des plugins supplémentaires doivent être recherchés |
configInfo : |
facultatif. Liste de configurations séparées par une perluète qui indique la configuration cible. Par défaut, cette liste est configurée comme étant indépendante de la plateforme ; |
pluginList : |
facultatif. Liste d'ID de plug-in séparés par une virgule à inclure dans le dispositif généré. |
featureList : |
facultatif, Liste d'ID de dispositif séparés par une virgule à inclure dans le dispositif généré. |
fragmentList : |
facultatif. Liste d'ID de fragment séparés par une virgule à inclure dans le dispositif généré. |
<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.