Ant javac illesztő használata

A javac illesztő segítségével az Eclipse fordító Ant összeépítési fájlban is használható. Az Eclipse fordító használatához egyszerűen a build.compiler tulajdonságot kell megadni az összeépítési fájlban.

A köteg fordító működtetéséhez egy ant összeépítési fájlban az ant futási környezet osztályútvonalának tartalmaznia kell az Eclipse köteg fordítót. Az ant összeépítési fájl futtatásakor:

  1. Az Eclipse környezeten kívül: az ant futási környezet osztályútvonal beállításának legegyszerűbb módja az ecj.jar fájl hozzáadása a -lib argumentum használtával, vagy ha kiíratja az ANT_HOME helyszínre.
  2. Eclipse környezetben ugyanazon JRE használatával: az Eclipse köteg fordító implicit módon hozzá lesz adva az Ant futási környezet osztályútvonalához.
  3. Eclipse környezetben eltérő JRE használatával: az Eclipse köteg fordítót explicit módon hozzá kell adni az Ant futási környezet osztályútvonalához. Ezt az ecj.jar fájl használatával vagy az org.eclipse.jdt.core jar fájl és az org.eclipse.jdt.core jar fájlban található jdtCompilerAdapter.jar fájl használatával lehet elvégezni (ezt a jar fájlt kell először kibontani).

Az alábbiakban egy kisebb példa látható:


<?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 javac Ant feladat szintaxisa az Ant javac feladat dokumentáció leírásban található meg. Az aktuális illesztő a Javac Ant feladat 1.4.1-1.6.5-ig terjedő változatait támogatja.

Ha 1.5.0 utáni változatot használ, akkor fordítóspecifikus beállítások megadásához használhatja a beágyazott fordítóparaméter elemet (<compilerarg>) is.


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

Megjegyzés:
  1. A fordítótól függő összeépítési fájlok elkerülése érdekében erősen ajánlott egy olyan <compilerarg> használata, melynek "compiler" attribútum értéke org.eclipse.jdt.core.JDTCompilerAdapter. Ha ez nincs beállítva, akkor az összeépítési fájlt csak az Eclipse fordítóprogramjával lehet használni. Ellenkező esetben, ha a név különbözik a build.compiler tulajdonságban megadottól, akkor a beágyazott fordító paraméter figyelmen kívül marad.
  2. A <compilerarg> nem használható bizonyos értékek, például cél érték, forrás érték, hibakeresési beállítások vagy bármely más olyan beállítás megadásához, amelyek a javac ant feladat meghatározott attribútumaival is beállíthatók. Használatát arra kell fenntartani, hogy megadja a fordítóspecifikus beállításokat, mint például a figyelmeztetési beállítások. Ha egy parancssori paramétert többször is meg van adva, akkor az Eclipse kötegfordító a következőhöz hasonló hibákat adhat:
    többször szereplő cél megfelelési szint meghatározás: 1.5