De javac-adapter voor Ant gebruiken

U kunt het Eclipse-compileerprogramma in een Ant-buildbestand gebruiken met de javac-adapter. U hoeft dan alleen de eigenschap build.compiler te definiëren in het buildbestand.

Als u het batchcompileerprogramma voor Ant-buildbestanden wilt gebruiken, moet het Eclipse-batchcompileerprogramma in het Ant-runtimeklassenpad zijn opgenomen. Als u het Ant-buildbestand uitvoert:

  1. Buiten Eclipse: u kunt het runtimeklassenpad van Ant het eenvoudigst instellen door het bestand ecj.jar toe te voegen met de parameter -lib of door het in de locatie ANT_HOME te plaatsen.
  2. Binnen Eclipse met dezelfde JRE als Eclipse: het Eclipse-batchcompileerprogramma wordt impliciet toegevoegd aan het runtimeklassenpad van Ant.
  3. Binnen Eclipse met een andere JRE: het Eclipse-batchcompileerprogramma moet expliciet worden toegevoegd aan het runtimeklassenpad van Ant. U kunt hiervoor het bestand ecj.jar gebruiken of anders het bestand jdtCompilerAdapter.jar in het JAR-bestand org.eclipse.jdt.core (dit bestand dient u eerst uit te pakken).

Een klein voorbeeld:


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

De syntaxis voor de javac-taak van Ant kunt u vinden in de documentatie. De huidige adapter ondersteunt alle versies van de javac-taak tussen 1.4.1 en 1.6.5.

Gebruikt u een latere versie dan 1.5.0, dan kunt u de geneste compileerparameter (<compilerarg>) gebruiken om compileerspecifieke opties op te geven.


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

Opmerking:
  1. Om te voorkomen dat buildbestanden afhankelijk zijn van een bepaald compileerprogramma, is het zeer aan te raden om een <compilerarg> te gebruiken waarvan de compileerkenmerkwaarde gelijk is aan org.eclipse.jdt.core.JDTCompilerAdapter. Anders is het buildbestand alleen geschikt voor het Eclipse-compileerprogramma. Is de optie wel ingesteld, dan wordt de geneste compileeroptie genegeerd als de naam verschilt van de compileerprogrammanaam uit de eigenschap build.compiler.
  2. U mag <compilerarg> niet gebruiken voor het instellen van waarden als doelwaarde, bronwaarde, foutopsporingsopties of opties die kunnen worden ingesteld met de gedefinieerde kenmerken van de ant-taak javac. Het gebruik is gereserveerd voor het doorgeven van opties die specifiek voor het compileerprogramma zijn, bijvoorbeeld waarschuwingsopties. Als een opdrachtregelargument meer dan één keer wordt opgegeven, kan het batchcompileerprogramma van Eclipse foutberichten als het volgende genereren:
    dubbele doelspecificatie compatibiliteitsinstelling: 1.5