Javac

説明

Javaソースツリーをコンパイルします。

Javaソースファイルをコンパイルするために、 コンパイル元とコンパイル先のディレクトリを再帰的に走査します。 Javaファイルは、対応する.classファイルが存在しないか、 .javaファイルよりもクラスファイルが古い場合にのみ、 コンパイルされます。

注意: Antは、リビルドが必要なクラスを見つけるために、 ソースとクラスのファイル名だけを使用します。 ネストクラスに関しては、ソースファイルとクラスファイルの名前が異なり、 ソースが検索されません。 存在/更新時間だけでない、他の方法による依存性の検査をするには、 <depend> タスクを見てください。

ソースファイルがパッケージの一部のときは、 ソースツリーのディレクトリ構造は、パッケージ階層に従っていなければいけません。

コンパイルされるファイルの集合を絞り込むことができます。 これにはincludes、includesfile、 excludes、excludesfile属性を使用することができます。 includesやincludesfile属性を使って、取り込みたいファイルを指定します。 excludeやexcludesfile属性は、除外したいファイルを指定するために使用します。 両方のケースで、ファイル名か関連するディレクトリ(複数)を使って、 ファイルのリストを指定できます。 srcdir属性、ネストした<src>要素(複数)、 ワイルドカードを含むパターンを使います。 ファイルの包含/排他の処理方法や、ワイルドカードパターンの記述方法については ディレクトリベースのタスク の章を見てください。

異なるコンパイラを使用できます。 これは、build.compilerプロパティーで指定でき、 ビルドを通して、すべての<javac>タスクに影響します。 またはcompiler属性を使うと、 現在の<javac>タスクに対して指定できます。 build.compilerプロパティーとcompiler属性 に有効な値は次のものです:

• classic (JDK 1.1/1.2の標準コンパイラ) – javac1.1 と javac1.2 が別名として使えます。
• modern (JDK 1.3/1.4/1.5の標準コンパイラ) – javac1.3 と javac1.4 と javac1.5 が別名として使えます。
• jikes (Jikes コンパイラ).
• jvc (MicrosoftのSDKのJava / Visual J++ 用のコマンドラインコンパイラ) – microsoftが別名として使えます。
• kjc (kopi コンパイラ).
• gcj (gccのgcjコンパイラ)
• sj (Symantecのjavaコンパイラ) – symantecが別名として使えます。
• extJavac (それ自身のJVMの中でmodernかclassic のどちらかで実行されます)

デフォルトはjavac1.xで、xは Antを実行するときに使用したJDKのバージョンに依存します。 これらの提供されたコンパイラの他に、 異なるコンパイラのインターフェイスを使いたい場合は、 CompilerAdapterインターフェイス(org.apache.tools.ant.taskdefs.compilersパッケージ) を実装したクラスを書くことができます。 build.compilerプロパティーかcompiler属性に 完全クラス名を指定してください。

fork属性はbuild.compilerプロパティーや compiler属性の指定を上書きし、 JAVA_HOMEで指定されたJDK1.1以降のコンパイラが期待されています。

compiler属性を使うことで、 コマンドラインスイッチを使いたいときに、 AntにどのJDKのバージョンを使うかを伝えることができます。 fork="true"を指定した場合でも適用されます。 これは、JDK1.2+を使っていて、JDK1.1を実行したいときに便利です。 compiler="javac1.1"と (例えば)depend="true"を指定したとき、 Antは-Xdependの代わりに -dependのコマンドラインスイッチを使用します。

このタスクはコンパイラに渡すクラスパスから、存在しない ファイルやディレクトリへのすべてのエントリーを省きます。

Windows 注意: Windows上でforkなしのモードで、modernコンパイラが使われている場合、 <javac>タスクのクラスパス中の 存在するファイルをロックし、これらを開放しません。 この副作用として、ビルド中は これらのファイルを削除、移動することができません。 これの対処は、コンパイラを実行するときにforkすることです。

パラメータ

ネストした要素として指定されるパラメタ

このタスクは暗黙のファイルセットを持っていて、 ネストした<include>、<exclude>、<patternset>要素 と同様に、 <fileset>の属性(dirはsrcdirになります) のすべてをサポートします。

src、classpath、sourcepath、 bootclasspath、extdirs

<javac>のsrcdir、classpath、 sourcepath、bootclasspath、 extdirs属性は パス類似構造であり、 それぞれネストした <src>、 <classpath>、 <sourcepath>、 <bootclasspath>、 <extdirs>要素によって指定することができます。

compilerarg

ネストした<compilerarg>要素で、 コンパイラに対して追加のコマンドライン引数を指定することができます。 これらの要素はコマンドライン引数のように指定できますが、 有効な引数として使えるのは追加する属性が、与えられたコンパイラの実装で 使われている場合のみです。

例

  <javac srcdir="${src}"
         destdir="${build}"
         classpath="xyz.jar"
         debug="on"
  />

