ここでは、プロジェクトの開発に取り組むために IDE を設定する場合の基本事項について説明しています。プロジェクトの内容およびプロパティーの管理作業は、「プロジェクト」ウィンドウを中心に行います。プロジェクトの設定で一般的な作業としては、プロジェクトの作成、プロジェクトにおけるターゲット JDK の設定、プロジェクトからリソースライブラリを使用できるようにプロジェクトのプロパティーを設定することなどがあります。

ここで取り上げる内容は次のとおりです。

• IDE の基礎概念
• プロジェクト
• Ant
• プロジェクトの作成
• 主プロジェクトの設定
• プロジェクトのインポート
• プロジェクトにおけるターゲット JDK の設定
• プロジェクトのクラスパスの管理
• プロジェクト間の依存関係の管理
• 自由形式プロジェクトの設定
• Ant スクリプトの編集と実行
• 自由形式プロジェクトのクラスパスの管理
• プロジェクトソースのクラスパスの指定
• カスタムタスクのクラスパスの指定

IDE の基礎概念

プロジェクトの設定を開始する前に、IDE の使用に関係する主な基礎概念を学んでおきましょう。

プロジェクト

IDE では、常時プロジェクトの内部で作業をします。IDE のプロジェクトは、Java ソースファイルとクラスパス上に存在するもの、およびプロジェクトの構築、実行方法などの関連情報をまとめたものです。プロジェクトを構築するための IDE 生成の Ant スクリプトを使用する標準プロジェクトや、既存の Ant スクリプトに基づく自由形式プロジェクトを作成することができます。IDE は、構築および実行オプションの設定を含む Ant 構築スクリプトやプロパティーファイル、Ant ターゲットを IDE コマンドにマッピングした project.xml ファイルなどを含むプロジェクトフォルダにプロジェクト情報を保存します。

注: IDE では、デフォルトでソースディレクトリがプロジェクトフォルダに配置されますが、ソースディレクトリがプロジェクトフォルダにある必要はありません。

次の表は、標準プロジェクトと自由形式プロジェクトの主な違いをまとめています。

標準プロジェクト	自由形式プロジェクト
NetBeans 生成の Ant 構築スクリプトを使用して、アプリケーションを構築、実行、生成部の削除、テスト、デバッグを行います。	既存の Ant スクリプト内のターゲットを使用して、アプリケーションの構築、実行、生成物の削除、テスト、デバッグを行います。Ant スクリプトに、これらの機能のターゲットが含まれていない場合、その機能は使用できません。Ant スクリプトまたは補助的な Ant スクリプトで、そうした機能を実現するターゲットを作成することができます。
いくつかの標準 IDE プロジェクト (Java アプリケーション、Java クラスライブラリ、Web アプリケーション、エンタープライズアプリケーション、および EJB モジュール) は、1 つだけのソースフォルダとともに作成さます。あとから複数のソースフォルダを追加することができます。 既存のソースを使用する標準 IDE プロジェクト (Java アプリケーション、Web アプリケーション、エンタープライズアプリケーション、および EJB モジュール) は、ソースフォルダ数の制限がありません。プロジェクトを作成したあと、ソースフォルダを追加したり、削除したりできます。また、ほかの NetBeans プロジェクトとの依存関係を作成することもできます。 ソースフォルダごとに別のプロジェクトを作成し、プロジェクト間の依存関係を作成することで、標準プロジェクトで複数のソースフォルダを使用することもできます。	プロジェクトのソースフォルダ数の制限はありません。プロジェクトを作成したあと、ソースフォルダを追加したり、削除したりできます。また、ほかの NetBeans プロジェクトとの依存関係を作成することもできます。
プロジェクトのクラスパスは、プロジェクトに追加するライブラリによって制御します。「プロジェクトプロパティー」ダイアログの「ライブラリ」区画にライブラリを追加するか、または「プロジェクト」ウィンドウのプロジェクトの「ライブラリ」ノードを右クリックして、「ライブラリを追加」を選択します。あらゆる変更が、ただちに IDE 生成の Ant スクリプトに記録されます。	プロジェクトのクラスパスは、Ant スクリプトで制御します。「プロジェクトプロパティー」ダイアログの「クラスパス」ページのクラスパスの設定は、コード補完およびリファクタリングに使用できるクラスを IDE に伝えるだけです。Ant スクリプト内のクラスパス設定を変更した場合は、プロジェクトのプロパティーの設定を更新する必要があります。
構築プロセスは、「プロジェクトプロパティー」ダイアログで基本的なオプションを設定するか、NetBeans 生成の Ant スクリプト内のターゲットを書き換えることによってカスタマイズします。	コンパイル時および実行時オプションはすべて、Ant 構築スクリプトで設定します。
プロジェクトで JAR ファイル (J2SE プロジェクトの場合) または WAR ファイル (Web プロジェクトの場合) が 1 つ作成されます。	プロジェクトの Ant スクリプトに指定されている個数の出力ファイルが生成されます。

