セットアップ Eclipse (1.4.7 以降)

このページでは、Mobage Native SDK (Android 版) のセットアップ方法について解説します。

Eclipse から Mobage Native SDK ライブラリをインポートする

 
Eclipse 上 で Mobage Native SDK アプリケーション開発を行うためには、Eclipse の Android Project にて Mobage Native SDK 関連のライブラリを追加する必要があります。Mobage Native SDK パッケージをダウンロード、解凍した後は下記のステップを踏んでください。
(1) MobageNativeAndroidをEclipseにインポートします。
(1-1) File > Import > Existing Projects into Workspace を選択し、MobageNativeAndroid を指定、インポートします。
(2) ゲームプロジェクトが MobageNativeAndroid を参照するよう設定します。
(2-1) 参照元プロジェクト を右クリック後、Properties でプロパティを開き、Android > Library (右下) で Add ボタンをクリックし、MobageNativeAndroid を選択して OK をクリックします。

※Android SDK r16以前を使用されている場合には、上記に加えて以下も実行してください。
(3) MobageNativeSdk.jar へパスを通します。
(3-1) 参照元プロジェクト を右クリック後、Properties でプロパティを開き、Java Build Path > Libraries で Add JARs を選択します。
(3-2) MobageNativeAndroid/libs/MobageNativeSdk.jar を選択し、参照ライブラリに追加します。

android-support-v4.jar が Native SDK 内のものと競合する場合がありますので、その際はゲーム側の android-support-v4.jar を削除して下さい。

AndroidManifest.xml を設定する

Mobage Native SDK を用いた開発では、Android 端末が元から持っている様々なネイティブ機能を利用、あるいは制限するために、AndroidManifest.xml の中に下記のような設定のための記述を含める必要があります。

  • インターネットへアクセスするため、インターネットアクセス許可が必要です。
  • 画面の向き変更に対応していないため、Activity に対して画面の向きを固定します。
  • Main の Activity については standard モードおよび singleTop モードで起動するように設定します。
  • シングルサインオン用に SDK の内部に Activity を保持しているため、この Activity を外部から呼び出せるように設定します。
  • ダッシュボード Activity (MobageDashBoardActivity) の設定が必要です。
  • application タグの android:icon="@drawable/icon" については変更しないようにお願いします。(デベロッパーサイトに設定した icon ファイルに差し替わります)
  • com.mobage.android.TrackingReceiver の設定が必要です。
上記と他の必要な設定を全て記述すると、AndroidManifest.xml は下記のようになります。
MobageDashboardActivity の screenOrientation に landscape を指定することができます。landscape に設定することで Mobage の UI が横画面で開くようになりますので、横画面のアプリでは指定されることを推奨します。

下記の箇所は、お使いの環境に合わせて書き換えてください。
${YourActivityName}:
  Activity 名 (FQCN: パッケージ名をつけたクラス名) に書き換えてください。

${YourApplicationId}:
  Mobage のアプリケーションID に書き換えてください。

Mobage Native SDK 1.4.7 より com.mobage.android.TrackingReceiver を必ず追加しなければならなくなりました。
もし Install Referrer を他の Receiver に転送したい場合は、以下のように記載して下さい。

  • meta-data の android:name は forward. で始まるユニークな名前を設定して下さい。
  • android:value は受け取る Receiver 名を FQCN で記載して下さい。
    TrackingReceiver が他の Receiver から Intent を転送してもらうこともできます。たとえば AppBrain と Google の CampaignTrackingReceiver とを併用する場合は、以下のように記述することができます。

 

F.O.X for Mobage について

Mobage Native SDK 1.4.7.4 以降、以下のように F.O.X for Mobage の利用を選択できるようになりました。

  • F.O.X for Mobage を利用する場合は、何もせずに通常のインポート手順で問題ありません。
  • F.O.X for Mobage を利用しない場合や、アプリケーションで独自に F.O.X を組み込む場合には、MobageNativeAndroid の代わりに MobageNativeAndroidWithoutFOX をインポートしてください。ライブラリの指定も同様です。

Android Market In-app Billing の設定をする

In-App Billing (以下、IAB) は、アプリ内でデジタルコンテンツを販売することを可能にする Google Play(旧Android Market) のサービスです。
IAB 対応のため Proguard を内部で使用します。それに伴い、既存の非公開 API が削除されております。また、アプリケーションを一般公開する際に多マーケットに対応するため、デベロッパーサイトへアップロードされたアプリケーションからパッケージ名を変更致します。

IAB 機能を利用する為には、下記のステップを踏んで下さい。

[1. FQCN でのクラス名の指定]

下記のクラスの参照の際は FQCN (完全修飾名、パッケージ名をつけたクラス名) で記述してください。

  • AndroidManifest.xml に記述するクラス
  • R クラス (R クラスを参照する全てのプログラムコード中)

[2. リソースファイル名の制限]

