安装 Amazon Device Messaging


安装 Amazon Device Messaging

要对您的应用使用 Amazon Device Messaging (ADM),您首先需要在开发环境中包含 ADM JAR。可以通过不同的方式实现此目的:

  • 使用 Android Studio。
  • 使用 Eclipse,这是一种开源集成开发环境 (IDE)。
  • 使用命令行。

如果您尚未准备就绪,请参阅概览大致了解 ADM 架构。获取凭证介绍了为 ADM 获取您的初始凭证的过程。

要在您的项目中使用 ADM,请在开发计算机上安装以下内容:

在配置您的项目之前,下载 Amazon Mobile App 开发工具包。​下载 Amazon Mobile App 开发工具包即表示您同意程序材料许可协议。将该开发工具包的内容提取到您所选的位置。

将 ADM 添加到您的 IDE 项目

要对基于 IDE 的项目使用 ADM,请将 ADM 库作为外部 JAR 添加到该项目中。尽管您可以在任意开发环境中使用 ADM,但以下几节介绍了如何将 ADM 添加到 Android Studio 或 Eclipse。​

将 ADM 添加到 Android Studio

确保您已下载并安装 Android Studio 的当前版本。

  1. 在 Android Studio 中,创建一个新的 Android 项目,或打开一个现有项目。
  2. 将文件夹结构从 Android 更改为 Project

    change-folder-structure
    在 Android Studio 中更改文件夹结构
  3. app 文件夹内搜索 libs 文件夹。

    find-libs-in-apps-folder
    在 apps 文件夹中查找 libs 文件夹
  4. 从提取了 ADM zip 文件的位置复制 amazon-device-messaging-1.0.1.jar 文件。
  5. 将该 JAR 粘贴到 libs 文件夹。

    paste-jar-in-libs
    将该 jar 文件粘贴到 libs 中
  6. 右键单击该 JAR 文件,最后单击 Add as library(添加为库)。​

    add-library
    将 jar 文件添加为库

    这会自动将 compile files('libs/amazon-device-messaging-1.0.1.jar') 命令添加到 build.gradle 文件。

  7. 最后,由于亚马逊设备将具有必要的类和方法,您仅在编译时而不是在运行时需要库,因此请将该命令行从编译文件更改为所提供的文件。将以下代码:

    dependencies {
        compile files('libs/amazon-device-messaging-1.0.1.jar')
    }
    

    更改为以下代码:

    dependencies {
        provided files('libs/amazon-device-messaging-1.0.1.jar')
    }
    

将 ADM 添加到 Eclipse

确保您已安装 Android Development Tools (ADT) Plugin for Eclipse。​

  1. 在 Eclipse 中,创建一个新的 Android 项目,或打开一个现有项目。
  2. 打开项目的属性;例如,右键单击项目的根文件夹,然后单击 Properties(属性)。
  3. 从属性列表中,选择 Java Build Path(Java 生成路径)。选择 Libraries(库)选项卡。

  4. 单击 Add External JARs…(添加外部 JAR),然后导航到提取了 ADM zip 文件的位置。
  5. 打开 DeviceMessaging/lib 文件夹,选择 amazon-device-messaging-1.0.1.jar 文件,然后单击 Open(打开)。
  6. 现在您应看到 amazon-device-messaging.jar 列在“Properties”(属性)窗口中。单击 OK(确定)。​

    在项目“Package Explorer”(程序包管理器)的 Referenced Libraries(引用的库)下,现在应显示 amazon-device-messaging.jar

从命令行添加 ADM

在执行此过程之前,请更新 AndroidManifest.xml 文件,如集成您的应用中所述。此外,还需要确保已安装 Apache ANT,并且已正确定义 ANT_HOMEJAVA_HOMEPATH 环境变量。

  1. 将当前目录更改为 Android 开发工具包的 tools/ 路径。
  2. 使用以下语法运行一个命令,其中 <path> 是将创建项目的位置,<target Android platform> 是项目要加入的 Android 平台。要获取可用平台的列表,请运行 android list targets

    android create project â€"-path <path> --target <target Android platform> â€"-activity ADMActivity â€"-package com.example.amazon.adm
    
  3. 在新项目的根目录处,创建一个名为 ext_libs 的新目录。
  4. 导航到 Android/DeviceMessaging/lib 目录,然后在“Amazon Mobile App SDK”中,将 JAR 文件复制到新的 ext_libs 目录中。
  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.cfg 文件并添加以下配置:

#This should point to the directory where ADM's JAR is stored
-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