Tarefas de Ant
Identificador:
org.eclipse.ant.core.antTasks
Descrição:
Permite a plug-ins definir tarefas de Ant arbitrárias a serem utilizadas pela estrutura de Ant. A estrutura padrão de Ant permite que se adicionem tarefas arbitrárias.
Infelizmente, é improvável que o plug-in núcleo de Ant tenha as classes necessárias a estas tarefas no seu caminho de classes (ou as de qualquer um dos seus pré-requisitos).
Para solucionar este problema, os clientes devem definir uma extensão que conecte a este ponto de extensão e correlacione um nome de tarefa a uma classe. O plug-in de Ant poderá, então solicitar 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 totalmente qualificado 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
uri CDATA
#IMPLIED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - o nome da tarefa a ser definida
- uri - O uri em que esta definição deve residir. É apenas utilizado
se estiver a utilizar uma versão da Ant posterior à 1.6.
- class - o nome totalmente qualificado de uma classe Java que implemente a tarefa. Geralmente, esta classe tem de 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 esta tarefa é adequada para utilizar num ambiente Ant "headless". Caso esteja a executar headless e o atributo seja "false", a tarefa não será carregada ou definida. De igual forma, o carregador da classe plugin não será adicionado como carregador de classes ascendente ao carregador de classes de Ant.
O valor implícito é true, quando não houver especificação.
- eclipseRuntime - indica se esta tarefa requer um tempo de execução de Eclipse (i.e. tem de ser executada na mesma VM do Eclipse). O valor implícito é true, quando não houver especificação.
Exemplos:
De seguida apresenta-se um exemplo de um ponto de tarefas de Ant:
<extension point=
"org.eclipse.ant.core.antTasks"
>
<antTask name=
"coolTask"
class=
"com.example.CoolTask"
library=
"lib/antSupport.jar"
/>
</extension>
Implementação Facultada:
A plataforma em si fornece várias tarefas, incluindo eclipse.incrementalBuild e eclipse.refreshLocal.
Copyright (c) 2000, 2006 IBM Corporation e outros.
Todos os direitos reservados. Este programa e os materiais que o acompanham estão disponíveis sob os termos da Eclipse Public License v1.0, que acompanha esta distribuição e estão disponíveis em http://www.eclipse.org/legal/epl-v10.html