下記のアイコンファイル名は SDK が予約しています。予約された名前からファイル名を変更しないでください。

  • /res/drawable/icon.png
  • /res/drawable-hdpi/icon.png
  • /res/drawable-ldpi/icon.png
  • /res/drawable-mdpi/icon.png

[3. マーケット情報設定ファイル名の予約]

下記のマーケット情報設定ファイルは、SDK が予約しています。予約されたファイル名と同じ名前のファイルを作成しないでください。

  • /assets/billing_config.xml

[4. Intent 起動について]

広告サービス等で、Intent 起動が必要な場合に、com.mobage.android.activity.MobageProxyActivity に設定された Intent Filter は使用しないでください。

Google Play services Library の導入について

Google Play のポリシーが変更され、2014/08/01 から、Play ストアにアップロードされたすべての更新や新着アプリには、広告目的で使用する端末 ID として Advertising ID(端末で利用可能な場合)を使用する必要があります。

広告の成果のトラッキングのために Android で提供されている Advertising ID (以下、AdID) を利用する必要があります。AdID を使用するためには Google Play Services の 導入は必須です。 Google Play Serviceを導入しない場合、特定Android Versionでリモート通知が正常に動作しない等の不安定な状況になりますので、下記の導入方法に従って必ずGoogle Play Services を導入してください。

また、Mobage SDK 1.4.7.4 より、Android 5.0 (API Level 21) 以降を targetSdkVersion に設定する場合は、Google Play Services の導入が必須になりました。

導入方法

 Google Play service Library (4.0 以上) を以下のように導入していきます。

  1. eclipse で Android SDK Manager を起動する。
  2. 「Extras」 > 「Google Play service」 にチェックを入れてインストールする。
  3. 「Import」 -> 「Android」 -> 「Existing Android Code Into Workspace」 で、${ANDROID_SDK_PATH}/extras/google/google_play_services/libproject/google-play-services_lib をインポートする。

    インポートする際に直接参照ではなく、Copy projects into workspace にチェックを入れコピーしてください。


  4. 「Project の Properties」 > 「Android」 > 「Library」 で google-play-service_lib を Library Project としてリンクする。
     
  5. AndroidManifest.xml の <application> タグ内に下記を追記する。

    上記メタデータが無い場合、Ad SDK の API を呼び出すとアプリがクラッシュします。

必ず Google Play services がインポートされているか確認する に従い、Google Play services がリンクされているか確認して下さい。正しくインポート設定がされていてもリンクされないことがあります。

Google Play Service のインポートを行ない Proguard を使用する場合

Google Play Service をインポートした場合に Proguard を使用する場合、 proguard.cfg や proguard-android.txt に以下の設定をする必要があります。

Google Play services がインポートされているか確認する

Google Play services ライブラリの中の AdvertisingIdClient というクラスがインポートされているか、必ず以下の方法で確認します。

  • 生成した apk ファイルを apktool 等で開き、/smali/com/google/android/gms/ads/identifier/AdvertisingIdClient.smali が含まれているか確認する。
  • SDK を組み込んだ状態でアプリを起動し、$adb logcat で以下のいずれかのログが出力されないことを確認する。

上記 2 点の方法で 問題あることを確認した場合、以下の方法で解決することがあります。

  • google-play-services_lib プロジェクトのリンクを外して、google-play-services_lib プロジェクトに含まれている libs/google-play-services.jar をリンクする
  • Android SDK Tools や Android SDK Build-Tools のバージョンが古い場合、google-play-services_lib のバージョンを 4 系に下げることでリンクできるようになる可能性があります。
  • Invalid ApplicationInfo or MetaData がエラーログ出力された時には、AndroidManifest に meta-data が記載できていないので、application タグ内に meta-data を追加してください。
  • meta-data の value が google-play-services_lib のバージョンと異なっている可能性があります。AndroidManifest の meta-data の value を確認して下さい。

Mobage SDK を利用し、ProGuard を使用する場合
ProGuard を使用する場合は、proguard-project.txt に以下を追記するようにしてください。

また Mobage Native SDK 1.4.10 以降を使用する場合は、必ず proguard-project.txt に以下の設定も追記するようにしてください。

F.O.X for Mobage を利用し、かつ ProGuard を利用する場合

ProGuard を利用して F.O.X for Mobage を導⼊したアプリケーションを難読化する際に、警告が発生する場合があります。その際には、警告を回避するため以下の設定を追加してください。アノテーションが難読化の過程で削除されないよう、以下の設定がされていない場合には追加してください。

F.O.X SDK のコールバックメソッドが難読化対象とならないよう、以下の設定を追加してください。


更新履歴

  • 2014/08/20
    • Mobage Native SDK 1.4.7 リリースに伴い、新規作成

PREVIOUS

セットアップ (1.4.3 以降)

NEXT

セットアップ Android Studio (1.4.7 以降)