使用 ant javac 配接器

您可利用 javac 配接器,在 Ant 建置檔內使用 Eclipse 編譯器。 如果要使用 Eclipse 編譯器,您只需在建置檔中定義 build.compiler 內容即可。

為了使批次編譯器能夠在 Ant 建置檔中運作,Ant 執行時期類別路徑需要包含 Eclipse 批次編譯器。當您執行 Ant 建置檔時:

  1. 在 Eclipse 外:設定 Ant 執行時期類別路徑最簡單的方式,是利用 -lib 引數來新增 ecj.jar 檔,或是在 ANT_HOME 位置內將它傾出。
  2. 在 Eclipse 內使用與 Eclipse 相同的 JRE:Eclipse 批次編譯器會隱含地加入 Ant 執行時期類別路徑中。
  3. 在 Eclipse 內使用不同的 JRE:Eclipse 批次編譯器必須明確加入 Ant 執行時期類別路徑中。 您可以利用 ecj.jar 檔,或是使用 org.eclipse.jdt.core jar 檔和位於 org.eclipse.jdt.core jar 檔(這個 jar 檔需要先解壓縮)內的 jdtCompilerAdapter.jar 檔,來完成這項作業。

以下是一個小範例:


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

您可以在 Ant javac 作業文件中,找到 javac Ant 作業所用的語法。 現行配接器支援 Javac Ant 作業 1.4.1 到 1.6.5 版。

如果您使用的是 1.5.0 以上的版本,您可以使用巢狀編譯器引數元素 (<compilerarg>) 來指定編譯器特定的選項。


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

附註:
  1. 為了避免使用相依於編譯器的建置檔,強烈建議您使用其 "compiler" 屬性值為 org.eclipse.jdt.core.JDTCompilerAdapter 的 <compilerarg>。 如果未如此設定,該建置檔只能用於 Eclipse 編譯器。如果設定,且其名稱與 build.compiler 內容所指定的編譯器名稱不同,則會忽略巢狀編譯器引數。
  2. <compilerarg> 不應用來設定像是目標值、來源值、除錯選項,或是任何可利用 javac Ant 作業的已定義屬性來設定的選項。其用法必須加以保留,以傳遞編譯器專屬的選項(如:警告選項)。如果一個指令行引數指定多次,如果一個指令行引數指定多次,Eclipse 批次編譯器會報告如下的錯誤:
    重複的目標標準設定規格:1.5