サンプルアプリをダウンロードし、すでに 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());
  }
});

新規テンプレートアプリを使って開始する場合、選択肢として以下の 2 つのオプションがあります。

git clone https://github.com/feedhenry-templates/blank-ios-app.git
git checkout cocoapods

pod install

git clone https://github.com/feedhenry-templates/blank-ios-app.git

既存アプリと RHMAP を統合する場合、選択肢として以下の 2 つのオプションがあります。

pod FH, '3.1.1'

RHMAP iOS SDK にはフレームワークおよびライブラリーの数多くの依存関係があります。SDKをプロジェクトで適切にコンパイルするには、ビルド時にフレームワークやライブラリーにリンクするよう Build Phases を再設定しなければなりません。以下は、リンクする必要のあるライブラリーです。

これらを追加するには、Build Phases > Link Binary with Libraries に移動し、上記の依存関係をリンク依存関係として追加します。

また、リンカーフラグをアプリに追加する必要もあります。これを追加するには、プロジェクトのターゲットの Build Settings 画面に移動します。検索を実行して Other linker flags を見つけ、以下を追加します。

-Objective-C

最後に、fhconfig.plist というプロパティーリストファイルをプロジェクトに追加します。

アプリが RHMAP サーバーと通信できるようにするプロパティーを定義する必要があります。以下の値を fhconfig.plist 設定ファイルに追加します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>host</key>
  <string>__RHMAP_Core_host__</string>
  <key>appid</key>
  <string>__Client_App_ID__</string>
  <key>projectid</key>
  <string>__Project_ID__</string>
  <key>appkey</key>
  <string>__Client_App_ API_key___</string>
  <key>connectiontag</key>
  <string>__Connection_tag__</string>
</dict>
</plist>

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

RHMAP iOS Swift SDK からクラウド要求を呼び出す前に、初期化する必要があります。以下のコードスニペットを App Delegate の didFinishLaunchingWithOptions: メソッドか、またはコードがクラウド要求前に確実に呼び出されるその他の場所にコピーします。

#import <FH/FH.h>
#import <FH/FHResponse.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Override point for customization after application launch.

  // Call a cloud side function when init finishes
  void (^success)(FHResponse *)=^(FHResponse * res) {
    // Initialisation is now complete, you can now make FHActRequest's
    NSLog(@"SDK initialised OK");
  };

  void (^failure)(id)=^(FHResponse * res){
    NSLog(@"Initialisation failed. Response = %@", res.rawResponse);
  };

  //View loaded, init the library
  [FH initWithSuccess:success AndFailure:failure];

  return YES;
}

サンプルアプリ をクローンし、RHMAP iOS Swift SDK が CocoaPods の依存関係として組み込まれた新規 iOS アプリケーションを使って開始します。

git clone https://github.com/feedhenry-templates/blank-ios-swift.git

Podfile で定義された依存関係を取得します。

pod install

Xcode で blank-ios-app.xcworkspace ワークプレースを開きます。必要な依存関係は Pods グループにあります。

アプリに Podfile がない場合、以下の内容の Podfile という新規ファイルをプロジェクトのルートに作成してください。

source 'https://github.com/CocoaPods/Specs.git'

xcodeproj 'ProjectName.xcodeproj'
platform :ios, '8.0'
use_frameworks!

pod 'FeedHenry', '4.0.0'

4.0.0 をターゲットにしている RHMAP iOS Swift SDK のバージョンに、ProjectName.xcodeproj をプロジェクトの名前に置き換えます。バージョン番号を指定しない場合、CocoaPods 中央リポジトリーの最新バージョンが使用されます。

Podfile で定義された依存関係を取得します。

pod install

Xcode で ProjectName.xcworkspace を開けるようになります。

アプリが RHMAP サーバーと通信できるようにするプロパティーを定義する必要があります。以下の値を fhconfig.plist 設定ファイルに追加します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>host</key>
  <string>__RHMAP_Core_host__</string>
  <key>appid</key>
  <string>__Client_App_ID__</string>
  <key>projectid</key>
  <string>__Project_ID__</string>
  <key>appkey</key>
  <string>__Client_App_ API_key___</string>
  <key>connectiontag</key>
  <string>__Connection_tag__</string>
</dict>
</plist>

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

