开发者控制台

集成Appstore SDK

集成Appstore SDK

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

将Appstore SDK添加到您的项目

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

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

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

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

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

  4. 转到上传您的应用文件屏幕。
  5. Additional information(其他信息)部分,单击View public key(查看公有密钥)。
  6. 在显示的“Public Key”(公有密钥)对话框中,单击AppstoreAuthenticationKey.pem链接,下载PEM文件。该文件包含您的公有密钥。

    显示公有密钥字符串的“公有密钥”窗口。显示一个下载图标,后接链接文本“AppstoreAuthenticationKey.pem”。
    PEM文件下载链接
  7. 复制AppstoreAuthenticationKey.pem文件。将其粘贴到Android Studio项目的app/src/main/assets文件夹中。

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

步骤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。

请按照以下说明操作:

  1. 如果您尚未完成此操作,请使用开发者账户登录开发者控制台并为应用下载公有密钥

  2. 返回至您的Android Studio项目。如果您的代码中已有较早版本的Amazon Appstore SDK,请将其移除。

  3. 在Android Studio中,更改为Project(项目)视图。

    “Project”视图
    “Project”视图
  4. 展开app文件夹并打开应用的build.gradle文件。

  5. 将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:+'
    

    下次构建应用时,此方法会将所有必要的文件导入到您的项目中。

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

     allprojects {
         repositories {
             mavenCentral()
         }
         dependencies {
             ...
         }
     }
    
  7. 重建项目: Build(构建)> Rebuild Project(重建项目)

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

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

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

  1. 在Android Studio中,更改为Project(项目)视图。

    “Project”视图
    “Project”视图
  2. 展开app文件夹并选择libs。(如果没有libs文件夹,请创建一个)。将amazon-appstore-sdk-[x].jar文件粘贴到此目录中。

  3. 打开应用的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: 2023年12月4日