NetBeans プロジェクトサンプルモジュールのチュートリアル

翻訳 : 片貝正紀 , 2006/7/10, レビュー/保守: NetBeans 日本語サイト

このチュートリアルではサンプルプロジェクトを含むモジュールを作成する手順を説明します。サンプルプロジェクトの共有はそれらを含むモジュールをインストールすれば簡単です。NetBeans IDE 5.0 では他の人と共有できるバイナリを作成することができます。アップデートセンター経由でインストールできます。IDE にそのモジュールをインストールすれば、新規プロジェクトウィザードでサンプルプロジェクトが利用可能になります。

このチュートリアルでは以下のことを説明します:

ソフトウェアのインストール
モジュールプロジェクトの作成
サンプルアプリケーションの構築
モジュールの構築とインストール

注意: サンプルプロジェクトが他の外部 JAR ファイルと Javadoc に依存する場合は、サンプルプロジェクトを含むモジュールにそれらを含むことができます。これをするのはとても簡単です。詳細は NetBeans プロジェクトテンプレートモジュールのチュートリアルを参照してください。

このチュートリアルはソフトウェアがインストールできれば 20 分程度で完了します。

モジュール開発に関する詳細は NetBeans サイトの NetBeans 開発プロジェクトホームを参照してください。わからないところがあれば NetBeans 開発者 FAQ を参照してください。またこのページの「フィードバック」リンクを使ってください。

ソフトウェアのインストール

まずはじめにコンピュータにソフトウェアをインストールします:

NetBeans IDE 5.0 (ダウンロード)
Java Standard Development Kit (JDK) バージョン 1.4.2 (ダウンロード) または 5.0 (ダウンロード)

モジュールプロジェクトの作成

「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択してください。「カテゴリ」で「NetBeans プラグインモジュール」を選択します。「プロジェクト」では「モジュールプロジェクト」を選択し「次へ」ボタンをクリックします。

「名前と場所」パネルでは「プロジェクト名」に「AdditionalSamples」と入力します。「プロジェクトの場所」は適当なコンピューター上のディレクトリを指定します。たとえば c:\mymodules などです。「スタンドアロンモジュール」のラジオボタンはそのままにし「主プロジェクトとして設定」チェックボックスを選択します。パネルは次のようになります:

ウィザードのステップ１

「次へ」をクリックします。

「基本モジュール構成」パネルでは「コード名ベース」で yourorghere を myorg に置き換え、org.myorg.additionalsamples にします。デフォルトの「モジュール表示名」に空白を挿入し Additional Samples にします。「地域対応のバンドル」と「XML レイヤー」はそのままにし org/myorg/additionalsamples にこれらのファイルが保存されるようにします。パネルはこのようになります:

ウィザードのステップ2

「完了」ボタンをクリックします。

IDE は Additional Samples プロジェクトを作成します。プロジェクトは必要なすべてのソースやメタデータ、たとえばプロジェクトの構築スクリプトなどを含んでいます。プロジェクトは IDE 上で開かれます。「プロジェクト」ウィンドウ(Ctrl-1) で理論的な構成を表示できます。また「ファイル」ウィンドウ(Ctrl-2)ではファイル構造を表示できます。たとえば「プロジェクト」ウィンドウではこのようになります:

初期の「プロジェクト」ウィンドウ

これらのファイルの基本的な説明はプラグインモジュールクイックスタートガイドを参照してください。

サンプルアプリケーションの構築

プロジェクトノードで右クリックして「新規」>「ファイル/フォルダ」を選択します。「カテゴリ」で「NetBeans モジュール開発」を選択します。「プロジェクト」で「プロジェクトテンプレート」を選択します。「次へ」をクリックします。

「プロジェクトを選択」パネルでは次のようにサンプルとしてバンドルするプロジェクトを次のように選択します。

プロジェクトを選択パネル。

プロジェクトを作成するには NetBeans IDE 5.0 クイックスタートガイド (Web アプリケーション) を参照できます。あるいはここからダウンロードすることができます。また独自のプロジェクトを使うことができます。

「次へ」をクリックします。

「名前と場所」パネルでは「テンプレート名」に「MyHelloWorldSample」と入力し、「表示名」には「Hello World Sample」と入力します。「カテゴリ」ドロップダウンリストからは次のように「サンプル | Web」を選択します。

初期の「プロジェクト」ウィンドウ

「完了」ボタンをクリックします。

IDE は次のことを行います:

プロジェクトを含む ZIP ファイルを作成する
サンプルを作成するための新規プロジェクトウィザードで使われる Java パネルと反復子を作成する
新規プロジェクトウィザードの説明を表示する HTML を提供する
XML レイヤーファイルにサンプルを登録する
ローカライズ用の文字を bundle.properties ファイルに追加する

これで「プロジェクト」ウィンドウはこのようになります:

初期の「プロジェクト」ウィンドウ

モジュールの構築とインストール

IDE はモジュールの構築およびインストールに Ant 構築スクリプトを使用します。構築スクリプトはプロジェクトの作成時に作成されます。

NetBeans モジュールのインストール

「プロジェクト」ウィンドウで Additional Samples プロジェクトを右クリックし「ターゲットプラットフォームでのインストール/再読み込み」を選びます。
モジュールが構築されターゲット IDE あるいはプラットフォームにインストールされます。ターゲット IDE またはプラットフォームが起動し新規モジュールを試すことができます。デフォルトのターゲットプラットフォームとは IDE の現在のインスタンスで使用しているインストールです。モジュールを実行すると IDE のユーザーディレクトリとは別のテストユーザーディレクトリで実行されます。

NetBeans モジュールの使用

「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択してください。
新規プロジェクトウィザードが開き新しいプロジェクトサンプルが表示されます:
新しいプロジェクトサンプルを選択し「次へ」ボタンをクリックします。ウィザードパネルが表示されます:

「プロジェクト名」に名前を入力します。
「完了」ボタンをクリックします。IDE は新しく作成されたサンプルプロジェクトを開き表示します。