ビジュアルモバイルデザイナのカスタムコンポーネント: PIM (Personal Information Manager) アプリケーションの作成

ビジュアルモバイルデザイナ (VMD) は NetBeans Mobility に含まれるグラフィカルインタフェースで、コンポーネントのドラッグ&ドロップを使用することでモバイルアプリケーションをデザインできます。VMD を使用すると、IDE に含まれるコンポーネントまたは独自にデザインしたコンポーネントを使用して、アプリケーションフローを定義し、GUI をデザインできます。VMD には、リスト、警告、フォーム、画像など、アプリケーションの作成に使用できる標準のユーザーインタフェース (UI) コンポーネントが多数含まれます。また、待機画面、スプラッシュ画面、表項目など、より複雑な機能を簡単に作成できるカスタムコンポーネントも含まれます。

PIM ブラウザは、カレンダ、アドレス帳、タスクリストなどの標準的なモバイルデバイス機能への簡単なアクセスを提供するカスタムコンポーネントです。PIM ブラウザコンポーネントを使用して、モバイル Java アプリケーションから、ローカルに保存された個人情報データベースにアクセスできます。このコンポーネントでは PIM (Personal Information Management) API が使用されます。これは JSR-75 (PDA Optional Packages for the Java ME Platform) 仕様の一部です。JSR-75 は MIDP 2.0 仕様の一部ではないので、このコンポーネントはカスタムコンポーネントと定義され、JSR-75 対応のデバイスだけに使用できます。

このチュートリアルでは、JSR-75 対応デバイス用モバイルアプリケーションで PIM ブラウザコンポーネントを使用する方法を示します。デバイスの連絡先データベース、カレンダ、または To Do リストなどの内容の参照など、コンポーネントの基本機能を使用します。PIM ブラウザに加えて、スプラッシュ画面、テキストボックス、および警告の 3 つのコンポーネントを使用します。

目次

このページの内容は NetBeans IDE 6.9 以降が対象です

このチュートリアルに従うには、次に示すソフトウェアとリソースが必要です。

ソフトウェアまたはリソース 必須バージョン
NetBeans IDE と Java ME version 6.9 以降
Java Development Kit (JDK) version 6 および 7

NetBeans Mobility に習熟していない場合、次に進む前に「NetBeans Java ME MIDP 開発のクイックスタートガイド」から始めることをお勧めします。

サンプルアプリケーションのインストールと実行

始める前に、チュートリアルの最終結果を確認します。

次の手順で PIMBrowserExample アプリケーションをインストールします。

  1. PIMBrowserExample.zip をダウンロードします。
  2. ファイルを展開します。
  3. IDE で、「ファイル」>「プロジェクトを開く」を選択し、PIMBrowserExample プロジェクトの展開したファイルがあるフォルダを参照します。
  4. 「プロジェクトを開く」をクリックします。
    「プロジェクト」ウィンドウは次のようになります。
  5. PIM ブラウザの例を開いた「プロジェクト」ウィンドウ

  6. 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「プロジェクトを実行」を選択します (または F6 キーを押す)。アプリケーションが実行されると、エミュレータウィンドウが開き、デフォルトのデバイスエミュレータでアプリケーションが実行されるところが表示されます。
  7. 「エミュレータ」ウィンドウで「起動」の下のボタンをクリックします。
    エミュレータにスプラッシュ画面コンポーネントが表示されてから、次に示す PIM ブラウザが表示されます。
  8. サンプルの PIM ブラウザアプリケーションが表示された SDK 3.0 エミュレータ

  9. エミュレータの右上のボタンをクリックすると、次に示すようなメニュー項目が表示されます。

    メニュー項目が表示された SDK 3.0 エミュレータ

  10. 「Details」項目が選択された状態で、エミュレータの中央のボタンをクリックすると、連絡先の詳細が表示されます。
  11. サンプルの PIM ブラウザアプリケーションが表示された WTK 2.5 エミュレータ

  • 位置を移動するにはカーソルを上下に移動します。
  • 連絡先リストに戻るには「Back」の下のボタンをクリックします。
  • アプリケーションを終了するには、「Exit」の下のボタンをクリックします。

ページの先頭へ

「PIM ブラウザ」カスタムコンポーネントを使用したアプリケーションの作成

