Utilizar o adaptador ant javac

O compilador Eclipse pode ser utilizado num buildfile Ant com adaptador javac. Para utilizar o compilador Eclipse, só tem de definir a propriedade build.compiler no buildfile.

Para que o compilador de agrupamentos funcione num buildfile ant, o caminho de classe do tempo de execução de ant runtime tem de conter o compilador de agrupamentos do Eclipse. Ao executar o buildfile ant:

  1. fora do Eclipse: a forma mais fácil de configurar o caminho de classe de tempo de execução de ant é adicionar o ficheiro ecj.jar por meio do argumento -lib ou efectuar uma cópia de memória do mesmo no interior da localização de ANT_HOME.
  2. dentro do Eclipse utilizando mesmo JRE que o Eclipse: o compilador de batches do Eclipse é adicionado implicitamente ao caminho de classe do tempo de execução ant.
  3. dentro do Eclipse utilizando um JRE diferente: o compilador de batches do Eclipse tem de ser adicionado explicitamente ao caminho de classe do tempo de execução ant. Pode ser realizado usando o ficheiro ecj.jar ou usando o ficheiro jar org.eclipse.jdt.core e o ficheiro jdtCompilerAdapter.jar localizado no interior do ficheiro jar org.eclipse.jdt.core (em primeiro lugar, este ficheiro jar tem de ser extraído).

Apresenta-se um pequeno exemplo:


<?xml version="1.0" encoding="UTF-8"?>
<project name="compile" default="main" basedir="../.">

 <property name="build.compiler" value="org.eclipse.jdt.core.JDTCompilerAdapter"/>

 <property name="root" value="${basedir}/src"/>

 <property name="destdir" value="d:/temp/bin" />

 <target name="main">
  <javac srcdir="${root}" destdir="${destdir}" debug="on" nowarn="on" extdirs="d:/extdirs" source="1.4">
      <classpath>
        <pathelement location="${basedir}/../org.eclipse.jdt.core/bin"/>

      </classpath>
  </javac>
 </target>
</project>

A sintaxe utilizada para a tarefa Ant de javac pode ser encontrada na documentação da tarefa Ant de javac. O actual adaptador suporta a tarefa Ant de javac nas versões 1.4.1 até 1.6.5.

Se estiver a utilizar uma versão superior a 1.5.0, pode utilizar o elemento de argumento do compilador imbricado (<compilerarg>) para especificar as opções específicas do compilador.


...
<javac srcdir="${root}" destdir="${destdir}" debug="on" nowarn="on" extdirs="d:/extdirs" source="1.4">
    <classpath>
      <pathelement location="${basedir}/../org.eclipse.jdt.core/bin"/>
    </classpath>

    <compilerarg compiler="org.eclipse.jdt.core.JDTCompilerAdapter" line="-1.5 -warn:+boxing"/>
</javac>
...

Nota:
  1. Para evitar obter buildfiles dependentes do compilador, recomendamosvivamente que utilize um <compilerarg> cujo valor deatributo "compiler" seja org.eclipse.jdt.core.JDTCompilerAdapter. Se não definir assim, o buildfile só pode ser utilizado com o compilador Eclipse. Se for definido assim, o argumento do compilador imbricado é ignorado se o nome for diferente de nome do compilador especificado na propriedade build.compiler.
  2. <compilerarg> não deve ser utilizado para definir valores como o valor destino, valor origem, opções de depuração ou quaisquer opções que devem ser definidas utilizando os atributos definidos da tarefa ant javac. A sua utilização tem de ser reservada para transmitir opções específicas de compilador como opções de aviso. Quando um argumento da linha de comandos é especificado mais do que uma vez, o compilador batch Eclipse pode comunicar erros como este:
    especificação de definição em conformidade com o destino duplicada: 1.5