Tarefas Ant
Identificador:
org.eclipse.ant.core.antTasks
Descrição:
Permite que os plug-ins definam tarefas Ant arbitrárias para serem utilizadas pela infra-estrutura Ant. A infra-estrutura Ant padrão permite a inclusão de tarefas arbitrárias.
Infelizmente, é improvável que o plug-in Ant Core tenha as classes requeridas por essas tarefas em seu classpath (ou qualquer um de seus pré-requisitos).
Para solucionar esse problema, os clientes devem definir uma extensão que conecte-se a este ponto de extensão e mapeie um nome de tarefa para uma classe. O plug-in Ant poderá, então, pedir para que o plug-in declarante carregue a classe especificada.
Marcação de Configuração:
<!ELEMENT extension (antTask*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - um identificador completo do ponto de extensão de destino
- id - um identificador opcional da instância de extensão
- name - um nome opcional da instância de extensão
<!ELEMENT antTask EMPTY>
<!ATTLIST antTask
name CDATA #REQUIRED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - o nome da tarefa que será definida
- class - o nome completo de uma classe Java que implementa a tarefa. Geralmente, essa classe deve ser uma subclasse de
org.apache.tools.ant.Task
.
- library - um caminho relativo à localização de instalação do plug-in da biblioteca que contém a tarefa.
- headless - indica se essa tarefa é adequada para a utilização em um ambiente Ant "sem periféricos". Se estiver executando headless e o atributo for "false", a tarefa não será carregada ou definida. Além disso, o carregador de classes do plug-in não será incluído como um carregador de classes pai no carregador de classes Ant.
O valor implícito será true, quando não for especificado.
- eclipseRuntime - indica se essa tarefa requer um tempo de execução do Eclipse (por exemplo, deve ser executado no mesmo VM do Eclipse). O valor implícito será true, quando não for especificado.
Exemplos:
A seguir, há um exemplo de um ponto de extensão das tarefas Ant:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Implementação Fornecida:
A plataforma em si fornece um número de tarefas incluindo eclipse.incrementalBuild e eclipse.refreshLocal.
Direitos Autorais (c) 2000, 2005 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados
sob os termos da Eclipse Public License v1.0 que acompanha esta
distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/epl-v10.html