获取和存储您的API密钥

Amazon Device Messaging (ADM) 和Firebase Cloud Messaging (FCM) 都要求您能够对应用进行唯一标识。使用Firebase，可以生成一个名为google-services.json的配置文件，并将其添加到应用中。使用ADM时，必须生成API密钥并将其包含在项目中。还必须生成OAuth安全配置文件凭证。

这些凭证的用途如下所示：

• API密钥。 ADM使用API密钥验证您应用的身份。
• OAuth凭证（“客户端ID”和“客户端密钥”）。 ADM使用OAuth凭证来验证您服务器的身份。您的服务器将提供这些凭证，以获取使用ADM发送消息的访问令牌。

以下说明提供了关于如何获取凭证的详细信息。

• 获取您的API密钥和凭证
• 存储您的API密钥
• 后续步骤

获取您的API密钥和凭证

1. 在开发者控制台中创建一个账户，然后添加您的应用（如果尚未执行这些操作）。

2. 前往应用与服务 > 我的应用程序，然后选择要对其使用ADM的应用。

3. 在边栏中，单击应用服务。

4. 在亚马逊设备消息发送部分，单击选择现有安全配置文件或新建。（如果您已经为应用分配了安全配置文件，请展开附加安全配置文件和相关详细信息部分，然后继续执行步骤7。）

5. 要为应用分配安全配置文件，请从安全配置文件下拉菜单中选择现有安全配置文件，或单击创建安全配置文件以创建新的配置文件。安全配置文件提供通过ADM发送消息时您所使用的OAuth凭证。

   注意： 您可以在多个应用之间共享安全配置文件。通过共享配置文件，应用可以共享某些类型的数据。例如，您可能有一个“My Cat - Free”应用和一个“My Cat - HD”应用。如果您将单个安全配置文件应用于这两个应用，则由该配置文件访问的数据对这两个应用均可用。对于共享配置文件，请选择一个适用于这两者的名称，例如“My Cat Apps profile”。

6. 选择现有安全配置文件后，单击启用安全配置文件以保存更改。

   此时将显示一条成功消息，提示“使用‘安全配置文件名称’安全配置文件在您的应用上成功启用了设备消息传递”。

7. 单击查看安全配置文件链接。然后在安全配置文件管理下，单击安卓/Kindle设置。

8. 单击添加API密钥按钮以创建API密钥。您的应用需要一个或多个API密钥。

   • 调试应用签名： 在所有情况下，必须为应用的调试版本创建一个API密钥，以便测试应用使用ADM的情况。

   • 发布版本应用签名： 如果应用使用Appstore SDK，则必须为应用的发布版本创建额外的API密钥。如果使用较旧的IAP SDK v2.0，并使用自己的证书为应用签名，您还必须为应用的发布版本创建API密钥。反之，如果使用IAP SDK v2.0，或者完全不使用应用内购买SDK，并且允许亚马逊代表您为应用签名，则无需创建额外的API密钥。如需查看摘要，请参阅下表：

     确定是否需要为发布版本应用创建API密钥。

     使用Appstore SDK的应用	用您自己的证书签名的应用	需要API秘钥？
     		是
     		是
     		是
     		否

   要创建API密钥，必须提供API密钥的名称、应用的程序包名称（例如com.mycompany.bestapplication），以及应用签名的MD5和SHA-256值：

   • 调试应用签名（用于应用的预发布版本）： 可以通过执行以下操作之一，获取用于为应用的调试版本签名的证书的MD5或SHA-256签名：

     • 找到用于对应用进行签名的密钥库文件，以及密钥库文件中用于签名的证书的别名。例如，如果密钥库文件名为my_key_store，而密钥库中用于签名的证书名为my_certificate_alias，则应运行以下命令：

       {JAVA_HOME}/bin/keytool -list -v -alias my_certificate_alias -keystore my_keystore_file
       

       输出应包含类似如下的MD5或SHA-256值。这便是您的应用签名。

       MD5: 2E:0B:46:F8:D0:4A:06:AC:18:7A:2E:B0:42:95:58:FE`
       
       SHA-256: 34:A3:65:30:3E:B2:9B:30:DD:10:E8:87:79:16:DF:4C:61:77:BC:1F:80:BD:3F:12:39:A3:31:E6:68:19:1C:6F
       

     • 或者，如果您的应用采用的是已签名APK形式，而您正在类似Unix的系统上进行开发，则可以改为运行以下命令。请注意，必须将{your-app.apk}替换为APK文件的名称。

       MD5:

       unzip -p {your-app.apk} META-INF/CERT.RSA | keytool -printcert | grep MD5
       

       SHA-256:

       unzip -p {your-app.apk} META-INF/CERT.RSA | keytool -printcert | grep SHA-256
       

     • 或者，如果您使用的是Android Studio，请单击右侧的Gradle侧窗格并展开。然后展开app（应用）> Tasks（任务）> android，并双击signingReport（签名报告）。

       提供返回的MD5和SHA-256输出。

   • 发布应用签名（适用于生产版本的应用）：

     • 如果使用自己的证书为应用的发布版本签名，请提供该证书的MD5和SHA-256签名以创建额外的API密钥。
     • 如果不使用自己的证书，要获得MD5和SHA-256签名，请执行以下操作：
       1. 转到开发者控制台。
       2. 选择应用与服务>我的应用程序。
       3. 选择您的应用。
       4. 转到上传您的应用文件屏幕。
       5. 选择应用商店证书哈希值。
     • 您可能不需要API密钥，有关详细信息，请参阅确定是否需要为发布版本应用创建API密钥中的表格。

9. 单击添加。

10. 获取客户端凭证（调用ADM服务器时需要）。在“安全配置文件管理”下，单击Web设置选项卡。在此页面可找到客户端ID和客户端密钥。

存储您的API密钥

对于应用的预发布或“调试”版本，必须创建API密钥并将其存储在项目中。要在您的应用中添加API密钥：

1. 在项目的assets文件夹内创建一个名为api_key.txt的文件。必须将该文件放置在此特定目录中。
2. 插入API密钥作为此api_key.txt文件中的唯一数据。

对于应用的发布或“生产”版本，如果应用使用Appstore SDK，则必须为应用的发布版本创建额外的API密钥。如果使用较旧的IAP SDK v2.0，并使用自己的证书为应用签名，您还必须为应用的发布版本创建API密钥。反之，如果使用IAP SDK v2.0，或者完全不使用应用内购买SDK，并且允许亚马逊代表您为应用签名，则无需创建额外的API密钥。若需摘要，请参阅确定是否需要为发布应用创建API密钥中的表格。

后续步骤

转到下一步： 注册和消息处理.

---

Last updated: 2023年10月2日