S-JIS[2004-05-25/2008-12-02]

EclipseでのAnt

EclipseでJavaのコーディングをしていれば自動的にコンパイルされるけれど、build.xmlを作っておいて それを実行することも出来る。

• antビューの開き方
• antビューへのビルドファイルの追加方法 [/2007-07-14]
• antの実行方法 [/2008-06-21]
  • 実行エラー [2005-07-23]
  • native2asciiのエラー [/2007-05-15]
• クラスパスへの追加 [2008-12-02]

antビュー

通常のビューと同じ手順で、antのビューを開く。

メニューバーの「ウィンドウ(W)」→「ビューの表示(V)」→「Ant」

build.xmlの追加

build.xmlを使うには、antビューにbuild.xmlを追加する必要がある。
追加するには、antビューの上方にある「ビルドファイルの追加（Eclipse2では）」をクリックする。そして、使用したいbuild.xmlを選択する。
または「検索でビルドファイルを追加」をクリックし、ワークスペースを検索して全てのbuild.xmlを追加することも出来る。

Eclipse3では、パッケージエクスプローラーに表示されているbuild.xmlをドラッグしてantビューにドロップすることでも 追加することが出来る。[2007-07-14]

build.xmlが正常なら、これでantビューにターゲット名の一覧が表示される。

もしbuild.xmlに異常があると、ターゲット一覧の代わりにエラー印が付き、マウスカーソルを持っていくとステータスバーにエラーメッセージが表示される。[2005-03-27]
taskdefで新しいタスクを定義している場合、そのタスクについても要素等をチェックしてくれるみたい。その結果エラーが出ることもある。（→例）

buildの実行

Eclipse2の場合、antビューに表示されているbuild.xml（又はさらにその下のターゲット）から実行したいものを選択し、右クリック→「実行」かをクリックする。
build.xmlにエラーがある場合、実行される代わりにエラーメッセージが表示される。（→例）[2005-03-27]

Eclipse3の場合、antビューに表示されているbuild.xml（又はさらにその下のターゲット）から実行したいものを選択し、右クリック→「実行(R)」→「Antビルド」かをクリックする。[2007-07-14]
右クリックのポップアップメニューだと、実行（あるいはデバッグ）の下に「Antビルド Alt+Shift+X,Q」と「Antビルド...」と「外部ツール」の3種類のメニューがある。

実行オプションの指定

antの実行時オプションは、設定ダイアログで指定する。[2007-08-16]
例えば「-verbose」オプションを指定する場合、設定ダイアログの「メイン」タブを選択し、「引数(A)」に「-verbose」を記述する。
「JRE」タブの「VM引数(G)」には、（antはjavaコマンドで実行されるので）antを実行する際のJavaVMの引数を指定することが出来る。[2008-06-21]
例えば「-Xms512m -Xmx512m」とか。

クラスパス（「-lib」オプション）を指定するには、「クラスパス」タブを選択し、追加ボタンを押してライブラリーやjarファイルを指定する。[2007-11-18]
ボタンが押せない状態（使用不可状態）になっている場合は、「クラスパス(L)」内の「Antホーム」をクリック（選択）すると押せるようになる。

buildのエラー

• 1つまたは複数のクラス"org.apache.tools.ant.BuildException"が見つかりませんでした。Antクラスパスを確認して下さい。
  （Eclipse2）antのクラスパスが変。[2005-07-23]
  ツールバーの「ウィンドウ(W)」→「設定(P)」で設定ダイアログを開き、左ペインで「Ant」→「ランタイム」を選ぶ。
  右ペインで「クラスパス(L)」を選び、「JARの追加(J)」をクリックする。
  〜/eclipse/plugins/org.apache.ant_1.5.3/ant.jar
  〜/eclipse/plugins/org.apache.ant_1.5.3/optional.jar
  （eclipseをインストールした場所を指す）
  自分は eclipseをディレクトリごと移動したので、パスがずれてしまった為にこのエラーが発生した(苦笑)

native2asciiのエラー

Eclipse2でnative2asciiタスクを使う場合、設定をしておかないとエラーが出て実行できないことがある。

• BUILD FAILED: java.lang.NoClassDefFoundError: sun/tools/native2ascii/Main
  antのクラスパスにnative2asciiが入っていない。
  ツールバーの「ウィンドウ(W)」→「設定(P)」で設定ダイアログを開き、左ペインで「Ant」→「ランタイム」を選ぶ。
  右ペインで「クラスパス(L)」を選び、「JARの追加(J)」をクリックする。
  開いたダイアログで「ファイル名」に「%JAVA_HOME%\lib\tools.jar」を入力して「開く」。
  これでランタイムクラスパスにtools.jarが追加され、native2asciiが実行できるようになる。
  　
• BUILD FAILED: java.lang.UnsupportedClassVersionError: sun/tools/native2ascii/Main (Unsupported major.minor version 48.0)
  実行しようとしているnative2asciiのMainクラスはバージョン48.0（jre1.4）用にコンパイルされているのだが、実行するjava（JavaVM）の対応バージョンが48.0より古い（jre1.3等）ので実行できない。[/2007-05-15]
  Eclipse2でantを実行する際は環境変数Pathを見ているらしいので、「%JAVA_HOME%\bin」をPathの先頭にもってくれば解消する。もちろん、JAVA_HOMEの所にあるjavaコマンドが新しいバージョンでなきゃダメだろーけど。
  後からOracleをインストールすると このエラーになったりすることがある。 インストーラーが環境変数PATHを書き換えているから。

クラスパスへのライブラリーの追加

Antのタスクの中には、jspcやftp・scpの様に、タスクとしてのクラスは用意されていても、実行時には他のライブラリー（jarファイル）が必要となるものもある。[2008-12-02]
→ライブラリ依存関係 …必要となる外部ライブラリー

EclipseのAnt実行時にそのjarファイルを参照する為に、以下のような設定が必要。

1. Eclipseのメニューバーの「ウィンドウ(W)」→「設定(P)」で設定ダイアログを開く。
2. 左ツリーから「Ant」⇒「ランタイム」を選択する。
3. 右側の「クラスパス(L)」タブを選択する。
4. 「グローバル項目」を選択する。
5. 「外部JARの追加(X)」ボタンを押下し、jarファイルを指定する。