IDE には、標準プロジェクト用として次のテンプレートが付属しています。

Java アプリケーションアイコン	Java アプリケーション。主クラスを含むスケルトン J2SE プロジェクトを作成するためのテンプレート。
Java アプリケーションアイコン	Java クラスライブラリ。主クラスを含まないスケルトン Java クラスを作成するためのテンプレート。
Java アプリケーションアイコン	既存のソースを使用する Java プロジェクト。既存の Java ソースに基づいて J2SE プロジェクトを作成するためのテンプレート。
Web アプリケーションアイコン	Web アプリケーション。スケルトン Web アプリケーションを作成するためのテンプレート。
Web アプリケーションアイコン	既存のソースを使用する Web プロジェクト。既存の Web および Java ソースに基づいて Web プロジェクトを作成するためのテンプレート。
エンタープライズアプリケーションアイコン	エンタープライズアプリケーション。スケルトンのエンタープライズアプリケーションを作成するためのテンプレート。
エンタープライズアプリケーションアイコン	既存のソースを使用するエンタープライズアプリケーション。エンタープライズアプリケーションを標準 IDE プロジェクトにインポートするためのテンプレート。
EJB モジュールアイコン	EJB モジュール。エンタープライズ JavaBean モジュールを作成するためのテンプレート。
EJB モジュールアイコン	既存のソースを使用する EJB モジュール。エンタープライズ JavaBean モジュールを標準 IDE プロジェクトにインポートするためのテンプレート。

IDE には、自由形式プロジェクト用として次のテンプレートが付属しています。

自由形式プロジェクトアイコン	既存の Ant スクリプトを使用する Java プロジェクト。Ant 構築スクリプトがある既存の Java ソースに基づいて J2SE プロジェクトを作成するためのテンプレート。
自由形式プロジェクトアイコン	既存の Ant スクリプトを使用する Web プロジェクト。Ant 構築スクリプトがある既存の Web および Java ソースに基づいて Web アプリケーションを作成するためのテンプレート。
自由形式プロジェクトアイコン	既存の Ant スクリプトを使用する EJB モジュール。Ant 構築スクリプトを使用する IDE プロジェクトに EJB モジュールをインポートするためのテンプレート。

Ant

Apache Ant は、開発のための構築および実行環境を標準化し、自動化するための Java 準拠の構築ツールです。IDE のプロジェクトシステムは、Ant を直接の土台にして構築されています。「主プロジェクトを構築」や「主プロジェクトをデバッグ」などのプロジェクトコマンドはすべて、プロジェクトの Ant スクリプトでターゲットを呼び出します。このため、IDE とまったく同様に IDE の外部でプロジェクトを構築、実行できます。

IDE は、Ant を知らなくても使用できます。基本的なコンパイルオプションと実行時オプションはすべて「プロジェクトプロパティー」ダイアログに設定可能で、IDE が、その設定に基づいてプロジェクトの Ant スクリプトを自動的に更新します。Ant の知識がある場合は、標準プロジェクトの Ant スクリプトをカスタマイズしたり、プロジェクト用の独自の Ant スクリプトを作成したりできます。

