Criando um Arquivo de Construção Ant do Construtor de Projeto
Para ver como os construtores de projetos funcionam, criaremos um projeto
simples com um único arquivo de origem e um arquivo de construção Ant que deslocará o
único arquivo de classe. Embora esse exemplo utilize Java, deve-se notar que esses
construtores de projeto estão disponíveis para todos os projetos, Java ou diferentes.
- Crie um projeto Java chamado 'HW'.
- Crie um arquivo de origem Java chamado 'HelloWorld' com um método principal.
- Coloque uma única instrução 'System.out.println()' no método principal e
faça-a imprimir uma saudação de sua escolha.
- Salve as alterações.
- Crie um arquivo chamado 'projectBuilder.xml', abra o editor Ant nele, digite o
seguinte conteúdo e salve as alterações.
<?xml version="1.0" encoding="UTF-8"?>
<project name="HW.makejar" default="makejar" basedir=".">
<target name ="makejar" description="Create a jar for the HW
project">
<jar jarfile="HelloWorld.jar" includes="*.class" basedir="."/>
</target>
</project>
- Em uma das visualizações de navegação, selecione o projeto HW e
escolha Propriedades
no menu de contexto.
- No diálogo de propriedades do projeto, selecione Construtores e, em seguida, clique em Novo....
- No diálogo Escolher tipo de configuração, selecione Construção do
Ant e clique em OK.
- O diálogo Ferramentas Externas aparece. Defina o nome como 'Makejar'.
Na guia Principal, clique em Buildfile Procurar Espaço de Trabalho...
e defina o Local como sendo o buildfile projectBuilder.xml criado
anteriormente. Em seguida, clique em Diretório Base Procurar Espaço de Trabalho...
e defina o Diretório Base como sendo o projeto HW.
- Na guia Atualizar, queremos nos certificar de que quando o HelloWorld.jar
for criado possamos vê-lo no Eclipse. Por padrão, nenhuma atualização será feita quando a
execução de um construtor de projeto for concluída; portanto, marque Atualizar recurso após a conclusão e,
em seguida, selecione O projeto que contém o recurso selecionado na lista de
variáveis de escopo. Como a atualização pode ser dispendiosa, normalmente
você deverá atualizar a entidade menor que contém todos os recursos que serão afetados
pelo arquivo de construção.
- Na guia Destinos, o destino padrão deverá ser selecionado.
- Na guia Opções de Compilação, é possível especificar quando esse
construtor de projeto será executado. Por padrão, isso é definido como Após uma "Limpeza"
e Durante Construções Manuais. A execução do construtor de projetos durante compilações
automáticas é possível, embora não seja recomendável por questões de desempenho.
- Aplique as alterações e clique em OK.
- De volta ao diálogo de propriedades do projeto, você verá um construtor de
projeto chamado 'Makejar', que é definido para ser executado após o Construtor Java
padrão. Clique em OK
para salvar o construtor de projetos e feche o diálogo.
Nota: É possível alterar a ordem para que o buildfile do Ant seja executado antes
do construtor Java, embora isso não faça sentido neste exemplo.

O Construtor Java executa o compilador Java interno do Eclipse
que, por sua vez, é o responsável pela indexação da origem para que a pesquisa, o
refactoring e muitos outros recursos estejam disponíveis. Desse modo, é possível
substituir o compilador Java interno do Eclipse utilizando um construtor de projeto. É possível desativar o Java Builder e é possível controlar
quando o Java Builder é executado com relação aos construtores de projetos que você definir.