Criando um Arquivo de Construção Ant do Construtor de Projetos

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 denominado HW.
  2. Crie um arquivo de origem Java chamado HelloWorld com o método main.
  3. Coloque uma única instrução System.out.println() no método main e faça-a imprimir uma saudação de sua escolha.
  4. Salve as alterações.
  5. Crie um arquivo denominado projectBuilder.xml, abra o Editor Ant nele, insira 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="bin"/>
    	</target>
    </project>
    
  6. Em uma das visualizações de navegação, selecione o projeto HW e escolha Propriedades no menu de contexto.
  7. No diálogo de propriedades do projeto, selecione Construtores e, em seguida, clique em Novo....
  8. No diálogo Escolher tipo de configuração, selecione Construção do Ant e clique em OK.
  9. O diálogo Ferramentas Externas aparece. Configure o nome para Makejar. Na Guia Principal, clique em Arquivo de Construção Procurar Área de Trabalho... e configure o Local para que seja o arquivo de construção projectBuilder.xml criado acima. 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

  10. Na guia Atualizar, queremos nos certificar de que quando o HelloWorld.jar é 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 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 cara, 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

  11. Na guia Destinos, especifique quando esse construtor de projetos será executado e quais destinos. Por padrão, o destino default é configurado para executar Após um "Clean" e Construção Manual. Você pode especificar outros destinos e outros acionadores. 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 Destinos do diálogo Ferramentas Externas

  12. Aplique as alterações e clique em OK.
  13. De volta ao diálogo de propriedades do projeto, você verá um construtor de projeto chamado Makejar que é configurado 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 arquivo de construção 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, a refatoração 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 Construtor Java e é possível controlar quando o Construtor Java é executado com relação aos construtores de projetos que você definir.

Tarefas relacionadas
Criando os arquivos de construção Ant
Editando os arquivos de construção Ant
Salvando & Reutilizando as Opções do Ant
Executando os arquivos de construção Ant
Arquivos de construção Ant como construtores de projetos
Executando construtores de projetos
Ferramentas externas
Construtores de projetos não Ant
Ferramentas externas independentes