Ant-taken
ID:
org.eclipse.ant.core.antTasks
Beschrijving:
Hiermee kunt u in plugins willekeurige Ant-taken definiëren voor gebruik
in de Ant-infrastructuur. Het is ook mogelijk om taken aan de standaard Ant-infrastructuur toe te voegen.
Het is echter onwaarschijnlijk dat de klassen die voor deze taken vereist zijn, zich in het klassenpad van de Ant-plugin
(of die van een van de vereiste onderdelen) bevinden.
Om dit te verhelpen moeten clients een extensie definiëren die in dit extensiepunt wordt ingevoegd
en een taaknaam aan een klasse koppelt. De Ant-plugin kan vervolgens een aanvragen indienen om de opgegeven klasse in de declarerende plugin te laden.
Configuratiemarkup:
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - een volledig gekwalificeerd ID van het doelextensiepunt.
- id - een optioneel ID van de extensie-instance.
- name - een optionele naam van de extensie-instance.
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
uri CDATA #IMPLIED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - de naam van de taak die u wilt definiëren.
- uri - de URI waarop deze definitie zich bevindt. Wordt alleen gebruikt vanaf Ant 1.6.
- class - de volledig gekwalificeerde naam van een Java-klasse waarmee de taak wordt geïmplementeerd.
Normaal gesproken is deze klasse een subklasse van
org.apache.tools.ant.Task
.
- library - een relatief pad ten opzichte van de installatielocatie van de plugin voor de bibliotheek met de taak.
- headless - geeft aan of deze eigenschap kan worden gebruikt in een "headless" Ant-omgeving. Als de headless-werkstand actief is en het kenmerk is "false",
wordt de taak niet geladen of gedefinieerd. Bovendien wordt de pluginklassenlader niet toegevoegd als een bovenliggende klassenlader aan de Ant-klassenlader.
De geïmpliceerde waarde is "true" als u niets opgeeft.
- eclipseRuntime - geeft aan of voor deze taak een Eclipse-runtime vereist is (op dezelfde VM als Eclipse moet worden uitgevoerd). De geïmpliceerde waarde is "true" als u niets opgeeft.
Voorbeelden:
Dit is een voorbeeld van de extensie antTasks:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Verstrekte implementatie:
Een aantal taken, zoals eclipse.incrementalBuild en eclipse.refreshLocal, wordt door het platform verstrekt.
Copyright (c) 2000, 2006 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.html.