Tâches Ant
Identificateur :
org.eclipse.ant.core.antTasks
Description :
Permet aux
plug-ins de définir des tâches Ant arbitraires que l'infrastructure
Ant utilisera. L'infrastructure Ant standard permet l'ajout de tâches arbitraires.
Malheureusement, il est peu probable que le plug-in de l'API principale
d'Ant ait les classes requises par ces tâches dans son chemin de classe
(ou celui de l'une des conditions prérequises).
Pour régler ce problème, les clients doivent définir une extension qui se
connecte à ce point d'extension et mappe un nom de tâche sur une classe. Le plug-in d'Ant peut alors demander au plug-in déclarant de charger la
classe spécifiée.
Marques de configuration :
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - identificateur qualifié complet du point
d'extension cible.
- id - identificateur facultatif de l'instance d'extension.
- name - nom facultatif de l'instance d'extension.
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - nom de la tâche à définir.
- class - nom qualifié complet d'une classe Java implémentant la
tâche. En général, il doit s'agir d'une sous-classe de
org.apache.tools.ant.Task
.
- library - chemin d'accès au répertoire d'installation du
plug-in relatif à la bibliothèque contenant la tâche.
- headless - indique si la tâche est adaptée à un usage dans un
environnement Ant "sans tête". Si elle s'exécute sans tête et que
l'attribut a la valeur "false", la tâche n'est ni chargée ni définie. De
même, le chargeur de classe du plug-in n'est pas ajouté en tant que
chargeur de classe parent au chargeur de classe Ant.
La valeur par défaut est true.
- eclipseRuntime - indique si cette tâche requiert une
exécution Eclipse (exécutée sur la même machine virtuelle qu'Eclipse). La valeur par défaut est true.
Exemples :
L'exemple
suivant illustre un point d'extension des tâches Ant :
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Implémentation fournie :
La
plateforme fournit un nombre de tâches, dont eclipse.incrementalBuild and eclipse.refreshLocal.
Copyright (c) 2000, 2005 IBM Corporation and others.
All rights reserved. Ce programme et les produits associés sont
distribués sous licence publique Eclipse v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html