ant javac アダプターの使用

Eclipse コンパイラーは、javac アダプターを使用して Ant ビルド・ファイル内で使用できます。 Eclipse コンパイラーを使用するためには、ビルド・ファイルに build.compiler プロパティーを正しく定義することが必要なだけです。

Ant ビルド・ファイルで稼働中のバッチ・コンパイラーを取得するためには、Ant ランタイム・クラスパスに、 Eclipse バッチ・コンパイラーを含む必要があります。Ant ビルド・ファイルを実行する場合は、以下のようになります。

  1. Eclipse の外部: Ant ランタイム・クラスパスをセットアップする最も簡単な方法は、ecj.jar ファイルを、-lib 引数を用いて追加するか、または 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>

javac Ant タスクで使用される構文は、 『Ant javac タスク・ドキュメンテーション』にあります。 現行アダプターは、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. ターゲット値、ソース値、デバッグ・オプション、または javac ant タスクの定義済み属性を使用して設定される任意のオプションなどの値を設定するために <compilerarg> を使用しないでください。 その使用は、警告オプションなどのコンパイラー固有のオプションを渡すために確保しておく必要があります。 コマンド行の引数が複数回指定されると、Eclipse バッチ・コンパイラーは次のようなエラーを報告する場合があります。
    ターゲット承諾設定仕様が重複しています: 1.5