as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
AWS
ドキュメント
Support
Contact Us
My Cases
開発
テスト
公開
収益化
ユーザーエンゲージメント
デバイスの仕様
リソース

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. 最後に、ライブラリは実行時ではなくコンパイル時にのみ必要になるため、次の宣言でimplementationcompileOnlyに変更します。変更前:

    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_HOMEJAVA_HOMEPATHが、正しく定義されている必要があります)。

  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