集成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文件。该文件包含您的公有密钥。
-
复制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。
请按照以下说明操作:
-
返回至您的Android Studio项目。如果您的代码中已有较早版本的Amazon Appstore SDK,请将其移除。
-
在Android Studio中,更改为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(重建项目)。
如果按照上述步骤操作,则无需阅读下一部分。
备选步骤2: 手动将Appstore SDK添加到项目库中
将amazon-appstore-sdk-[x].jar添加到Android项目中:
-
在Android Studio中,更改为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日