As tarefas de importação são usadas para importar um arquivo de construção para o projeto atual. Os arquivos importados são analisados usando ProjectHelper. O ProjectHelper é realmente responsável por analisar os arquivos importados.
A tarefa de importação é uma tarefa de nível superior, portanto não pode ser usada dentro do elemento de destino. Existem dois aspectos funcionais relacionados a esta tarefa.
Substituição de alvo
Se um destino no arquivo atual também estiver disponível no arquivo importado, o destino do arquivo atual terá precedência.
Propriedades Especiais
Os arquivos importados são locais para o projeto principal atual. Para distinguir entre arquivos importados e locais, o Ant adiciona uma propriedade que contém o caminho para o arquivo de construção importado.
Nota: Se o arquivo importado não contiver o atributo name, sua propriedade não será definida.
Atributos da tarefa de importação do Apache Ant
| Atributo | Descrição | Obrigatório |
|---|---|---|
| arquivo | O arquivo a ser importado. | Sim |
| opcional | Se for verdade, não interrompa a construção se o arquivo não existir. | Não |
| como | Especifica o prefixo anexado aos nomes de destino. | Não |
| prefixSeparator | Um separador a ser usado entre o prefixo e o nome do destino. | Não |
Exemplo de tarefa de importação do Apache Ant
O código abaixo importa destinos do arquivo common-targets.xml localizado no diretório pai.
Ele importa um projeto
Ele importa o destino do arquivo targets.xml que está dentro do diretório comum.