Utilizar el adaptador javac de Ant

El compilador Eclipse se puede utilizar dentro de un archivo de construcción Ant mediante el adaptador javac. Para poder utilizar el compilador Eclipse, basta con que solo defina la propiedad build.compiler en el archivo de construcción.

Para que el compilador por lotes funcione en un archivo de construcción ant, la vía de acceso de clases de tiempo de ejecución debe contener el compilador por lotes de Eclipse. Cuando ejecute el archivo de construcción ant:

  1. fuera de Eclipse: la forma más sencilla de configurar la vía de acceso de clases del archivo de construcción ant consiste en añadir el archivo ecj.jar mediante el argumento -lib o volcándolo en la ubicación ANT_HOME.
  2. dentro de Eclipse mediante el mismo JRE que Eclipse: el compilador por lotes de Eclipse se añade implícitamente a la vía de acceso de clases de tiempo de ejecución ant.
  3. dentro de Eclipse mediante un JRE diferente: el compilador por lotes de Eclipse debe añadirse explícitamente a la vía de acceso de clases de tiempo de ejecución ant. Esto puede hacerse mediante el archivo ecj.jar o mediante el archivo jar org.eclipse.jdt.core y el archivo jar jdtCompilerAdapter.jar que está en el archivo jar org.eclipse.jdt.core (este archivo jar debe extraerse primero).

A continuación se ofrece un pequeño ejemplo:


<?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>

La sintaxis utilizada para la tarea javac de Ant se encuentra en la documentación de las tareas javac de Ant. El adaptador actual soporta las tareas Javac Ant de las versiones 1.4.1 hasta 1.6.5.

Si se propone utilizar una versión posterior a 1.5.0, puede utilizar el elemento de argumento de compilador anidado (<compilerarg>) para especificar opciones específicas del 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 archivos de construcción dependientes del compilador, le aconsejamos encarecidamente que utilice un <compilerarg> cuyo valor de atributo "compilador" sea org.eclipse.jdt.core.JDTCompilerAdapter. Si no se establece así, el archivo de construcción solo se puede usar con el compilador Eclipse. Si se establece, el argumento de compilador anidado no se tiene en cuenta si el nombre es distinto del nombre de compilador especificado por la propiedad build.compiler.
  2. <compilerarg> no debe utilizarse para establecer valores como el valor de destino, valor de origen, opciones de depuración, o cualquier otra opción que pueda establecerse mediante los atributos definidos de la tarea ant javac. Su uso debe reservarse para pasar opciones específicas del compilador como las opciones de aviso. Cuando se especifica un argumento de línea de mandatos más de una vez, el compilador por lotes de Eclipse puede informar de errores del tipo:
    especificación de valor de conformidad destino duplicado: 1.5