Ant の上級者でも、Ant のマニュアルで確認しなければならない場合があります。IDE のヘルプシステムに Ant マニュアルを直接インストールすることができます。このためには、「NetBeans アップデートセンター」で、「Ant Documentation」モジュールをインストールします。アップデートセンターの使用方法の詳細は、「アップデートセンターからの新規モジュールのインストール」を参照してください。

Ant を学ぶためのリソースは、http://ant.apache.org/resources.html で紹介されています。

プロジェクトの作成

新しいプロジェクトを作成するには、「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「新規プロジェクト」ウィザードが表示されたら、プロジェクトに適切なテンプレートを選択し、ウィザードのメッセージに従います。

「新規プロジェクト」ウィザードの使用法については、次のマニュアルを参照してください。

• クイックスタートガイド
• クイックスタートガイド (Web アプリケーション)

プロジェクトの作成を終了すると、プロジェクトは IDE で開き、「プロパティー」ウィンドウにその論理構造、「ファイル」ウィンドウにそのファイル構造が表示されます。

• 「プロジェクト」ウィンドウは、プロジェクトのソースへの第一の入り口です。Java パッケージや Web ページといった重要なプロジェクトの内容の論理ビューを表示します。プロジェクトのノードを右クリックすることによって、プロジェクトを構築、実行、デバッグしたり、「プロジェクトプロパティー」ダイアログを開いたりするためのコマンドからなるコンテキストメニューにアクセスできます。「プロジェクト」ウィンドウは、「ウィンドウ」>「プロジェクト」(Ctrl-1) を選択することによって開くことができます。
• 「ファイル」ウィンドウは、「プロジェクト」ウィンドウでは表示されないファイルやフォルダなど、プロジェクトのディレクトリ構造を表示します。このウィンドウから、プロジェクトの構築スクリプトやプロパティーファイルなどのプロジェクトの構成ファイルを開いて編集することができます。コンパイル済みクラスや JAR ファイル、WAR ファイルなどの構築出力や生成された Javadoc ドキュメントを表示することもできます。「ファイル」ウィンドウは、「ウィンドウ」>「ファイル」(Ctrl-2) を選択することによって開くことができます。

「お気に入り」ウィンドウを使用して、ローカルコンピュータ上の任意の場所にアクセスすることもできます。このウィンドウは、プロジェクトディレクトリの外部にあるファイルやディレクトリにアクセスするのに便利です。「お気に入り」ウィンドウは、プロジェクトのクラスパスやメンバーに関する情報を持っていないため、「ファイルをコンパイル」などのプロジェクト関係のコマンドは「お気に入り」ウィンドウでは利用できません。「お気に入り」ウィンドウでクラスファイルをダブルクリックしてファイルを開くことができますが、そのファイルにはクラスパス情報が関連付けられていないため、ソースエディタでファイルを表示すると、コンパイルエラーが表示されることがあります。「お気に入り」ウィンドウを開くには、「ウィンドウ」>「お気に入り」(Ctrl-3) を選択します。

「プロジェクト」ウィンドウと「ファイル」ウィンドウ

主プロジェクトの設定

多数のソースフォルダからなる大規模なアプリケーションの開発では、コードを複数の独立したプロジェクトに分割するのが一般的です。一般にそれらプロジェクトの 1 つがアプリケーションの入り口になります。J2SE アプリケーションの場合はそのプロジェクトにアプリケーションの主クラスが含まれます。アプリケーションへの主なエントリポイントとなるプロジェクトを IDE に対して指定するには、そのプロジェクトを主プロジェクトとして設定します。主プロジェクトに関するコマンドは IDE で提供されています。たとえば「主プロジェクトを構築」コマンドを実行すると、主プロジェクトとその全必須プロジェクトの両方が構築され、そうすることによって、コンパイル済みクラスのすべてが最新に維持されるようにします。プロジェクトを主プロジェクトとして設定するには、「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「主プロジェクトとして設定」を選択します。ただし、主プロジェクトに指定できるプロジェクトは 1 つだけです。

