| Oracle® Mobile Application Framework Oracle Mobile Application Frameworkでのモバイル・アプリケーションの開発 2.1.0 E60836-01 |
|
 前 |
 次 |
| Oracle® Mobile Application Framework Oracle Mobile Application Frameworkでのモバイル・アプリケーションの開発 2.1.0 E60836-01 |
|
前 |
次 |
この章では、MAFに用意されているコア・プラグインを有効にしてMAFアプリケーションで使用する方法、追加プラグインを登録する方法、FARからプラグインをインポートする方法、およびMAFアプリケーションのプラグインをパッケージ化してデプロイする方法について説明します。
この章の内容は次のとおりです。
MAFには様々なCordovaプラグインがパッケージ化されているので、MAFアプリケーションはこのプラグインを使用してデプロイ先のデバイスと対話できます。MAFに用意されているデフォルトのプラグインはコア・プラグインと呼ばれます。これらのプラグインはmaf-application.xmlファイルの概要エディタで確認できます。たとえば、MAFアプリケーションでデバイスの電子メール機能やコンタクト先機能へのアクセスに使用する電子メールプラグインやコンタクト先プラグインなどがあります。
MAFには、プラグインを使用するMAFアプリケーション用に、次のバージョンのApache Cordovaが含まれています。
AndroidプラットフォームのMAFアプリケーション用Apache Cordova 3.6.3
iOSプラットフォームのMAFアプリケーション用Apache Cordova 3.7.0
各プラグインの説明を表示するには、「コア・プラグイン」リスト(図9-1を参照)でプラグインを選択します。新規作成したMAFアプリケーションでは、1つのコア・プラグイン(ネットワーク情報プラグイン)のみがデフォルトで有効になっています。第9.2項「MAFアプリケーションでのコア・プラグインの有効化」の説明に従って、これらのコア・プラグインを有効または無効にします。
|
注意: iOSデバイス上のすべてのアプリケーションにネットワーク・アクセスがデフォルトで許可されます。この動作は変更できません。Androidデバイスにデプロイするアプリケーションについては、Androidデバイス上でネットワーク・アクセスを許可しない場合、ネットワーク情報プラグインを無効にします。 |
MAFに用意されているデフォルトのコア・プラグインではMAFアプリケーションの要件を満たさない場合は、独自に開発した追加プラグインを登録できます。詳細は、第9.3項「MAFアプリケーションでの追加プラグインの登録」を参照してください。
追加プラグインを登録するとMAFアプリケーションがデプロイできなくなる場合、MAFアプリケーションで使用されているプラグイン間でファイル名が競合している可能性があります。または、登録した追加プラグインが正常に機能するために必要な依存プラグインが存在しないことが原因の可能性もあります。詳細は、第9.4項「MAFアプリケーション組込みプラグインのデプロイ」を参照してください。
以前のリリースのMAFで作成したMAFアプリケーションを移行する場合は、アプリケーションで使用されているすべてのプラグインをmaf-plugins.xmlファイルに登録する必要があります。詳細は、『Oracle Mobile Application Frameworkのインストール』のCordovaプラグインの旧リリースからMAF 2.1.0への移行に関する項を参照してください。
|
注意: アプリケーションのプラグインを管理するにはmaf-application.xmlファイルを編集しますが、変更を加えるとmaf-plugins.xmlファイルのリビジョンが作成されます。「アプリケーション・リソース」ペインのADF-META-INFノードから、両方のファイルにアクセスします(図9-1を参照)。 |
新規作成したMAFアプリケーションでは、1つのコア・プラグイン(ネットワーク情報プラグイン)のみがデフォルトで有効になっています。他のコア・プラグインを有効または無効にして、関連するデバイスの機能にMAFアプリケーションがアクセスできるようにしてください。
コア・プラグインを有効にするには、MAFアプリケーションのmaf-application.xmlファイルの概要エディタを使用します。
MAFアプリケーションでコア・プラグインを有効にする手順:
「アプリケーション」ウィンドウで、「アプリケーション・リソース」パネルを開きます。
「アプリケーション・リソース」パネルでDescriptorsを展開し、ADF META-INFを展開します。
maf-application.xmlファイルをダブルクリックし、表示される概要エディタで「プラグイン」ナビゲーション・タブをクリックします。
「コア・プラグイン」セクションを展開し、アプリケーションが機能にアクセスできるようにするプラグインを選択します。
たとえば、MAFアプリケーションでSMSメッセージを送信できるようにするには、SMSプラグインのチェック・ボックスを選択します。
概要エディタでプラグインを有効にすると、JDeveloperによってアプリケーションのmaf-plugins.xmlファイルが編集され、MAFアプリケーションで有効なプラグインを特定するエントリが追加されます。例9-1に、電子メール、PushPluginおよびネットワーク情報の各プラグインが有効になっているMAFアプリケーションのエントリを示します。デバイスの電子メール・クライアントを使用し、インターネットにアクセスして、デバイスからプッシュ通知を受信しているMAFアプリケーションでは、これらのプラグインの有効化は必須です。
例9-1 maf-plugins.xmlファイル内の有効なコア・プラグイン
<?xml version="1.0" encoding="UTF-8" ?>
<maf-plugins xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/adf/mf">
<cordova-plugins>
<core-cordova-plugin id="c1" pluginId="org.apache.cordova.network-information"/>
<core-cordova-plugin id="c2" pluginId="com.oracle.maf.email"/>
<core-cordova-plugin id="c3" pluginId="com.phonegap.plugins.PushPlugin"/>
</cordova-plugins>
</maf-plugins>
MAFに用意されたコア・プラグインでは提供されていない機能がMAFアプリケーションで必要な場合は、MAFアプリケーションに追加プラグインを登録します。
MAFアプリケーションで使用する追加プラグインを登録するには、MAFアプリケーションのmaf-application.xmlファイルの概要エディタを使用します。
始める前に、プラグインを登録するアプリケーションと同じドライブに、対象のプラグインが格納されていることを確認します。たとえば、Windows環境でC:ドライブにアプリケーションが格納されている場合、そのアプリケーションに登録するプラグインもC:ドライブに格納する必要があります。これにより、JDeveloperでは相対パスを使用してアプリケーションにプラグインを正常に登録できます。
MAFアプリケーションに追加プラグインを登録する手順:
「アプリケーション」ウィンドウで、「アプリケーション・リソース」パネルを開きます。
「アプリケーション・リソース」パネルでDescriptorsを展開し、ADF META-INFを展開します。
maf-application.xmlファイルをダブルクリックし、表示される概要エディタで「プラグイン」ナビゲーション・タブをクリックします。
「追加のプラグイン」セクションを展開し、「追加」アイコンをクリックしてダイアログを表示し、アプリケーションに登録するプラグインが格納されているディレクトリを参照して選択します。
MAFアプリケーションで使用するプラグインのソース・ファイルを選択すると、JDeveloperによってアプリケーションのmaf-plugins.xmlファイルが編集され、MAFアプリケーションで有効なプラグインを特定するエントリが追加されます。例9-2は、MAFアプリケーションにカレンダプラグイン(図9-2を参照)が登録されている場合のmaf-plugins.xmlファイル内のエントリを示したものです。
例9-2 maf-plugins.xmlファイル内の追加プラグイン
<?xml version="1.0" encoding="UTF-8" ?>
<maf-plugins xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/adf/mf">
<cordova-plugins>
<core-cordova-plugin id="c1" pluginId="org.apache.cordova.network-information"/>
<cordova-plugin id="c2" pluginId="nl.x-services.plugins.calendar"
path="../../../../../z_plugins/Calendar-PhoneGap-Plugin-master/">
<platform id="p1" name="android" enabled="true"/>
<platform id="p2" name="ios" enabled="true"/>
</cordova-plugin>
</cordova-plugins>
</maf-plugins>
MAFアプリケーション組込みプラグインのデプロイメントは、選択したデプロイメント方法によって異なります。
FARへのデプロイメント
FARへのデプロイメントには、アプリケーションのmaf-plugins.xmlファイルのコピー(ファイル名: jar-maf-plugins.xml)が含まれます。これは、アプリケーションのmaf-plugins.xmlファイルと同じですが、各プラグインのpath属性値が空の文字列である点が異なります。FARデプロイメントにはプラグインのソース・ファイルは含まれません。
モバイル・アプリケーション・アーカイブ・ファイルへのデプロイメント
モバイル・アプリケーション・アーカイブ・ファイルへのデプロイメントには、すべてのpath属性が空の文字列に設定された、アプリケーションのmaf-plugins.xmlファイルのコピーが含まれます。
AndroidまたはiOSデプロイメント・プロファイルを使用したデプロイメント
AndroidまたはiOSデプロイメント・プロファイルを使用してデプロイする場合は、JDeveloperがmaf-helperコマンドライン・ツールを起動して、構成済プラグインをデプロイします。maf-helperコマンドライン・ツールでは、プラグイン・アーティファクトがそれぞれのソースの場所からAndroidまたはiOSのデプロイメント・フォルダにデプロイされます。コマンドライン・ツールでプラグインがデプロイされると、デプロイメントではそのプラグインをプラットフォーム固有のアプリケーションに組み込みます。
プラグイン間における名前の競合の解決
MAFアプリケーションで使用されている複数のプラグインに同じ名前のリソース・ファイルが含まれている場合、名前の競合が原因でデプロイメントに失敗する可能性があります。たとえば、MAFアプリケーションで2つのプラグインを使用し、両方のリソース・ファイルがarrays.xmlである場合、デプロイメントは失敗します。
このような名前の競合を解決するには、2番目のプラグインのリソース・ファイル名と競合している1番目のプラグインのリソース・ファイル名を変更します。1番目のプラグインのplugin.xmlファイル内で、リソース・ファイルへの参照を更新します。この例では、1番目のプラグインのarray.xmlリソース・ファイル名をpluginone_arrays.xmlに変更して、プラグインのplugin.xmlファイルを次のように編集する必要があります。
<source-file src="src/android/LibraryProject/res/values/pluginone_arrays.xml"
target-dir="res/values"/>
不足している依存プラグインの追加
MAFアプリケーションで使用する追加プラグインに必要なプラグイン(依存プラグイン)が検出されないと、デプロイメントに失敗する場合があります。このシナリオは、ファイアウォールで保護されている場合に発生する可能性があり、その原因は、デプロイ時にJDeveloperがApache Cordovaのツールを起動してプラグインの依存性を管理するためです。後者のツールは、依存プラグインのダウンロードを許可するようにプロキシ設定が構成されていないと、依存プラグインのダウンロードに失敗する場合があります。このシナリオを回避するには、不足している依存プラグインをダウンロードして、MAFアプリケーションに追加します。不足している依存プラグインの追加は、MAFアプリケーションに他のプラグインを追加する場合と同じ方法で行います。詳細は、第9.3項「MAFアプリケーションでの追加プラグインの登録」を参照してください。依存プラグインを追加したら、maf-plugins.xmlファイルで、必要とされるプラグインの前にこのプラグインが表示されていることを確認してください(例9-3を参照)。
例9-3 MAFアプリケーションへの依存プラグインの追加
<maf-plugins xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/adf/mf">
<cordova-plugins>
....
<cordova-plugin id="c2" pluginId="com.example.dependent.dependentPlugin"
path="../../../../../plugins/Dependent-Plugin-Required-By-PluginWithID_c3/">
...
<cordova-plugin id="c3" pluginId="com.example.plugin"
path="../../../../../plugins/AdditionalPlugin/">
...
</cordova-plugins>
</maf-plugins>
jar-maf-plugins.xmlファイルが格納されたFARをアプリケーションにインポートすると、jar-maf-plugins.xmlファイルの内容は使用するアプリケーションのmaf-plugins.xmlファイルにマージされます。JDeveloperではマージに関する情報を「メッセージ」ウィンドウに記録します。FARからインポートするプラグインがすでにコンシューマ・アプリケーションのmaf-plugins.xmlファイルに存在する場合、プラグインはアプリケーションに存在するのでマージされないというメッセージがJDeveloperによってログに記録されます。FARからインポートするプラグインがコンシューマ・アプリケーションのmaf-plugins.xmlファイルに存在しない場合、JDeveloperはそのプラグインをアプリケーションのmaf-plugins.xmlファイルに追加します。このシナリオでは、第9.3項「MAFアプリケーションでの追加プラグインの登録」の説明に従って、新しくインポートしたプラグインへのパスを設定する必要があります。
