Tareas de Ant
Identificador:
org.eclipse.ant.core.antTasks
Descripción:
Permite a los plug-ins definir tareas Ant arbitrarias para que
se utilicen en la infraestructura de Ant. La infraestructura estándar de Ant permite la adición de tareas arbitrarias.
Desgraciadamente, no es probable que el plug-in núcleo de Ant tenga las clases necesarias para estas tareas en su vía de acceso de clases (o las de sus prerrequisitos).
Para solucionar este problema, los clientes deben definir una extensión que se conecte a este punto de extensión y correlacione un nombre de tarea con una clase. A continuación, el plug-in Ant podrá solicitar que el plug-in declarante cargue la clase especificada.
Código de configuración:
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point: identificador totalmente calificado del punto de extensión destino
- id: identificador opcional de la instancia de extensión
- name: nombre opcional de la instancia de extensión
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
uri CDATA #IMPLIED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name: nombre de la tarea que hay que definir.
- uri: URI en el que debe residir esta definición. Solo se utiliza con una versión de Ant posterior a 1.6.
- class: nombre totalmente calificado de la clase
Java que implementa la tarea. Generalmente, esta clase debe ser una subclase de
org.apache.tools.ant.Task
.
- library: vía de acceso relativa a la ubicación de instalación de
plug-in de la biblioteca que contiene la tarea.
- headless: indica si esta tarea es adecuada para utilizarla en un entorno Ant "sin cabecera" ("headless"). Si la ejecución se realiza en modalidad sin cabecera y el atributo es
"false", la tarea no se cargará ni definirá. El cargador de clases del plug-in tampoco se añadirá como cargador de clases padre al cargador de clases de Ant.
Si no se especifica, se toma por omisión el valor true.
- eclipseRuntime - indica si esta tarea requiere un entorno de ejecución Eclipse (es decir, si debe ejecutarse en la misma VM que Eclipse). Si no se especifica, se toma por omisión el valor true.
Ejemplos:
A continuación figura un ejemplo de
punto de extensión de tareas de Ant:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Implementación suministrada:
La propia plataforma suministra
varias tareas, entre ellas eclipse.incrementalBuild y eclipse.refreshLocal.
Copyright (c) 2000, 2006 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están
disponibles bajo los términos de la licencia pública común (Eclipse Public
License) v1.0 que acompaña a esta distribución, y está disponible en http://www.eclipse.org/legal/epl-v10.html