Ant-javac-sovittimen käyttö

Voit käyttää Eclipse-kääntäjää Ant-koontitiedostossa javac-sovittimen avulla. Kun haluat käyttää Eclipse-kääntäjää, määritä koontitiedostoon build.compiler-ominaisuus.

Jotta eräkääntäjä toimisi ant-koontitiedostossa, Eclipse-eräkääntäjän on oltava ajonaikaisessa ant-luokkapolussa. Toimi seuraavasti, kun ajat ant-koontitiedoston:

  1. Ajo muualla kuin Eclipse-ympäristössä: Helpoin tapa määrittää ajonaikainen ant-luokkapolku on lisätä ecj.jar-tiedosto käyttämällä -lib-argumenttia tai lisäämällä se ANT_HOME-sijaintiin.
  2. Ajo Eclipse-ympäristössä käyttämällä samaa JRE-ympäristöä kuin Eclipse: Järjestelmä lisää Eclipse-eräkääntäjän ajonaikaiseen ant-luokkapolkuun implisiittisesti.
  3. Ajo Eclipse-ympäristössä käyttämällä jotakin toista JRE-ympäristöä: Eclipse-eräkääntäjä on lisättävä ajonaikaiseen ant-luokkapolkuun eksplisiittisesti. Voit tehdä sen käyttämällä ecj.jar-tiedostoa tai jar-tiedostoa org.eclipse.jdt.core ja sen sisältämää jdtCompilerAdapter.jar-tiedostoa (pura org.eclipse.jdt.core-tiedosto ensin).

Seuraavassa on pieni esimerkki.


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

Javac Ant -tehtävässä käytetty syntaksi on esitelty Ant javac -tehtävän dokumentaatiossa. Nykyinen sovitin tukee Javac Ant -tehtävien versioita 1.4.1 - 1.6.5.

Jos käytössä on versiota 1.5.0 uudempi versio, voit käyttää sisäkkäistä kääntäjän argumenttielementtiä (<compilerarg>) määrittämään kääntäjäkohtaiset vaihtoehdot.


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

Huomautus:
  1. Jotta koontitiedostoista ei tulisi kääntäjästä riippuvia, elementin <compilerarg> käyttö on erittäin suositeltavaa. Kyseisen elementin kääntäjämääritteen arvo on org.eclipse.jdt.core.JDTCompilerAdapter. Jos tätä määritystä ei aseteta, koontitiedostoa voi käyttää vain Eclipse-kääntäjällä. Jos se asetetaan, sisäkkäinen kääntäjäargumentti ohitetaan, jos nimi on eri kuin ominaisuuden build.compiler määrittämä kääntäjän nimi.
  2. Elementtiä <compilerarg> ei tule käyttää kohdearvon, lähdearvon, vianmääritysasetusten tai minkään muiden sellaisten asetusten arvojen määritykseen, jotka voitaisiin määrittää javac-ant-tehtävän määritettyjen määritteiden avulla. Elementti on varattava kääntäjäkohtaisten asetusten, kuten varoitusasetusten, välitykseen. Jos komentorivin argumentti määritetään useasti, Eclipse-eräkääntäjässä voi ilmetä seuraavan kaltaisia virheitä:
    kohteen yhteensopivuusasetuksen määrityksen kaksoiskappale: 1.5