IMAPSプラグインを利用してアプリケーションを開発するためには、ハイブリッドアプリケーションを開発するための準備をあらかじめおこなっておく必要があります。ハイブリッドアプリケーションを作成するための準備については、「3.4.1 雛形プロジェクトのダウンロード」～「3.4.4 Cordovaの設定」を参照してください。
IMAPSではCordovaを使ったハイブリッドアプリケーションを作成するために、以下のようなファイルを提供しています。
No. | 提供物 | 説明 |
|---|---|---|
1 | imaps-1.1.0.jar(Android用) | JavaScriptから呼び出されるネイティブ部分の実装を含むjarファイル。 |
2 | IMAPSCore.framework(iOS用) | JavaScriptから呼び出されるネイティブ部分の実装を含むフレームワーク。XCodeのプロジェクトに取り込んで利用します。 |
3 | Model.xcdatamodel(iOS用) | SLSのデータベース定義ファイルです。 |
4 | imaps.js | 開発時に利用するJavaScriptファイル。圧縮されていません。 |
5 | imaps.min.js | 運用時に利用するJavaScriptファイル。圧縮されています。 |
6 | SLS用暗号化ライブラリ(Android用) | 暗号化機能を提供するネイティブライブラリ。 |
JavaScriptファイルはUTF-8です。
[Androidの場合]
imaps-1.1.0.jarは以下に配置されています。
Windows版サーバの場合:
<製品インストールフォルダー>\development\android\native
Linux版サーバの場合:
/opt/FJSVimsrv/development/android/native
上記ファイルを、ダウンロードした雛形プロジェクトのlibsディレクトリ配下に配置します。
SLS用暗号化ライブラリは、インストールしたサーバの以下に配置されています。
Windows版サーバの場合:
<製品インストールフォルダー>\development\android\sls
Linux版サーバの場合:
/opt/FJSVimsrv/development/android/sls
SLS用暗号化ライブラリは以下のように配置します。
格納先ディレクトリ配下のlibsディレクトリ内の提供物を、アプリケーションプロジェクトのlibs配下に配置
次に開発に必要なその他のライブラリ、ファイルの準備をおこないます。
log4j-1.2.17.jar。ダウンロードし、追加してください。
httpmime-4.2.5.jar。ダウンロードし、追加してください。
imaps.properties。「付録F クライアント設定ファイル」を参照してください。
利用するプラグインによって、必要なパーミッションをAndroidManifest.xmlに定義します。
[認証]
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
[SLS]
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
[ログ収集]
<uses-permission android:name="android.permission.INTERNET"/>
[プッシュ通知]
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
端末ブート時にプッシュサービスを起動する際には以下も必要です。
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
バイブレーションを鳴動させるためには以下も必要です。
<uses-permission android:name="android.permission.VIBRATE" />
GCMを利用するためには以下も必要です。
<permission android:name="[アプリpackage名].permission.C2D_MESSAGE" android:protectionLevel="signature" />
<uses-permission android:name="[アプリpacakge名].permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
[iOSの場合]
IMAPSCore.frameworkは以下に配置されています。
Windows版サーバの場合:
<製品インストールフォルダー>\development\ios\native
Linux版サーバの場合:
/opt/FJSVimsrv/development/android/ios/native
上記ファイルを、ダウンロードした雛形プロジェクトにフレームワークとしてリンクします。
データベース定義ファイルは以下に配置されています。
Windows版サーバの場合：
<製品インストールフォルダー>\development\ios\native\Model.xcdatamodel
Linux版サーバの場合：
/opt/FJSVimsrv/development/ios/native/Model.xcdatamodel
上記データベース定義ファイルを取得し、プロジェクトに取り込んでください。
4.4 節に記載しているフレームワークを追加していない場合は、追加してください。
クライアント設定ファイルをアプリケーション内に取り込む事により、アプリケーションの動作をカスタマイズする事ができます。詳細は「付録F クライアント設定ファイル」を参照してください。
[共通]
JavaScriptファイルは、インストールしたサーバの以下に配置されています。
Windows版サーバの場合：
<製品インストールフォルダー>\development\hybrid
Linux版サーバの場合:
/opt/FJSVimsrv/development/hybrid
JavaScriptファイルは通常のJavaScriptと同様に、HTMLファイルからロードして利用します。
