Ant-Tasks
Kennung:
org.eclipse.ant.core.antTasks
Beschreibung:
Hiermit können Plug-ins willkürliche Ant-Tasks zur Verwendung durch die Ant-Infrastruktur definieren. Die Ant-Standardinfrastruktur lässt das Hinzufügen willkürlicher Tasks zu.
Leider ist es jedoch unwahrscheinlich, dass das Ant-Kern-Plug-in in seinem Klassenpfad (bzw. im Klassenpfad einer seiner erforderlichen Komponenten) die Klassen aufweist, die durch diese Tasks benötigt werden.
Um dieses Problem zu lösen, sollten Clients eine Erweiterung definieren, die an diesem Erweiterungspunkt hinzugefügt wird und einen Tasknamen zu einer Klasse zuordnet. Anschließend kann das Ant-Plug-in das Laden der angegebenen Klasse vom deklarierenden Plug-in anfordern.
Konfigurationsbefehle:
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - Vollständig qualifizierte ID des Zielerweiterungspunkts
- id - Optionale ID des Erweiterungsexemplars
- name - Optionaler Name des Erweiterungsexemplars
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - Name der Task, die definiert werden soll.
- class - Der vollständig qualifizierte Name einer Java-Klasse, die die Task implementiert. Diese Klasse muss generell eine Unterklasse von
org.apache.tools.ant.Task
sein.
- library - Ein relativer Pfad zur Installationsposition des Plug-ins für die Bibliothek, die die Task enthält.
- headless - Gibt an, ob diese Task in einer Ant-Headless-Umgebung verwendet werden kann. Wenn eine Headless-Umgebung verwendet wird und dieses Attribut auf "false" gesetzt ist, wird die Task nicht geladen und nicht definiert. Außerdem wird das Klassenladeprogramm des Plug-ins nicht als übergeordnetes Klassenladeprogramm zum Ant-Klassenladeprogramm hinzugefügt.
Wenn dieses Attribut nicht definiert ist, wird der Wert "true" impliziert.
- eclipseRuntime - gibt an, ob diese Task eine Eclipse-Laufzeit erfordert (z.B. bei erforderlicher Ausführung in der gleichen VM wie Eclipse). Wenn dieses Attribut nicht definiert ist, wird der Wert "true" impliziert.
Beispiele:
Beispiel eines Erweiterungspunkts für eine Ant-Eigenschaft:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Bereitgestellte Implementierung:
Die Plattform selbst stellt eine Reihe von Tasks zur Verfügung, die
'eclipse.incrementalBuild and eclipse.refreshLocal' enthalten.
Copyright (c) 2000, 2005 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß den Bedingungen der "Eclipse Public License v1.0" zur Verfügung gestellt, die dieser Lieferung beiliegt und unter
http://www.eclipse.org/legal/epl-v10.html abgerufen werden kann.