| Oracle Enterprise Pack for Eclipse Oracle Mobile Application Framework (OEPE Edition)でのモバイル・アプリケーションの開発 リリース2.3.0 E77213-01 |
|
 前 |
 次 |
| Oracle Enterprise Pack for Eclipse Oracle Mobile Application Framework (OEPE Edition)でのモバイル・アプリケーションの開発 リリース2.3.0 E77213-01 |
|
前 |
次 |
この付録では、モバイル・アプリケーション・フレームワークのアプリケーション・テンプレートを使用してMAFアプリケーションを作成する際に、OEPEによって生成されるファイルについて説明します。
この付録の内容は次のとおりです。
デフォルトでは、次のようになります。OEPEによって、次の3つのプロジェクトを含むMAFアプリケーションが作成されます。
最上位レベルまたはアセンブリ・プロジェクト。これは、アプリケーションのパッケージ化およびデプロイメントに必要なすべてのアーティファクトを保持します。また、以前のバージョンのMAFからアプリケーションを移行する場合、アセンブリ・プロジェクトは、プロジェクトで使用されるMAFランタイムのバージョンを追跡します。
アプリケーション・プロジェクト、applicationApplication。
ビュー・コントローラタイプ・プロジェクト、applicationView。これには、ソース・フォルダ(src)およびViewContentフォルダが含まれます。
データ・コントロールは次のとおりです。
デバイス機能データ・コントール。このデータ・コントロールによってApache Cordova Java APIが抽象化され、MAF AMXとして実装されているアプリケーション機能は、デバイスに埋め込まれている様々なサービスにアクセスできるようになります。
スプリングボード・ページを構築できるアプリケーション機能データ・コントール。
これらのプロジェクトの詳細は、第C.2項「アセンブリ・レベルのリソースについて」、第C.3項「アプリケーション・プロジェクト・リソースについて」および第C.4項「ビュー・プロジェクト・リソースについて」を参照してください。
これらのプロジェクト内には、MAFアプリケーションとアプリケーション機能の構成用ファイル、またはMAFアプリケーションをターゲット・プラットフォームにデプロイする際にそのアプリケーションで必要になるファイルもOEPEによって生成されます。ほとんどの場合、生成されたファイルを直接操作することはありません。かわりに、MAFアプリケーション・エディタ、MAF機能エディタ、データ・コントロール・マネージャなどのエディタを使用します。
OEPEは、アセンブリ・プロジェクトにMAFアプリケーション用のファイルを生成します。これらのファイル(表C-1を参照)には、MAFプリケーションのメタデータを記述するための構成ファイルが含まれています。図C-1に示すように、「プロジェクト・エクスプローラ」ペインからこれらのファイルにアクセスします。
(デフォルトの名前applicationで生成された)アセンブリ・プロジェクトには、アプリケーション全体のリソースが格納されており、MAFアプリケーションのプレゼンテーション・レイヤーが提供され、ここには、モバイル・デバイスでのアプリケーションの表示方法を構成するためのメタデータ・ファイルが含まれています。このプロジェクトはMAFアプリケーションのセキュリティを指定するもので、アプリケーションのログイン・ページ、およびアプリケーション全体のリソースを含めることができます。アプリケーション・コントローラ・プロジェクトは、本質的には、アプリケーション機能とそのコンテンツを定義するビュー・コントローラ・プロジェクトのコンシューマです。
MAFアプリケーション・エディタを使用して、アプリケーションレベルのアーティファクト(つまりmaf-application.xml)を編集します。これを使用して、MAFアプリケーション自体(その名前など)、アプリケーション・ライフサイクル・リスナー(LifeCycleListenerImpl.java)、および埋込みアプリケーション機能のためのログイン・サーバー接続の構成を行います。
表C-1 アセンブリ・プロジェクトを介してアクセスされるモバイル・アプリケーションレベルのアーティファクト
| アーティファクト | ファイルの場所 | 説明 |
|---|---|---|
|
|
次に例を示します。
|
MAFアプリケーションを定義できる、スタブXMLアプリケーションの識別子ファイル。ADF Fusion Webアプリケーションのアプリケーション識別子と同様に、これによって、アプリケーションのコンテンツ、ナビゲーション動作およびユーザー認証要件を定義できます。 このファイルは、MAFアプリケーション・エディタを使用して編集します。 |
|
|
次に例を示します。
|
MAFアプリケーションに使用されるデフォルト・スキンの構成に使用されます。 |
|
アプリケーション・イメージ |
次に例を示します。
|
iOSおよびAndroidアプリケーションのデプロイメントに必要とされる一連のイメージ。ここには、アプリケーション・アイコンやスプラッシュ画面のPNGイメージも含まれます。iPhoneなどのiOSデバイスへのデプロイメントでは、様々なサイズのイメージ・セットが必要です。 プロジェクトで提供されるデフォルトのiOSイメージは次のとおりです。
これらのイメージをオーバーライドするには、第27.3.1.5項「Androidアプリケーションへのカスタム・イメージの追加方法」を参照してください。 |
|
|
次に例を示します。
|
システム全体のキーストアである |
|
|
次に例を示します。
|
ロギング・レベルやロギング・コンソールなど、アプリケーション・エラーのロギングを設定できます。詳細は、第30.6項「MAFアプリケーションでのロギングの使用および構成」を参照してください。 |
|
|
次に例を示します。
|
Java仮想マシン、JVM 1.4の構成ファイル。このファイルを使用して、アプリケーションの起動やヒープ領域の割当て、JavaおよびJavaScriptのデバッグ・オプションを構成します。詳細は、第30.3.2項「JavaコードおよびJavaScriptのデバッグを有効にする方法」を参照してください。 |
|
|
次に例を示します。
|
構成サービス・パラメータなど、アプリケーション・レベルの設定の構成に使用します。第14章「MAFアプリケーションで使用されるエンド・ポイントの構成」も参照してください。 |
|
|
次に例を示します。
|
MAFアプリケーションで定義されているすべての接続のリポジトリ。 |
|
|
次に例を示します。
|
REST Webサービスから返されたデータのオフライン・キャッシュ用の構成ファイル。キャッシュはパフォーマンスを上げることでユーザーの操作性を向上させるだけでなく、ユーザーがオフライン・モードで作業しているときにデータの読取りや表示を行えるようにします。 |
アプリケーション・プロジェクト自体(デフォルト名applicationApplicationで生成)の中に、OEPEにより表C-2に示される次のアーティファクトが作成されます。
MAF機能エディタを使用して、アプリケーションレベルのアーティファクト(つまりmaf-feature.xml)を編集します。これによって、MAFアプリケーションを構成するアプリケーション機能を記述します。
表C-2 アプリケーション・プロジェクトのアーティファクト
| アーティファクト | ファイルの場所 | 説明 |
|---|---|---|
|
|
次に例を示します。
|
MAFアプリケーションのデフォルトのアプリケーション・ライフサイクル・リスナー(ALCL)。 |
|
|
次に例を示します。
|
使用可能なスキンを定義するもので、新しいスキンを定義することもできます。 詳細は、第7章「MAFアプリケーションのスキニング」を参照してください。 |
|
|
次に例を示します。
|
|
|
|
次に例を示します。
|
データ・コントロールのレジストリ。デバイスのサービスを活用するDeviceFeaturesデータ・コントロールの使用方法の詳細は、第13章「MAF AMXでのバインディングの使用とデータ・コントロールの作成」を参照してください。埋込みアプリケーション機能をコールするSpringboardページを作成できるようにするApplicationFeaturesデータ・コントロールの詳細は、第4.6項「MAF AMXコンテンツによるカスタムSpringboardアプリケーション機能に関する必知事項」を参照してください。 |
ビュー・プロジェクト(図C-3に示すとおり、デフォルト名applicationViewで生成)には、アプリケーション機能のリソースが格納されます。第C.2項「アセンブリ・レベルのリソースについて」で説明したアプリケーション・プロジェクトとは異なり、ビュー・プロジェクトのメタデータ・ファイルでは、アプリケーション機能レベルのリソース、特に、実行時にモバイル・デバイスでMAFアプリケーション自体のスプリングボード内またはそのナビゲーション・バーに表示できるように1つのMAFアプリケーションに集約可能な様々なアプリケーション機能を記述します。さらに、アプリケーション機能のメタデータ・ファイルでは、アプリケーション機能をHTMLページかMAF AMXページのどちらで構成するのかが記述されます。また、ビュー・コントローラ・プロジェクトには、これらのアプリケーション・ページと、アプリケーション機能レベルのリソース(MAFアプリケーション用に定義された、Springboardおよびナビゲーション・バー上のアプリケーション機能を表すアイコン・イメージなど)を含めることができます。
|
ヒント: ビュー・コントローラ・プロジェクト内には、アプリケーション機能に固有のコードを格納します。アプリケーション・コントローラ・プロジェクトは、(特に別々のビュー・コントローラ・プロジェクト内で定義されている)アプリケーション機能間で共有されるコードの場所として使用してください。 |
ビュー・コントローラ・プロジェクトは、アプリケーション・コントローラ・プロジェクトと分離して、別のモバイル・アプリケーションで再使用できるように、アーカイブ・ファイルとしてデプロイできます(第8.1項「機能アーカイブ・ファイルの概要」を参照)。また、稀なケースとして、アプリケーション・コントローラ・プロジェクトが複数のビュー・コントローラ・プロジェクトを使用することもできます。
|
注意: MAFビュー・コントローラ・プロジェクトを別のMAFビュー・コントローラ・プロジェクトの依存性またはMAFアプリケーション・コントローラ・プロジェクトの依存性として追加すると、MAFアプリケーションをデプロイできなくなります。 |
これらのリソースには、maf-feature.xmlと呼ばれるアプリケーション機能の構成ファイルが含まれ、これはMAF機能エディタで編集します。
表C-3 ビュー・コントローラのアーティファクト
| アーティファクト | ファイルの場所 | 説明 |
|---|---|---|
|
|
次に例を示します。
|
アプリケーション機能を定義できるようにする、スタブXMLの識別子ファイル。 Oracle Enterprise Pack Oracle Enterprise Pack for Eclipseのインストールの説明に従ってモバイル・プリファレンスを構成した後、デフォルトのデプロイメント構成設定を使用してこのアプリケーションをデプロイできます。詳細は、第27章「MAFアプリケーションのデプロイ」を参照してください。 |
|
アプリケーション固有のコンテンツ |
次に例を示します。
|
|