プロジェクトのインポート

「新規プロジェクト」ウィザードで、プロジェクトテンプレートを使用して、プロジェクトを NetBeans にインポートし、プロジェクトの種類に基づいて NetBeans プロジェクトを作成できます。「新規プロジェクト」ウィザードで、プロジェクトの種類を選択したら、既存のソースを使用するプロジェクトテンプレートを選択するか、インポートするプロジェクトにすでに Ant スクリプトがある場合は、既存の Ant スクリプトを使用するテンプレートを選択します。ウィザードを進めて、インポートするソースを探して指定し、プロジェクトを作成します。選択するテンプレートによって、既存のソースで標準プロジェクトが作成されるか、または、既存のソースと Ant スクリプトを使用して、自由形式プロジェクトが作成されます。

IDE へのソースコードのインポートについては、次のドキュメントで手順が説明されています。

• NetBeans 5.5: 既存の Java ソースコードのインポート
• 他社製のプロジェクトの自由形式プロジェクトとしてのインポート (英語)

プロジェクトにおけるターゲット JDK の設定

デフォルトでは、IDE は、コンパイル、実行、およびデバック用のデフォルトの Java プラットフォームとして IDE そのものの実行に使用されている J2SE プラットフォーム (JDK) のバージョンを使用します。現在使用している JDK のバージョンを確認するには、「ヘルプ」>「製品について」を選択し、「詳細」タブをクリックします。「Java」フィールドに JDK のバージョンが表示されます。

コマンド行または
IDE-HOME/etc/netbeans.conf ファイル内で、--jdkhome jdk-home-dir スイッチを付けて IDE を起動することによって、別のバージョンの JDK を使用して IDE を実行することもできます。詳細は、「IDE 起動スイッチの設定」を参照してください。

IDE では、複数の Java プラットフォームを登録し、それぞれのプラットフォームに Javadoc およびソースコードを接続することができます。標準プロジェクト用のターゲット JDK を切り換えると、処理は次のように変更されます。

• コード補完用に新しいターゲット JDK のクラスが提供されます。
• ターゲット JDK のソースコードおよび Javadoc ドキュメントを表示できます (使用可能な場合)。
• アプリケーションのコンパイルおよび実行に、ターゲット JDK の実行可能ファイル (javac および java) が使用されます。
• ターゲット JDK のライブラリを基にソースコードがコンパイルされます。

次の方法で、プロジェクトのターゲット JDK を切り替えることができます。

• 標準プロジェクト。標準プロジェクトの場合は、「プロジェクトプロパティー」ダイアログの「ライブラリ」パネルでターゲット JDK を切り替えることができます。
• 自由形式プロジェクト。自由形式プロジェクトの場合は、Ant スクリプトそのものにターゲット JDK を設定し、「プロジェクトプロパティー」ダイアログの「ソース」ページでソースレベルを指定する必要があります。「プロジェクトプロパティー」ダイアログでソースレベルを設定します。これは、IDE が Javadoc およびプロジェクトのソースに使用する JDK を判断するために使用します。IDE は指定されたソースレベルに対応する JDK を見つけられない場合、IDE のデフォルトの JDK を使用します。

新しい Java プラットフォームを登録するには、メインメニューから「ツール」>「Java プラットフォームマネージャー」を選択し、Java プラットフォームを含むディレクトリとデバッグに必要なソースおよび Javadoc を指定します。

Java プラットフォームマネージャー

プロジェクトのクラスパスの管理

プロジェクトのクラスパスに一群のクラスファイルを追加するということは、コンパイルおよび実行中にプロジェクトがアクセスすべきクラスを IDE に知らせることです。IDE はまた、クラスパスの設定を使用して、コード補完やコンパイルエラーの自動強調表示、リファクタリングを行えるようにします。既存のプロジェクトのクラスパス宣言は、「プロジェクトプロパティー」ダイアログで編集できます。

