開発者コンソール
ログイン
ログイン
開発者コンソール

Amazon Device Messaging（ADM）のセットアップ方法

Amazon Device Messaging（ADM）のセットアップ方法

アプリでAmazon Device Messaging（ADM）を使用するには、まずADM JARを開発環境に組み込む必要があります。Android Studioまたはコマンドラインを使用して、組み込みを行ってください。

前提条件

ADMアーキテクチャの概要については、Amazon Device Messaging（ADM）についてを参照してください。ADMの初期認証情報を取得するプロセスは、認証情報の取得方法に記載されています。

プロジェクトでADMを使用するには、開発用コンピューターに以下をインストールします。

  • Android SDK（API 15以降）
  • Android SDKのシステム要件（JDKなど）

上記のリソースは、Android Studioのインストール時に既に含まれています。

ADMをAndroid Studioに追加する方法

IDEベースのプロジェクトでADMを使用するには、ADMライブラリを外部JARとしてプロジェクトに追加します。ADMはどの開発環境でも使用できますが、このセクションではADMをAndroid Studioに追加する方法について説明します。追加方法は以下のとおりです。

  1. Amazon Device Messaging（ADM）SDKのダウンロードを行い、zipフォルダをアクセスしやすい場所に展開します。
  2. 必ずAndroid Studioの最新バージョンをダウンロードし、インストールしておいてください。
  3. Android Studioで新規Androidプロジェクトを作成するか、既存のプロジェクトを開きます。

  4. フォルダ構造をAndroidからProjectに変更します。

    change-folder-structure

  5. appフォルダでlibsフォルダを見つけます。

    find-libs-in-apps-folder
  6. ADMのzipファイルを展開した場所からamazon-device-messaging-1.1.0.jarファイルをコピーします。

  7. jarファイルをlibsフォルダに貼り付けます。

    paste-jar-in-libs

  8. jarファイルを右クリックし、[Add as library] を選択します。

    add-library

    これにより、自動的にimplementation files('libs/amazon-device-messaging-1.1.0.jar')コマンドがbuild.gradleファイルに追加されます。

  9. 最後に、ライブラリは実行時ではなくコンパイル時にのみ必要になるため、次の宣言でimplementationをcompileOnlyに変更します。変更前：

    dependencies {
    implementation files('libs/amazon-device-messaging-1.1.0.jar')
}

    変更後：

    dependencies {
    compileOnly files('libs/amazon-device-messaging-1.1.0.jar')
}

コマンドラインからADMを追加する方法

この手順を実行する前に、アプリの統合方法の説明に従って、AndroidManifest.xmlファイルを更新します。また、Apache ANTがインストールされていることを確認します（環境変数のANT_HOME、JAVA_HOME、PATHが、正しく定義されている必要があります）。

  1. ディレクトリをAndroid SDKのtools/パスに変更します。

  2. 以下の構文を使用してコマンドを実行します。ここで、<パス>はプロジェクトを作成する場所、<ターゲットのAndroidプラットフォーム>はプロジェクト用のAndroidプラットフォームを表します。利用可能なプラットフォームの一覧を表示するには、android list targetsを実行します。

    android create project --path <パス> --target <ターゲットのAndroidプラットフォーム> --activity ADMActivity --package com.example.amazon.adm
  3. 新規プロジェクトのルートで、ext_libsという名前の新しいディレクトリを作成します。
  4. Amazon Mobile App SDKのAndroid/DeviceMessaging/libディレクトリに移動し、新しいext_libsディレクトリにjarファイルをコピーします。

  5. 新規プロジェクトのルートでcustom_rules.xmlファイルを作成します。このファイルの内容は次のとおりです。

    <?xml version="1.0" encoding="UTF-8"?>
<project name="custom_rules">
<path id="java.compiler.classpath.path">
<fileset dir="ext_libs" includes="*.jar"/>
</path>
<property name="java.compiler.classpath" refid="java.compiler.classpath.path" />
</project>

  6. プロジェクトをビルドするには、プロジェクトのルートディレクトリで次のコマンドを実行します。

    ant debug

アプリをテストするプロジェクトを構成する際も、必ず同様の手順を実行します。

Proguardを構成する

Proguardを使用する場合は、proguard-rules.proファイルを編集して次の構成を追加します。

#ADMのjarファイルが格納されたディレクトリを指す必要があります
-libraryjars libs
-dontwarn com.amazon.device.messaging.**
-keep class com.amazon.device.messaging.** {*;}
-keep public class * extends com.amazon.device.messaging.ADMMessageReceiver
-keep public class * extends com.amazon.device.messaging.ADMMessageHandlerBase
-keep public class * extends com.amazon.device.messaging.ADMMessageHandlerJobBase