${src}ディレクトリ以下のすべての.javaファイル をコンパイルし、.classファイルを${build}ディレクトリに保存します。 使用するクラスパスはxyz.jarを含み、 デバッグ情報をonにしてコンパイルします。

  <javac srcdir="${src}"
         destdir="${build}"
         fork="true"
  />

${src}ディレクトリ以下のすべての.javaファイル をコンパイルし、.classファイルを${build}ディレクトリに保存します。 これは、デフォルトのjavac実行を使って、 javacコンパイルをフォークします。

  <javac srcdir="${src}"
         destdir="${build}"
         fork="java$$javac.exe"
  />

${src}ディレクトリ以下のすべての.javaファイル をコンパイルし、.classファイルを${build}ディレクトリに保存します。 これは、java$javac.exeという名前の実行ファイルを使って、 javacコンパイラをフォークします。 $記号が２つめの$でエスケープされることに注意してください。

  <javac srcdir="${src}"
         destdir="${build}"
         includes="mypackage/p1/**,mypackage/p2/**"
         excludes="mypackage/p1/testpackage/**"
         classpath="xyz.jar"
         debug="on"
  />

${src}ディレクトリ以下のすべての.javaファイル をコンパイルし、.classファイルを${build}ディレクトリに保存します。 使用するクラスパスはxyz.jarを含み、デバッグ情報がonになっています。 mypackage/p1とmypackage/p2以下のファイルだけが使用されます。 mypackage/p1/testpackageディレクトリ内およびその下のファイルは、 コンパイルから除外されます。

  <javac srcdir="${src}:${src2}"
         destdir="${build}"
         includes="mypackage/p1/**,mypackage/p2/**"
         excludes="mypackage/p1/testpackage/**"
         classpath="xyz.jar"
         debug="on"
  />

これは、前のサンプルと同じですが、プロパティsrc2で定義される二番目のソースパスが追加されています。 これは、次のようなネストした<src>要素を使用しても記述できます。

  <javac destdir="${build}"
         classpath="xyz.jar"
         debug="on">
    <src path="${src}"/>
    <src path="${src2}"/>
    <include name="mypackage/p1/**"/>
    <include name="mypackage/p2/**"/>
    <exclude name="mypackage/p1/testpackage/**"/>
  </javac>

異なるJDKのjavacコンパイラを実行したい場合、 コンパイラを探す場所、使用するJDKのバージョンを、 正しいコマンドラインスイッチを選択して、 Antに伝えなければなりません。 次の例は新しいプロセスでJDK1.1のjavacを実行します。 Antが異なるバージョンのJava VMで実行されても、 正しいコマンドラインスイッチが使われます。

  <javac srcdir="${src}"
         destdir="${build}"
         fork="yes"
         executable="/opt/java/jdk1.1/bin/javac"
         compiler="javac1.1"
  />

注意: 普通にルート以下のあるパッケージのソースファイルだけをコンパイルしたい場合、 パッケージをフィルターするために include/exclude属性や <include>/<exclude>のネストされた要素 を使ってください。 srcdir属性(あるいはネストした<src>要素)で、 パッケージ構造の一部を含めないでください。 Antはコンパイルのターゲットを実行する度にソースファイルをリコンパイルします。 追加情報はAnt FAQ を参照してください。

明確に指定されたファイルのみのコンパイルを希望して、 javacのデフォルト検索メカニズムを無効にするならば、 sourcepath属性をセットしないことができます。

  <javac sourcepath="" srcdir="${src}"
         destdir="${build}" >
    <include name="**/*.java" />
    <exclude name="**/Example.java" />
  </javac>

この方法でjavacは、"${src}"ディレクトリ以下すべてのjavaソースファイルをコンパイルしますが、exampleをスキップします。 もし、exampleでないファイルがそれらを参照すれば、コンパイラはエラーを生成します。

注意: Windows上でAntを使用する場合には、外部コンパイラを使用するたびに新しいDOSのウィンドウがポップアップしますが、 これはあなたが使用しているJDKの問題だと思われます。 この問題は、JDK< 1.2のすべてのJDKで発生する可能性があります。

Jikes 注意

Jikes は、 タスクを呼び出す前に、以下に示すようなプロパティーを設定することで、 いくつかの拡張オプションをサポートします。 各プロパティーの設定は、ビルドを通して、 すべての<javac>タスクに影響を与えます。 Antの開発者は、これは醜く融通の利かないことだと気づきます。 – 将来はもっとよい方法が期待されています。 すべてのオプションはbooleanで、falseの他に解釈されるには、 trueかyesを設定しなければなりません。 デフォルトでは、build.compiler.warningsはtrueで、 他のすべてのプロパティーはfalseです。

Jvc 注意

間違って<javac>を呼び出す前に、 build.compiler.jvc.extensionsプロパティを設定することがない限り、 JvcはMicrosoft拡張を有効にします。

Copyright © 2000-2004 The Apache Software Foundation. All rights Reserved.

[訳注:これは西野 亨、宮本信二の訳を参考に、横田聡が翻訳しました。日本語訳に対するコメントがあれば report@jajakarta.orgに送ってください]