Korzystanie z adaptera javac narzędzia Ant

Kompilator Eclipse może być używany wewnątrz plików budowy Ant przy użyciu adaptera javac. Aby korzystać z kompilatora Eclipse, wystarczy zdefiniować właściwość build.compiler w tym pliku budowy.

Aby kompilator wsadowy działał w pliku budowy Ant, ścieżka klas środowiska wykonawczego Ant musi zawierać kompilator wsadowy środowiska Eclipse. Gdy plik budowy Ant jest uruchamiany:

  1. poza środowiskiem Eclipse: najłatwiejszą metodą skonfigurowania ścieżki klas środowiska wykonawczego Ant jest dodanie pliku ecj.jar przy użyciu argumentu -lib lub wrzucenie go do położenia ANT_HOME.
  2. w środowisku Eclipse przy użyciu tego samego środowiska JRE co środowisko Eclipse: kompilator wsadowy środowiska Eclipse jest niejawnie dodawany do ścieżki klas środowiska wykonawczego Ant.
  3. w środowisku Eclipse przy użyciu innego środowiska JRE: kompilator wsadowy środowiska Eclipse musi zostać jawnie dodany do ścieżki klas środowiska wykonawczego Ant. Można to zrobić, korzystając z pliku ecj.jar lub pliku JAR org.eclipse.jdt.core i pliku jdtCompilerAdapter.jar znajdującego się w pliku JAR org.eclipse.jdt.core jar (należy go wcześniej wyodrębnić z tego pliku JAR).

Przykład:


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

Składnię używaną dla zadania javac narzędzia Ant można znaleźć w dokumentacji czynności javac narzędzia Ant. Bieżący adapter obsługuje wersje od 1.4.1 do 1.6.5 zadania Javac narzędzia Ant.

W przypadku używania wersji nowszej niż 1.5.0 można użyć elementu zagnieżdżonego argumentu kompilatora (<compilerarg>), aby określić konkretne opcje kompilatora.


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

Uwaga:
  1. Aby uniknąć plików budowania zależnych od kompilatora, zdecydowanie zaleca się użycie argumentu <compilerarg> z atrybutem compiler o wartości org.eclipse.jdt.core.JDTCompilerAdapter. W przeciwnym razie pliku budowy będzie można używać tylko z kompilatorem platformy Eclipse. Jeśli argument zostanie ustawiony, zagnieżdżony argument kompilatora zostanie zignorowany, o ile nazwa będzie inna niż nazwa kompilatora określona właściwością build.compiler.
  2. Argument <compilerarg> nie powinien być używany do ustawiania takich wartości, jak wartość docelowa, wartość źródłowa, opcje debugowania oraz inne opcje, które można ustawić za pomocą zdefiniowanych atrybutów zadania Ant javac. Używanie tego argumentu musi być ograniczone do przekazywania opcji specyficznych dla kompilatora, np. opcji ostrzeżeń. Jeśli argument wiersza komend zostanie określony więcej niż jeden raz, kompilator wsadowy Eclipse może zgłosić następujący błąd:
    duplikat specyfikacji ustawienia zgodności obiektu docelowego: 1.5