プロジェクト・ビルダー Ant ビルド・ファイルの作成

プロジェクト・ビルダーがどのように動作するかを確認するため、 単一のソース・ファイル、および単一のクラス・ファイルから jar を作成する Ant ビルド・ファイルを持つシンプル・プロジェクトを作成します。 この例では Java を使用しますが、 プロジェクト・ビルダーは Java または Java 以外のすべてのプロジェクトに使用できることに注意してください。

  1. HW という名前の Java プロジェクトを作成します。
  2. main メソッドを持つ HelloWorld という名前の Java ソース・ファイルを作成します。
  3. main メソッドに単一の System.out.println() 文を記述して、選択したあいさつを出力します。
  4. 変更を保存します。
  5. projectBuilder.xml という名前のファイルを作成し、作成したファイル上で Ant エディターを開き、 次のコンテンツを入力して変更を保存します。
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="HW.makejar" default="makejar" basedir=".">
      <target name ="makejar" description="Create a jar for the HW project">
        <jar jarfile="HelloWorld.jar" includes="*.class" basedir="bin"/>
    	</target>
    </project>
    
  6. ナビゲーション・ビューで、HW プロジェクトを選択し、 このコンテキスト・メニューから「プロパティー」を選択します。
  7. プロジェクトのプロパティー・ダイアログで、「ビルダー」を選択し、 次に「新規...」をクリックします。
  8. 構成タイプの選択」ダイアログで、「Ant ビルド」を選択し、「OK」をクリックします。
  9. 外部ツール」ダイアログが表示されます。 名前を Makejar に設定します。「メイン」タブで、 「ビルド・ファイル」、「ワークスペースの参照...」の順にクリックし、 「ロケーション」を上で作成した projectBuilder.xml ビルド・ファイルに設定します。 次に「基底ディレクトリー」、「ワークスペースの参照...」 の順にクリックして、「基底ディレクトリー」を HW プロジェクトに設定します。

    「外部ツール」ダイアログの「メイン」タブ

  10. 更新」タブで、HelloWorld.jar が作成されたとき、 確実に Eclipse に表示されるようにします。 デフォルトではプロジェクト・ビルダーの実行終了時に更新が行われないため、 「完了時にリソースを更新」をチェックし、スコープ済み変数のリストで「選択されたリソースを含むプロジェクト」を選択します。 更新はコストのかかる操作となる可能性があるため、 一般的にはビルド・ファイルによる影響を受けるすべてのリソースを含む最小限のエンティティーを更新することをお勧めします。

    「外部ツール」ダイアログの「更新」タブ

  11. 「ターゲット」タブでは、このプロジェクト・ビルダーをいつ実行するか、および実行ターゲットを指定できます。 デフォルトでは、default ターゲットは、「"クリーン" の後」および「手動ビルド」を実行するように設定されています。 他のターゲットと他のトリガーも指定できます。自動ビルド中にプロジェクト・ビルダーを実行することは可能ですが、 パフォーマンスが懸念されるため、お勧めしません。ビルドの種類についてさらに詳しい情報は、ここにあります。

    「外部ツール」ダイアログの「ターゲット」タブ

  12. 変更を適用して、「OK」をクリックします。
  13. プロジェクトの「プロパティー」ダイアログに戻ると、 Makejar という名前のプロジェクト・ビルダーがデフォルト Java ビルダーの後に実行されるよう設定されていることが分かります。 「OK」をクリックしてプロジェクト・ビルダーを保存して、 ダイアログを閉じます。
    注: この例では意味を成しませんが、Java ビルダーの前に Ant ビルド・ファイルを実行するように順序を変更することができます。

    「プロジェクト・プロパティー」ダイアログ

Java ビルダーは内部 Eclipse Java コンパイラーを実行します。 このコンパイラーはソースのインデックスを作成するので、 検索、リファクタリングおよびその他の多くの機能を使用できます。 このため、プロジェクト・ビルダーを使用することで、内部 Eclipse Java コンパイラーを置き換えることはできません。 Java ビルダーを使用不可にしたり、定義したプロジェクト・ビルダーに対して Java ビルダーをいつ実行するかを制御することができます。

関連タスク
Ant ビルド・ファイルの作成
プロジェクト・ビルダー Ant ターゲット
Ant ビルド・ファイルの編集
Ant オプションの保存および再利用
Ant ビルド・ファイルの実行
プロジェクト・ビルダーとしての Ant ビルド・ファイル
プロジェクト・ビルダーの実行
外部ツール
非 Ant プロジェクト・ビルダー
スタンドアロン外部ツール