• 標準プロジェクト。標準プロジェクトの場合、IDE は、プロジェクトのコンパイルと実行用にそれぞれ独立したパスを保持します (J2SE アプリケーションの場合は、その他 JUnit テストのコンパイルと実行用のパスも保持)。プロジェクトのコンパイル時に、クラスパスのすべてがプロジェクトの実行時クラスパスに自動的に追加されます。「プロジェクトプロパティー」ダイアログの「コンパイル」タブで、プロジェクトのコンパイル時クラスパスに JAR ファイルやライブラリ、依存プロジェクトを追加できます。「プロジェクト」ウィンドウの「ライブラリ」ノードを右クリックして、プロジェクトに JAR ファイル、ライブラリ、プロジェクトを追加することもできます。
• 自由形式プロジェクト。自由形式プロジェクトの場合は、Ant スクリプトで、すべてのソースフォルダのクラスパスを管理します。自由形式プロジェクトを設定する場合、「新規プロジェクト」ウィザードでクラスパスを宣言します。自由形式プロジェクトのクラスパス設定は、コード補完およびリファクタリングに使用できるクラスを IDE に知らせるだけです。自由形式プロジェクトのクラスパスは、「プロジェクトプロパティー」ダイアログの「Java ソースのクラスパス」パネルを使用して宣言できます。詳細は、あとに説明する「自由形式プロジェクトのクラスパスの管理」を参照してください。

「ライブラリマネージャー」で Javadoc およびソースファイルが JAR ファイルに接続された場合、IDE は、プロジェクトのクラスパスに JAR ファイルを登録するときに自動的にその Javadoc およびソースファイルをプロジェクトに追加します。これだけの設定で、クラスを表示してそのクラスの Javadoc ページを参照することもできます。

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

プロジェクト間の依存関係の管理

各ソースが別々の標準プロジェクトに所属する場合には、それらのプロジェクト間でクラスパスの依存関係を設定する必要があります。一般には、主プロジェクト 1 つ (J2SE プロジェクトの場合はプロジェクトの主クラスを含むプロジェクト) と、複数の必須プロジェクトを作成します。必須プロジェクトとは、別のプロジェクトのクラスパスに追加されているプロジェクトです。プロジェクトの生成物を削除して構築すると、その必須プロジェクトの生成物も削除され、構築されます。必須プロジェクトの Javadoc とソースは、受け側のプロジェクトからも利用できるようになります。

「プロジェクト」ウィンドウの「ライブラリ」ノードを右クリックして、プロジェクトに必要なプロジェクトを追加するか、「プロジェクトプロパティー」ダイアログの「コンパイル」タブでそれらを指定して追加できます。必須プロジェクトを追加する場合、クラスパスに追加する JAR ファイルを生成するプロジェクトのフォルダを選択します (ファイル選択ダイアログでは IDE プロジェクトフォルダのアイコン によって表示されます)。「プロジェクトプロパティー」ダイアログでプロジェクトを追加する場合は、「クラスパス上のプロジェクトを構築」チェックボックスが選択されていることを確認します。

標準プロジェクトのクラスパスに自由形式プロジェクトを追加する場合は、そのプロジェクトの JAR ファイルを標準プロジェクトのクラスパスに追加する必要があります。追加するには、自由形式プロジェクトの「プロジェクトプロパティー」ダイアログの、「出力」パネルで自由形式プロジェクトの出力ファイルをすべて宣言する必要があります。

自由形式プロジェクトの設定

自由形式プロジェクトでは、既存の Ant スクリプト内のターゲットを使用して、アプリケーションの構築、実行、生成物の削除、テスト、デバッグを行います。Ant スクリプトに、これらの機能のターゲットが含まれていない場合、その機能は使用できません。そうした機能を実現するには、Ant スクリプトまたは補助的な Ant スクリプトで、ターゲットを作成します。

自由形式プロジェクトの設定の詳細については、次の記事を参照してください。

• 高度な自由形式プロジェクトの設定

Ant スクリプトの編集と実行

