Använda ant javac-adaptern

Eclipse-kompilatorn kan användas i en Ant-byggfil med hjälp av javac-adaptern. Om du vill använda Eclipse-kompilatorn behöver du bara definiera egenskapen build.compiler i byggfilen.

För att batchkompilatorn ska kunna arbeta i en Ant-byggfil, måste Ant-körmiljöns klassökväg innehålla Eclipse-batchkompilatorn. När du kör Ant-byggfilen:

  1. utanför Eclipse: Det enklaste sättet att ange körmiljöns klassökväg är att lägga till filen ecj.jar med hjälp av argumentet -lib eller att dumpa den inuti platsen ANT_HOME.
  2. inuti Eclipse genom att använda samma JRE som Eclipse: Eclipse-batchkompilatorn läggs implicit till Ant-körmiljöns klassökväg.
  3. inuti Eclipse genom att använda JRE: Eclipse-batchkompilatorn måste explicit läggas till Ant-körmiljöns klassökväg. Det går att göra med filen ecj.jar eller JAR-filen org.eclipse.jdt.core och filen jdtCompilerAdapter.jar som finns inuti JAR-filen org.eclipse.jdt.core (JAR-filen måste först extraheras).

Här följer ett mindre exempel:


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

Den syntax som används för javac Ant-uppgiften finns i Ant javac task-dokumentationen. Den aktuella adaptern hanterar Javac Ant-uppgifterna version 1.4.1 upp till 1.6.5.

Om du använder en version senare än 1.5.0 kan du använda det nästlade kompilatorargumentet element (<compilerarg>) till att ange kompilatorspecifika alternativ.


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

Anm.
  1. För att förhindra att du får kompilatorberoende byggfiler rekommenderar vi starkt att du använder <compilerarg> vars kompilatorattributvärde är org.eclipse.jdt.core.JDTCompilerAdapter. Om du inte anger detta, kan byggfilen bara användas med Eclipse-kompilatorn. Om du anger detta, ignoreras det nästlade kompilatorargumentet om namnet skiljer sig från det kompilatornamn som anges av egenskapen build.compiler.
  2. <compilerarg> ska inte användas för att ange värden som målvärde, källvärde eller felsökningsalternativ eller några alternativ som kan anges med definierade attribut för Ant-uppgiften javac. Argumentet ska bara användas till att skicka kompilatorspecifika alternativ, t.ex. för varningar. När ett kommandoradsargument anges flera gånger rapporterar Eclipse-batchkompilatorn fel som:
    duplicate target compliance setting specification: 1.5