blob: 3a69c070f66230b619e7fb324db0b2f18cae5703 [file] [log] [blame]
//
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the License for the
// specific language governing permissions and limitations
// under the License.
//
= NetBeans プロジェクトサンプルモジュールのチュートリアル
:jbake-type: platform_tutorial
:jbake-tags: tutorials
:jbake-status: published
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:icons: font
:experimental:
:description: NetBeans プロジェクトサンプルモジュールのチュートリアル - Apache NetBeans
:keywords: Apache NetBeans Platform, Platform Tutorials, NetBeans プロジェクトサンプルモジュールのチュートリアル
翻訳 : link:http://blogs.oracle.com/roller/page/katakai[片貝正紀] , 2006/7/10, レビュー/保守: link:http://ja.netbeans.org/index.html[NetBeans 日本語サイト]
link:mailto:dev@netbeans.apache.org?subject=Feedback:%20NetBeans%20IDE%20Project%20Sample%20Module%20Tutorial[フィードバック]
このチュートリアルではサンプルプロジェクトを含むモジュールを作成する手順を説明します。サンプルプロジェクトの共有はそれらを含むモジュールをインストールすれば簡単です。NetBeans IDE 5.0 では他の人と共有できるバイナリを作成することができます。アップデートセンター経由でインストールできます。IDE にそのモジュールをインストールすれば、新規プロジェクトウィザードでサンプルプロジェクトが利用可能になります。
このチュートリアルでは以下のことを説明します:
* <<installing,ソフトウェアのインストール>>
* <<creatingthemoduleproject,モジュールプロジェクトの作成>>
* <<creatingandgettingtoknowthemainfiles,サンプルアプリケーションの構築>>
* <<building,モジュールの構築とインストール>>
*注意:* サンプルプロジェクトが他の外部 JAR ファイルと Javadoc に依存する場合は、サンプルプロジェクトを含むモジュールにそれらを含むことができます。これをするのはとても簡単です。詳細は link:nbm-projecttemplates_ja.html[NetBeans プロジェクトテンプレートモジュールのチュートリアル] を参照してください。
このチュートリアルはソフトウェアがインストールできれば 20 分程度で完了します。
モジュール開発に関する詳細は NetBeans サイトの link:https://netbeans.apache.org/platform/index.html[NetBeans 開発プロジェクトホーム] を参照してください。わからないところがあれば link:http://wiki.netbeans.org/wiki/view/NetBeansDeveloperFAQ[NetBeans 開発者 FAQ] を参照してください。またこのページの「フィードバック」リンクを使ってください。
== ソフトウェアのインストール
まずはじめにコンピュータにソフトウェアをインストールします:
* NetBeans IDE 5.0 ( link:https://netbeans.apache.org/download/index.html[ダウンロード])
* Java Standard Development Kit (JDK) バージョン 1.4.2 ( link:https://www.oracle.com/technetwork/java/javase/downloads/index.html[ダウンロード]) または 5.0 ( link:https://www.oracle.com/technetwork/java/javase/downloads/index.html[ダウンロード])
== モジュールプロジェクトの作成
[start=1]
1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択してください。「カテゴリ」で「NetBeans プラグインモジュール」を選択します。「プロジェクト」では「モジュールプロジェクト」を選択し「次へ」ボタンをクリックします。
[start=2]
1. 「名前と場所」パネルでは「プロジェクト名」に「 ``AdditionalSamples`` 」と入力します。「プロジェクトの場所」は適当なコンピューター上のディレクトリを指定します。たとえば ``c:\mymodules`` などです。「スタンドアロンモジュール」のラジオボタンはそのままにし「主プロジェクトとして設定」チェックボックスを選択します。パネルは次のようになります:
image::images/mysample_proj-name-and-location-panel_ja.png[]
「次へ」をクリックします。
[start=3]
1. 「基本モジュール構成」パネルでは「コード名ベース」で ``yourorghere`` ``myorg`` に置き換え、 ``org.myorg.additionalsamples`` にします。デフォルトの「モジュール表示名」に空白を挿入し ``Additional Samples`` にします。「地域対応のバンドル」と「XML レイヤー」はそのままにし ``org/myorg/additionalsamples`` にこれらのファイルが保存されるようにします。パネルはこのようになります:
image::images/mysample_proj-basic-module-configuration-panel_ja.png[]
[start=4]
1. 「完了」ボタンをクリックします。
IDE ``Additional Samples`` プロジェクトを作成します。プロジェクトは必要なすべてのソースやメタデータ、たとえばプロジェクトの構築スクリプトなどを含んでいます。プロジェクトは IDE 上で開かれます。「プロジェクト」ウィンドウ(Ctrl-1) で理論的な構成を表示できます。また「ファイル」ウィンドウ(Ctrl-2)ではファイル構造を表示できます。たとえば「プロジェクト」ウィンドウではこのようになります:
image::images/mysample_initial-projects-window_ja.png[]
これらのファイルの基本的な説明は link:quickstart-nbm_ja.html[プラグインモジュールクイックスタートガイド] を参照してください。
== サンプルアプリケーションの構築
[start=1]
1. プロジェクトノードで右クリックして「新規」>「ファイル/フォルダ」を選択します。「カテゴリ」で「NetBeans モジュール開発」を選択します。「プロジェクト」で「プロジェクトテンプレート」を選択します。「次へ」をクリックします。
[start=2]
1. 「プロジェクトを選択」パネルでは次のようにサンプルとしてバンドルするプロジェクトを次のように選択します。
image::images/mysample_select-project-panel_ja.png[]
プロジェクトを作成するには link:https://netbeans.org/kb/50/quickstart-webapps_ja.html[NetBeans IDE 5.0 クイックスタートガイド (Web アプリケーション)] を参照できます。あるいは link:http://www.netbeans.org/files/documents/4/526/HelloWeb.zip[ここ] からダウンロードすることができます。また独自のプロジェクトを使うことができます。
「次へ」をクリックします。
[start=3]
1. 「名前と場所」パネルでは「テンプレート名」に「 ``MyHelloWorldSample`` 」と入力し、「表示名」には「 ``Hello World Sample`` 」と入力します。「カテゴリ」ドロップダウンリストからは次のように「サンプル | Web」を選択します。
image::images/mysample_name-and-location-panel_ja.png[]
[start=4]
1. 「完了」ボタンをクリックします。
IDE は次のことを行います:
* プロジェクトを含む ZIP ファイルを作成する
* サンプルを作成するための新規プロジェクトウィザードで使われる Java パネルと反復子を作成する
* 新規プロジェクトウィザードの説明を表示する HTML を提供する
* XML レイヤーファイルにサンプルを登録する
* ローカライズ用の文字を ``bundle.properties`` ファイルに追加する
これで「プロジェクト」ウィンドウはこのようになります:
image::images/mysample_final-projects-window_ja.png[]
== モジュールの構築とインストール
IDE はモジュールの構築およびインストールに Ant 構築スクリプトを使用します。構築スクリプトはプロジェクトの作成時に作成されます。
=== NetBeans モジュールのインストール
* 「プロジェクト」ウィンドウで ``Additional Samples`` プロジェクトを右クリックし「ターゲットプラットフォームでのインストール/再読み込み」を選びます。
モジュールが構築されターゲット IDE あるいはプラットフォームにインストールされます。ターゲット IDE またはプラットフォームが起動し新規モジュールを試すことができます。デフォルトのターゲットプラットフォームとは IDE の現在のインスタンスで使用しているインストールです。モジュールを実行すると IDE のユーザーディレクトリとは別のテストユーザーディレクトリで実行されます。
=== NetBeans モジュールの使用
[start=1]
1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択してください。
新規プロジェクトウィザードが開き新しいプロジェクトサンプルが表示されます:
image::images/mysample_new-project-wizard_ja.png[]
[start=2]
1. 新しいプロジェクトサンプルを選択し「次へ」ボタンをクリックします。ウィザードパネルが表示されます:
image::images/mysample_new-project-wizard2_ja.png[]
「プロジェクト名」に名前を入力します。
[start=3]
1. 「完了」ボタンをクリックします。IDE は新しく作成されたサンプルプロジェクトを開き表示します。
=== 共有可能なモジュールバイナリの作成
[start=1]
1. 「プロジェクト」ウィンドウで ``Additional Samples`` プロジェクトを右クリックし、「NBM を作成」を選択します。
NBM ファイルが作成されます。「ファイル」ウィンドウ (Ctrl-2) で確認できます:
image::images/mysample_shareable-nbm_ja.png[]
[start=2]
1. メールなどで送付することにより他の人に配布、共有できます。
== 次のステップ
NetBeans モジュールの開発と作成の詳細は次のリソースを参照してください:
* link:https://netbeans.apache.org/platform/index.html[プラグイン開発者リソース]
* link:https://bits.netbeans.org/dev/javadoc/[NetBeans API リスト (現行の開発バージョン)]
* link:http://apisupport.netbeans.org/new-apisupport.html[新規 API サポートの提案]
* link:https://netbeans.apache.org/tutorials/index_ja.html[その他のプラグインモジュールチュートリアル]
== バージョン
詳細な更新履歴は link:nbm-projectsamples_ja.html[原文の英文] をご覧下さい。このファイルはリビジョン 1.27 を翻訳しています。