IDE は自動的に Ant スクリプトを認識し、通常の XML ファイルではなく、Ant スクリプトのノード () として表示します。Ant スクリプトは、「プロジェクト」ウィンドウや「ファイル」ウィンドウ、「お気に入り」ウィンドウで右クリックすることによって、ポップアップメニューのコマンドを利用できます。Ant スクリプトのノードを展開し、そのスクリプトのターゲットを表すサブノードをアルファベット順一覧で表示することもできます。これらサブノードにも、すべてコンテキストメニューが用意されています。

「プロジェクト」、「ファイル」、および「お気に入り」の各ウィンドウでは、Ant スクリプトのサブノードに次のようなフラグが付いています。

強調された Ant ターゲット	強調された Ant ターゲット。このフラグの付いたターゲットには、ツールチップとして表示される説明属性があります。ターゲットの説明属性は、ソースエディタで定義できます。
標準 Ant ターゲット	標準 Ant ターゲット。説明属性のないターゲット。

Ant スクリプトを編集する唯一の方法はソースエディタです。Ant スクリプトの任意のサブノードをダブルクリックすると、ソースエディタ内のそのターゲットの場所にジャンプします。Ant スクリプトの編集には、通常の XML 検索ツールや選択ツール、キーボードショートカットをすべて使用できます。IDE には、標準的なすべての Ant タスクに対するコード補完機能もあります。

コマンド行から実行するターゲットを作成する場合は、ターゲットに説明属性を定義してください。そうしておけば、ターゲット名あるいはターゲットの働きを思い出せなくても、コマンド行から ant -projecthelp <script> コマンドを実行することによって、説明を表示することができます。このコマンドでは、Ant は、説明属性を持つターゲットだけを説明とともに一覧表示します。ターゲットを強調する、しないで分けることは、よく使うターゲットとそうでないターゲットを区別する便利な手段になります。Ant 構築スクリプトに多数のターゲットがある場合は特に便利です。

「プロジェクト」、「ファイル」、および「お気に入り」の各ウィンドウのサブノードのラベルのフォントスタイルには、次の違いがあります。

• 標準
  現在の Ant スクリプトに定義されているターゲット。
• 斜体
  別の Ant スクリプトからインポートされるターゲット。
• グレー
  直接実行できない内部ターゲット。内部ターゲットの名前は "-" から始まります。
• 太字
  スクリプトのデフォルトのターゲット (デフォルトが存在する場合)。デフォルトターゲットは、名前などのほかのプロジェクト属性とともに、プロジェクトの属性として宣言します。この属性は、ソースエディタで定義できます。

別のスクリプトからインポートされるターゲットでも、インポート側のスクリプトで「オーバーライド」されるターゲットは、表示されません。オーバーライドするターゲットだけ表示されます。

「プロジェクト」や「ファイル」、あるいは「お気に入り」ウィンドウの Ant スクリプトのノードから Ant スクリプト内のターゲットを実行することができます。このためには、Ant スクリプトのノードを右クリックし、「ターゲット実行」サブメニューからターゲットを選択します。ターゲットは、アルファベット順にソートされています。表示されるのは、強調付きのターゲットだけです。説明属性で強調されていないターゲットを実行するには、「その他のターゲット」を選択します。内部ターゲットは単独で実行できないため、表示されません。

ターゲットの実行方法としては、Ant スクリプトのノードのコンテキストメニューを使わずにターゲットのノードを単に右クリックし、「ターゲット実行」を選択する方法もあります。

Ant ターゲットの実行

自由形式プロジェクトのクラスパスの管理

自由形式プロジェクトの場合は、Ant スクリプトで、すべてのソースフォルダのクラスパスを管理します。Ant でプロジェクトソースを使用できるようにするには、プロジェクトソースのクラスパスを指定する必要があります。カスタムタスクがある場合は、それらのタスクも Ant のクラスパスに追加する必要があります。

独自の Ant スクリプトを使用して、自由形式プロジェクトをコンパイル、実行、デバッグする方法の詳細については、次の記事を参照してください。

