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.

  1. Crie um projeto Java chamado 'HW'.
  2. Crie um arquivo de origem Java chamado 'HelloWorld' com um método principal.
  3. Coloque uma única instrução 'System.out.println()' no método principal e faça-a imprimir uma saudação de sua escolha.
  4. Salve as alterações.
  5. Crie um arquivo chamado 'projectBuilder.xml', abra o editor Ant nele, digite o seguinte conteúdo e salve as alterações.
  6. <?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>

  7. Em uma das visualizações de navegação, selecione o projeto HW e escolha Propriedades no menu de contexto.
  8. No diálogo de propriedades do projeto, selecione Construtores e, em seguida, clique em Novo....
  9. No diálogo Escolher tipo de configuração, selecione Construção do Ant e clique em OK.
  10. 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.
    Guia Principal do diálogo Ferramentas externas
  11. 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.
    Guia Atualizar do diálogo Ferramentas Externas
  12. Na guia Destinos, o destino padrão deverá ser selecionado.
  13. 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.
    Guia Opções de construção do diálogo Ferramentas externas
  14. Aplique as alterações e clique em OK.
  15. 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.
    Diálogo Propriedades do Projeto

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.