RHMAP iOS Swift SDK からクラウド要求を呼び出す前に、初期化する必要があります。以下のコードスニペットを App Delegate の application(_, didFinishLaunchingWithOptions:) メソッドか、またはコードがクラウド要求前に確実に呼び出されるその他の場所にコピーします。

import FeedHenry

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
  FH.init { (resp:Response, error: NSError?) -> Void in
    if let error = error {
      print("Error: \(error)")
      return
    }
    print("Response: \(resp.parsedResponse)")
  }
  return true
}

FH SDK は NuGet (https://www.nuget.org/packages/FH.SDK/) から利用できます。Visual Studio 内で NuGet プラグインを使用している場合は、FH.SDK を検索してください。NuGet は依存関係のライブラリーを自動的にインストールします。

SDK をダウンロードし、これを展開します。.dll アセンブリーファイルを、プロジェクトの参照として wp80 フォルダー内に追加します。

Portable Class Library プロジェクトを開発している場合は、FHSDK.dll ファイルのみを参照します。

この SDK は、Json.Net および Microsoft HTTP クライアントライブラリーに依存しています。これらのライブラリーのアセンブリーも、プロジェクトで利用可能でない場合はインストールする必要があります。

プロジェクトに fhconfig.json という新規ファイルを作成する必要があります。ファイルの内容は以下のようになります。

{
  "appid": "__ID_OF_APP_IN_PROJECT__",
  "appkey": "__APP_API_KEY_OF_APP_IN_PROJECT__",
  "connectiontag": "__CONNECTION_TAG_TO_USE_FOR_CLOUD__",
  "host": "__APP_STUDIO_HOST__",
  "projectid": "__PROJECT_ID__"
}

ファイルの Build Action が Content であることを確認します。

RHMAP .NET SDK を使用するには、 (通常はアプリの起動時に) 以下のように SDK を初期化する必要があります。

try
{
  bool inited = await FHClient.Init();
  if(inited) {
    //Initialisation is successful
  }
}
catch(FHException e)
{
  //Initialisation failed, handle exception
}

接続についての詳細は、こちらを参照してください。

FH SDK は NuGet (https://www.nuget.org/packages/FH.SDK/) から利用できます。Xamarin Studio 内で NuGet プラグインを使用している場合は、FH.SDK を検索してください。NuGet は依存関係のライブラリーを自動的にインストールします。

SDK をダウンロードし、これを展開します。プロジェクトのビルドターゲットに対応するフォルダーから .dll アセンブリーファイルを参照として追加します。

Portable Class Library プロジェクトを開発している場合は、FHSDK.dll ファイルのみを参照します。

この SDK は、Json.Net および Microsoft HTTP クライアントライブラリーに依存しています。これらのライブラリーのアセンブリーも、プロジェクトで利用可能でない場合はインストールする必要があります。

プラットフォーム固有のそれぞれのアプリケーションについて、対応する設定ファイルを作成する必要があります。それぞれのファイルの内容は、各プラットフォームのネイティブ SDK doc に記載される内容と同じである必要があります。

fhconfig.plist がアプリケーションのルートにあります。Build Action を BundleResource に設定します。

fhconfig.plist ファイルの内容:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>host</key>
  <string>__APP_STUDIO_HOST__</string>
  <key>appid</key>
  <string>__ID_OF_APP_IN_PROJECT__</string>
  <key>projectid</key>
  <string>__PROJECT_ID__</string>
  <key>appkey</key>
  <string>__APP_API_KEY_OF_APP_IN_PROJECT__</string>
  <key>connectiontag</key>
  <string>__CONNECTION_TAG_TO_USE_FOR_CLOUD__</string>
</dict>
</plist>

fhconfig.properties がアプリケーションの Assets ディレクトリーにあります。Build Action を AndroidAsset に設定します。

fhconfig.properties ファイルの内容:

host = __APP_STUDIO_HOST__
projectid = __PROJECT_ID__
connectiontag = __CONNECTION_TAG_TO_USE_FOR_CLOUD__
appid = __ID_OF_APP_IN_PROJECT__
appkey = __APP_API_KEY_OF_APP_IN_PROJECT__

fhconfig.json がアプリケーションのルートにあります。Build Action を Content に設定します。

fhconfig.json ファイルの内容:

{
  "appid": "__ID_OF_APP_IN_PROJECT__",
  "appkey": "__APP_API_KEY_OF_APP_IN_PROJECT__",
  "connectiontag": "__CONNECTION_TAG_TO_USE_FOR_CLOUD__",
  "host": "__APP_STUDIO_HOST__",
  "projectid": "__PROJECT_ID__"
}

接続についての詳細は、こちらを参照してください。

RHMAP .NET SDK を使用するには、アプリの起動が終了する際に、プラットフォーム固有のプロジェクト (PCL プロジェクトではない) で以下のように SDK を初期化する必要があります。

try
{
  bool inited = await FHClient.Init();
  if(inited) {
    //Initialisation is successful
  }
}
catch(FHException e)
{
  //Initialisation failed, handle exception
}

FHClient は以下のネームスペースで利用できます。

アプリのビルドターゲットに応じ、上記のネームスペースの 1 つのみをアプリで利用可能にする必要があります。

複数の異なるネームスペースで同じ FHClient クラスを定義するのは、主にプラットフォーム固有のアセンブリーファイルを適切にロードする必要があるためです。

サンプルアプリをダウンロードし、すでに RHMAP JavaScript SDK が組み込まれている新規の Cordova アプリを使って開始します。

SDK をダウンロードし、feedhenry.js として保存します。

feedhenry.js を Cordova アプリの index.html ファイルと同じ場所 (通常は www ディレクトリー内) にコピーします。

以下のコードを index.html ファイルに追加します。

<head>
  <script src="feedhenry.js" type="text/javascript"></script>
</head>

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

{
  "host": "<RHMAP Core host>",
  "projectid": "<Project ID>",
  "connectiontag": "<Connection tag>",
  "appid": "<Client App ID>",
  "appkey": "<Client App API key>"
}

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

Cordova CLI: 5.2.0

サンプルアプリをダウンロードし、すでに RHMAP SDK が組み込まれている新規の Cordova Light アプリを使って開始します。

SDK をダウンロードし、feedhenry.js として保存します。

feedhenry.js を Cordova アプリの index.html ファイルと同じ場所 (通常は /www ディレクトリー内) にコピーします。

以下のコードを index.html ファイルに追加します。

<head>
  <script src="feedhenry.js" type="text/javascript"></script>
</head>

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

{
  "host": "<RHMAP Core host>",
  "projectid": "<Project ID>",
  "connectiontag": "<Connection tag>",
  "appid": "<Client App ID>",
  "appkey": "<Client App API key>"
}

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

SDK をダウンロードし、feedhenry.js として保存します。

上記のダウンロードされた JavaScript ファイルを Web App にコピーし、参照できるようにします。このファイルは、index.html ファイルと同じ場所 (通常は /public ディレクトリー内) にコピーする必要があります。

以下のコードを index.html ファイルに追加します。

<head>
  <script src="feedhenry.js" type="text/javascript"></script>
</head>

SDK ファイル (feedhenry.js) と同じディレクトリーに、以下の内容の fhconfig.json という新規ファイルを作成します。

{
  "appid": "__ID_OF_APP_IN_PROJECT__",
  "appkey": "__APP_API_KEY_OF_APP_IN_PROJECT__",
  "connectiontag": "__CONNECTION_TAG_TO_USE_FOR_CLOUD__",
  "host": "__APP_STUDIO_HOST__",
  "projectid": "__PROJECT_ID__"
}

接続についての詳細は、こちらを参照してください。

SDK をダウンロードし、feedhenry.js として保存します。

上記のダウンロードされた JavaScript ファイルを Basic Web アプリにコピーし、参照できるようにします。このファイルは、index.html ファイルと同じ場所 (通常は /www ディレクトリー内) にコピーする必要があります。

SDK を統合するには、上記のダウンロードされた JavaScript ファイルを参照できるように /Resources ディレクトリーの Appcelerator プロジェクトにコピーする必要があります。

SDK ファイル (feedhenry.js) と同じディレクトリーに、以下の内容の fhconfig.js という新規ファイルを作成します。

exports = {
  "appid":"__ID_OF_APP_IN_PROJECT__",
  "appkey":"__APP_API_KEY_OF_APP_IN_PROJECT__",
  "connectiontag":"__CONNECTION_TAG_TO_USE_FOR_CLOUD__",
  "host":"__APP_STUDIO_HOST__",
  "projectid":"__PROJECT_ID__"
};

接続についての詳細は、こちらを参照してください。