Esta tarefa executa todos os arquivos gerados necessários pelas Ferramentas da API dentro de um pacote configurável binário. Esta tarefa é executada durante as construções do Eclipse ou durante a exportação do pacote configurável para todos os projetos que tenham uma natureza de Ferramentas da API.
Agora, apenas o arquivo chamado .api_description é criado.
O nome da tarefa Ant é: apitooling.apigeneration. Para ser usado, o arquivo jar
apitooling-ant.jar deve estar no caminho de classe Ant.
<apitooling.apigeneration projectname="..."
project="..."
binary="..."
target="..."
debug="..."
/>
| Atributo | Descrição | Necessário |
| projectname | Configurar o nome do projeto | Sim |
| projeto |
Configurar o local do projeto. Esta é a pasta que contém todos os arquivos de origem para o projeto fornecido. O local é configurado usando um caminho absoluto. |
Sim |
| binário |
Configurar os locais binários. Esta é uma lista de pastas ou arquivos jar que contêm todos os arquivos .class para o projeto fornecido. Eles são separados pelo separador de caminho da plataforma. Cada entrada deve existir. Elas devem ser especificadas usando caminhos absolutos. |
Sim |
| destino |
Configurar o local de destino. Esta é a pasta na qual os arquivos são gerados. O local é configurado usando um caminho absoluto. |
Sim |
| depuração |
Configure o valor da depuração. Os valores possíveis são: true,
falseO padrão é false.
|
Não |
| extraManifests |
Configurar os locais dos arquivos de manifesto extras. Esta é uma lista de locais de arquivos MANIFEST.MF extras que podem ser configurados para fornecer mais pacotes de API para varredura. Eles são separados pelo separador de caminho da plataforma. Cada entrada deve existir. Se o caminho não for absoluto, ele será resolvido em relação ao diretório de trabalho atual. Arquivos Jar podem ser especificados em vez do arquivo MANIFEST.MF. Se um arquivo jar for especificado, seu arquivo MANIFEST.MF será lido, se existir. |
Não |
| extraSourceLocations |
Configurar os locais de origem extras. Esta é uma lista de locais para arquivos de origem que serão varridos. Eles são separados pelo separador de caminho da plataforma. Cada entrada deve existir. Elas devem ser especificadas usando caminhos absolutos. |
Não |
| allowNonapiproject |
Permite que a tarefa execute nos projetos que estão ativados não para Ferramentas da API. Se esta tarefa for executada em um projeto que não possua uma natureza de Ferramentas da API, nenhum arquivo api_description será gerado pois assume-se que o projeto não suporta as Ferramentas da API. Em alguns casos, existe a necessidade de gerar o arquivo de descrição em projetos sem a natureza. A configuração deste parâmetro como true fará com que a tarefa não verifique uma natureza. |
Não |
<apitooling.apigeneration
projectname="org.eclipse.jdt.core_3.5.0.v_927"
project="d:\eclipse\org.eclipse.jdt.core"
binary="d:\eclipse\org.eclipse.jdt.core\bin;d:\eclipse\org.eclipse.jdt.core\antbin"
target="d:\plugins\org.eclipse.jdt.core"
debug="true"
/>
Isso criará um arquivo chamado .api_description
dentro da pasta
d:\plugins\org.eclipse.jdt.core com base na origem contida
em
d:\eclipse\org.eclipse.jdt.core e nos arquivos .class
contidos em
d:\eclipse\org.eclipse.jdt.core\bin.
Tarefa Ant de Análise
Tarefa Ant de Congelamento da API
Tarefa Ant de Uso da API
Tarefa Ant de Conversão do Relatório de Análise
Tarefa Ant de Conversão de Relatório de Congelamento de API
Tarefa Ant de Reprovação da API
Tarefa Ant de Conversão do Relatório de Reprovação da API
Tarefa Ant de Conversão do Relatório de Uso da API