Tareas de Ant
Identificador:
org.eclipse.ant.core.antTasks
Descripción:
Permite a los conectores 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 conector 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 conector Ant podrá solicitar que el conector 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
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name: nombre de la tarea que hay que definir.
- 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
conector 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 conector 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, 2005 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