集成Appstore SDK

要了解如何将Appstore SDK添加到您的项目，请使用本指南。

注意： 如果您之前使用的是IAP SDK v2.0，并且要转换至Appstore SDK，另请参阅IAP文档中的从IAP v2.0转换至Appstore SDK。

将Appstore SDK添加到您的项目
后续步骤
常见问题解答

将Appstore SDK添加到您的项目

如需将Appstore SDK集成到Android项目中，请按照以下步骤操作：

步骤1：使用公有密钥配置Appstore SDK
步骤2（建议）：使用Maven Central将Appstore SDK添加到项目中
或备选步骤2：手动将Appstore SDK添加到项目库中

步骤1：使用公有密钥配置Appstore SDK

每个应用的公有密钥都是唯一的，它会在亚马逊应用商店和您的应用之间建立起安全的通信渠道。当您在开发者控制台中生成公有密钥时，亚马逊会生成相应的私钥。这些公有密钥和私钥会构成密钥对，用于签署许可证响应。通过这种密钥配对，您可以确保应用仅限授权用户安装。

要使用公有密钥配置现有应用，请执行以下操作：

使用开发者账户登录开发者控制台。
转到应用与服务>我的应用。然后单击您的应用。如果您还没有应用，请参阅将应用提交到亚马逊应用商店。
创建应用的新版本。在应用名称下方，单击即将推出的版本。

重要须知： 只有在您创建新版本或创建新应用时，才会显示公有密钥的链接。如果在Appstore SDK发布之前，您有一个新版本正在处理中，则必须完成现有版本，然后再创建一个新版本。只有这样才会显示公有密钥链接。（此外，您也可以提交有关应用的“联系我们案例”，请求取消即将推出的版本。）
转到上传您的应用文件屏幕。
在Additional information（其他信息）部分，单击View public key（查看公有密钥）。
在显示的“Public Key”（公有密钥）对话框中，单击AppstoreAuthenticationKey.pem链接，下载PEM文件。该文件包含您的公有密钥。

PEM文件下载链接
复制AppstoreAuthenticationKey.pem文件。将其粘贴到Android Studio项目的app/src/main/assets文件夹中。

在“Project（项目）”视图中，资产文件夹通常位于app/src/main/assets中。如果您的应用没有资产文件夹，则必须创建该文件夹。然后将PEM文件拖到该文件夹中。

注意： 如果将应用与Login with Amazon (LwA) 或Amazon Device Messaging (ADM)集成，则需要添加应用的API密钥。集成了Appstore SDK的应用不会自动添加API密钥。您需要管理API密钥并查阅LwA和ADM文档以了解更多详情。可以在开发者控制台中查找亚马逊应用商店证书哈希值，为现有应用创建API密钥。转到我的应用程序 > 选择您的应用 > 上传您的应用文件 > 应用商店证书哈希值。

步骤2（建议）：使用Maven Central将Appstore SDK添加到项目中

借助Maven Central上的Amazon SDK发布功能，可以更轻松地在Android Studio中集成并更新Amazon Appstore SDK。Maven Central是构建工件的存储库。您可以直接将这些工件集成到Android Studio和Gradle开源构建自动化系统中。如果您的应用是使用Android Studio和Gradle开发的，则可以设置应用的build.gradle文件来集成Amazon Appstore SDK。这样，您的项目便始终可以使用最新版的SDK。

请按照以下说明操作：

如果您尚未完成此操作，请使用开发者账户登录开发者控制台并为应用下载公有密钥。
返回至您的Android Studio项目。如果您的代码中已有较早版本的Amazon Appstore SDK，请将其移除。
在Android Studio中，更改为Project（项目）视图。

“Project”视图
展开app文件夹并打开应用的build.gradle文件。
将Amazon Appstore SDK插入build.gradle的依赖项部分，如下所示。
```
 dependencies {
     ...
     implementation 'com.amazon.device:amazon-appstore-sdk:3.+'
 }
```
注意： 上述示例介绍了如何获取最新的Amazon Appstore SDK，主要版本为3。您还可以定义特定版本和/或通配符。由于存在不可预见的稳定性问题，通配符不适合用于上线项目。然而，针对最新版的Amazon Appstore SDK对项目进行调试或测试时，在版本声明中使用通配符会非常有用。用+替换版本号中的任意段，以使用最新的迭代：
```
 // 拉取并编译Amazon Appstore SDK的特定版本
 implementation 'com.amazon.device:amazon-appstore-sdk:3.0.5'

 // 拉取并编译Amazon Appstore SDK的最新3.x版本
 implementation 'com.amazon.device:amazon-appstore-sdk:3.+'

 // 拉取并编译Amazon Appstore SDK的最新版本
 implementation 'com.amazon.device:amazon-appstore-sdk:+'
```
下次构建应用时，此方法会将所有必要的文件导入到您的项目中。

请确保项目的顶级build.gradle已定义Maven Central存储库，否则请添加下列内容：

 allprojects {
     repositories {
         mavenCentral()
     }
     dependencies {
         ...
     }
 }

重建项目： Build（构建）> Rebuild Project（重建项目）。

重要须知： 请确保公有密钥位于项目的app/src/main/assets文件夹中。

如果按照上述步骤操作，则无需阅读下一部分。

备选步骤2：手动将Appstore SDK添加到项目库中

将amazon-appstore-sdk-[x].jar添加到Android项目中：

在Android Studio中，更改为Project（项目）视图。

“Project”视图
展开app文件夹并选择libs。（如果没有libs文件夹，请创建一个）。将amazon-appstore-sdk-[x].jar文件粘贴到此目录中。
打开应用的build.gradle文件，并在amazon-appstore-sdk-[x].jar上添加依赖项。例如，如果JAR版本为3.0.5，则代码如下所示：
```
dependencies {
    implementation files('libs/amazon-appstore-sdk-3.0.5.jar')
}
```
根据您使用的amazon-appstore-sdk-[x].jar版本自定义上述名称。

如果没有引用特定的JAR，而是有多个依赖项，可以按照下述方法更笼统地引用所有JAR：
```
dependencies {
    ...
    api fileTree(dir: 'libs', include: ['*.jar'])
}
```

后续步骤

现在可以通过IAP、DRM和SSI API来使用应用中所需的功能。更多详细信息，请参阅以下主题：

常见问题解答

有关更多详细信息，请参阅以下主题中的“常见问题解答”部分：

Last updated: 2024年3月15日