Ant-opgaver
Id:
org.eclipse.ant.core.antTasks
Beskrivelse:
Gør det muligt for plugins at definere tilfældige Ant-opgaver til brug i Ant-infrastrukturen. Standard-Ant-infrastrukturen tillader tilføjelse af vilkårlige opgaver.
Desværre er det usandsynligt, at Ant Core-plugin har de klasser, som opgaverne skal bruge, i sin
classpath (eller i nogle af sine forudsætningers classpath).
For at løse dette skal klienter definere en udvidelse, der passer i udvidelsespunktet, og som tilknytter et opgavenavn til en klasse vha. mapping. Ant-plugin'en kan derefter anmode om, at den erklærende plugin indlæser den angivne klasse.
Konfigurationskode:
<!ELEMENT extension (antTask*)>
<!ATTLIST-udvidelse
point CDATA #REQUIRED
id CDATA #IMPLIED
navn CDATA #IMPLIED>
- point - en fuldstændig id for måludvidelsespunktet.
- id - en valgfri id for udvidelsesforekomsten.
- name - et valgfrit navn på udvidelsesforekomsten.
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
uri CDATA #IMPLIED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - navn på den opgave, der skal defineres.
- uri - uri'en, som denne defininition skal være i. Anvendes kun ved brug af Ant senere end 1.6.
- class - det fuldstændige navn på en Java-klasse, som implementerer opgaven. Normalt skal denne klasse være en underklasse til
org.apache.tools.ant.Task
.
- library - en sti relativ til plugin-installationsplaceringen af det bibliotek, der indeholder opgaven.
- headless - angiver, om opgaven er velegnet til brug i et "headless" Ant-miljø. Hvis opgaven udføres headless, og attributten er "false",
bliver opgaven hverken indlæst eller defineret. Dertil kommer, at plugin-klasseindlæsningen ikke tilføjes som en overordnet classloader til Ant-classloader.
Den underforståede værdi er true, hvis den ikke angives.
- eclipseRuntime - angiver, om opgaven kræver en Eclipse-runtime, dvs. skal udføres i samme VM som Eclipse. Den underforståede værdi er true, hvis den ikke angives.
Eksempler:
Følgende er et eksempel på et udvidelsespunkt til en Ant-opgave:
<udvidelsespunkt=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Leveret implementering:
Selve platformen leverer nogle opgaver, herunder
eclipse.incrementalBuild og eclipse.refreshLocal.
Copyright (c) 2000, 2006 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html