• NetBeans IDE 5.5: 既存の Java ソースコードのインポート
• 高度な自由形式プロジェクトの設定

プロジェクトソースのクラスパスの指定

自由形式プロジェクトでは、コード補完およびリファクタリングに使用できるクラスを IDE に知らせ、それらのプロジェクトソースのクラスパスを指定します。「プロジェクトプロパティー」ダイアログの「Java ソースのクラスパス」設定でクラスパスを指定します。この操作を実行するのは、IDE が Ant を実行する際に、デフォルトでは使用環境の CLASSPATH 変数を無視するためです。

「プロジェクトプロパティー」ダイアログに設定したクラスパス変数は、Ant スクリプトに指定されているプロジェクトの実際のクラスパスには影響を与えません。「プロジェクトプロパティー」ダイアログでクラスパスを宣言しても、ソースフォルダのコンパイルや実行時に使用されるクラスパスは変更されません。ただし、コード補完、エラーの強調表示、リファクタリングコマンド用に正しい情報を提供するために、プロジェクトクラスパス変数は、Ant スクリプトで使用するクラスパスに一致している必要があります。IDE は Ant を実行する際に、使用環境の CLASSPATH 変数を無視するため、構築スクリプトに明示的なクラスパスを設定する必要があります。一方のクラスパスを変更した場合は、もう一方のクラスパスも変更する必要があります。

カスタムタスクのクラスパスの指定

自由形式プロジェクトでは、構築スクリプトでカスタム Ant タスクを呼び出し、実行することができます。Ant スクリプトでカスタムタスクを使用するには、Ant スクリプトのクラスパスにそのタスクを含める必要があります。たとえば、コードを Jalopy でフォーマットするタスクを構築スクリプトに追加するとします。このためには、Jalopy JAR ファイルを Ant のクラスパスに追加する必要があります。

IDE で Ant のクラスパスにカスタムタスクを追加するには、次のいずれかを実行します。

• 構築スクリプト内で、タスクに対して明示的なクラスパスを指定する。これは、構築スクリプトを完全に移植可能にするため、Ant スクリプトで使用するカスタムタスクを含む JAR ファイルの場所を指定する推奨される方法です。タスクを作成し、そのタスクをコンパイルする命令、および構築ファイル内に JAR ファイルを生成する命令を組み込むことができます。これらのタスクを使用するには、クラスパスが含まれている長い形式の taskdef を組み込みます。こうしたタスクの単純な例を、次に示します。

<project name="test" default="all" basedir=".">
    <target name="init">
        <javac srcdir="tasksource" destdir="build/taskclasses"/>
        <jar jarfile="mytasks.jar">
            <fileset dir="build/taskclasses"/>
        </jar>
        <taskdef name="customtask" classname="com.mycom.MyCustomTask">
            <classpath>
                 <pathelement location="mytasks.jar"/>
            </classpath>
        </taskdef>
    </target>
</project>

この方法では、特別な準備をしなくてもスクリプトを使用できるという利点があります。このスクリプトは完全に独立しており、移植が可能です。この方法では、スクリプトがタスクを自動的にコンパイルするため、IDE に独自のタスクを簡単に作成することもできます。

構築スクリプトをより堅牢にするには、場所をハードコーディングするのではなく、プロパティーを使用してタスクに対するクラスパスを指定します。プロパティーは、構築スクリプト自身、または別の ant.properties ファイルに保存できます。指定したプロパティーの値を変更するだけで、スクリプト全体のクラスパス設定を変更できます。

• 「オプション」ウィンドウの Ant クラスパスプロパティーの設定。自分の構築スクリプト内ではクラスパスを宣言できない場合、または、変更ができない他社製の構築スクリプトを使用している場合は、IDE の「オプション」ウィンドウで、Ant のクラスパスにタスクを追加できます。

注: 「オプション」ウィンドウで、Ant クラスパスを変更した場合、IDE で Ant を実行すると、すべてのプロジェクトで、そのタスクが Ant のクラスパス上に置かれます。