PIM ブラウザコンポーネントが実際に動作するところを確認できたので、最初に戻ってこのアプリケーションを作成します。アプリケーションを作成するには、次の手順を実行します。

  1. PIMBrowserExample プロジェクトを作成する
  2. プロジェクトにパッケージとビジュアル MIDlet を追加する
  3. プロジェクトにコンポーネントを追加する
  4. プロジェクトにコマンドを追加する
  5. コンポーネントを接続してアプリケーションフローを作成する
  6. Wireless Toolkit の連絡先データベースに連絡先を追加する
  7. プロジェクトを実行する

PIMBrowserExample プロジェクトの作成

  1. ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」から「Java ME」を選択します。「プロジェクト」で「モバイルアプリケーション」を選択して、「次へ」をクリックします。
  2. 「プロジェクト名」フィールドに PIMBrowserExample と入力します。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。以降、この例では、このディレクトリを $PROJECTHOME とします。
  3. 「Hello MIDlet を作成」チェックボックスの選択を解除します。「次へ」をクリックします。
  4. 「エミュレータプラットフォーム」は、「Java (TM) Platform Micro Edition SDK 3.0」を選択したままにしておきます。「次へ」をクリックします。
  5. 「その他の構成の選択」で、「完了」をクリックします。
  6. 注: このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。

プロジェクトへのパッケージとビジュアル MIDlet の追加

  1. 「プロジェクト」ビューで PIMBrowserExample プロジェクトを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」から「Java」を選択します。「ファイルの種類」として「Java パッケージ」を選択します。「次へ」をクリックします。
  2. 「パッケージ名」フィールドに pimbrowserexample と入力します。「完了」をクリックします。
  3. 「プロジェクト」ビューで pimbrowserexample パッケージを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」にある「MIDP」を選択します。「ファイルの種類」として「ビジュアル MIDIlet」を選択します。「次へ」をクリックします。
  4. 「MIDlet 名」フィールドと「MIDP クラス名」フィールドに PIMBrowserExample と入力します。「完了」をクリックします。
    アプリケーションはビジュアルモバイルデザイナの「フロー」ビューに表示されます。

プロジェクトへのコンポーネントの追加

  1. フローデザイナで、コンポーネントパレットから次のコンポーネントをドラッグ&ドロップします。
    • スプラッシュ画面
    • 警告
    • PIM ブラウザ
  2. splashScreen をクリックし、「プロパティー」ウィンドウで、「テキスト」の値を「null」から「PIM Browser Example」に変更します。
  3. alert をクリックし、「プロパティー」ウィンドウで、「文字列」プロパティーの値を「選択された連絡先」に変更します。

プロジェクトへのコマンドの追加

  1. フローデザイナで、コンポーネントパレットの「コマンド」セクションから終了コマンドを選択します。
  2. これを pimBrowser コンポーネントにドラッグ&ドロップします。

コンポーネントを接続してアプリケーションフローを作成する

フローデザイナで、モバイルデバイスの「起動」をクリックし、splashScreen コンポーネントまでドラッグします。同様に、次の図に示すようにコンポーネントを接続します。

フローデザイナでコンポーネントをコマンドの線で接続したところ

Wireless Toolkit の連絡先データベースへの連絡先の追加

サンプルの連絡先を、ユーザーディレクトリ $JAVAME-SDKHOME/3.0/work/0/appdb/PIM/contacts/Contacts/javame-sdk フォルダにコピーします。
このフォルダには、次の 3 つのファイルがデフォルトで格納されています。

  • 1.vcf
  • 2.vcf
  • categories.txt
  • プロジェクトの実行

    F6 キーを押して主プロジェクトを実行するか、「実行」>「主プロジェクトを実行」を選択します。

    ページの先頭へ

    PIM ブラウザコンポーネントの Javadoc

    NetBeans IDE には、PIMBrowser コンポーネントや、VMD で使用できるその他のコンポーネントに関する API Javadoc が用意されています。PIMBrowser コンポーネントの Javadoc を表示するには、次を実行します。

    1. ソースコードの PIMBrowser コンポーネントにカーソルを合わせ、Ctr-Shift- スペースキーを押します (または「ソース」>「ドキュメントを表示」を選択します)。
      この要素の Javadoc がポップアップウィンドウに表示されます。
    2. ポップアップウィンドウで「外部 Web ブラウザにドキュメントを表示」アイコン (「外部 Web ブラウザにドキュメントを表示」) をクリックすると、PIMBrowser コンポーネントについての詳細な情報がブラウザに表示されます。

    ページの先頭へ


    関連項目

    ページの先頭へ

    get support for the NetBeans

    Support