サンプルアプリをダウンロードし、すでに RHMAP SDK が組み込まれている新規のネイティブ Android アプリケーションを使って開始します。

build.gradle ファイルで以下の依存関係を宣言します。

compile 'com.feedhenry:fh-android-sdk:3.0.0'

Gradle を使用していない場合は、JAR の SDK をその依存関係と共に手動でダウンロードできます。詳細は、SDK の Github リポジトリーの README ファイルにある「Usage」セクションを参照してください。

SDK には、INTERNET パーミッションが必要です。パーミッションがまだ追加されていない場合は、アプリの AndroidManifest.xml に追加してください。

<uses-permission android:name="android.permission.INTERNET"/>

最後に、アプリが RHMAP サーバーと通信できるようにするプロパティーを定義する必要があります。assets フォルダーに以下の内容の fhconfig.properties という新規ファイルを作成します。括弧内の参照部分はプロジェクトの値に置き換えます。

host = <RHMAP Core host>
projectid = <Project ID>
connectiontag = <Connection tag>
appid = <Client App ID>
appkey = <Client App API key>

クライアントアプリとクラウドアプリ間の通信についての詳細は、「Projects - Connections」を参照してください。

RHMAP SDK からのクラウド要求を呼び出す前に、まず、以下のように初期化する必要があります。

FH.init(this, new FHActCallback() {
  public void success(FHResponse pRes) {
    // Init okay, free to use FHActRequest
  }

  public void fail(FHResponse pRes) {
    // Init failed
    Log.e("FHInit", pRes.getErrorMessage(), pRes.getError());
  }
});