集成Appstore SDK
Appstore SDK提供了在Java Android应用中处理数字版权管理(DRM)和应用内购买(IAP)的功能。Appstore SDK支持面向Fire TV、Fire平板电脑,以及可安装亚马逊应用的第三方设备。
- 通过Appstore SDK提供的功能
- 可支持Appstore SDK的最低设备要求
- 下载Appstore SDK
- 转换至Appstore SDK
- 集成Appstore SDK的步骤
- 后续步骤
- 常见问题解答
通过Appstore SDK提供的功能
下表列出了Appstore SDK当前提供的功能。
功能 | 描述 |
---|---|
数字版权管理(DRM) | DRM,也常被称为“许可证验证”,用于解决开发者对未经授权复制和分发应用的后顾之忧。DRM主要用于付费应用。如果您的应用中已应用亚马逊DRM,则用户必须安装亚马逊应用商店客户端(Fire设备内置)且必须登录,才能访问该应用。集成到应用中的DRM方法将向亚马逊应用商店设备服务核实,确认用户是否拥有应用的有效许可证。如果用户未登录或不具备有效许可证,则应用将无法运行。不过,任何用户均可通过亚马逊购买应用,从而获得许可证。有关更多信息,请参阅在应用中强制实施DRM。您还可以浏览DRM示例应用。 |
应用内购买(IAP) | 通过应用内购买(IAP),用户可以在应用中购买数字商品,例如游戏中的额外生命,或是提升用户游戏体验的应用程序内商品(如货币、额外行动次数、生命、奖励关卡、小游戏等)。您的应用也可能提供能够访问特色内容的付费订阅。IAP会处理有关购买流程、付款处理、应用收据及权限管理的详细信息,这样您就不必为应用中的此类购买基础架构编写代码。有关更多信息,请参阅应用内购买概述。 |
可支持Appstore SDK的最低设备要求
Appstore SDK要求设备Android API级别为14或更高。
下载Appstore SDK
从SDK下载页面下载Amazon Appstore SDK。
转换至Appstore SDK
请参阅转换至Appstore SDK。
集成Appstore SDK的步骤
如需将Appstore SDK集成到Android项目中,请按照以下步骤操作:
步骤1: 使用公钥配置Appstore SDK
每个应用的公钥都是唯一的,它会在亚马逊应用商店和您的应用之间建立起安全的通信渠道。当您在开发者控制台中生成公钥时,亚马逊会生成相应的私钥。这些公钥和私钥会构成密钥对,用于签署许可证响应。通过这种密钥配对,您可以确保应用仅限授权用户安装。
要使用公钥配置现有应用,请执行以下操作:
- 使用开发者账户登录开发者控制台。
- 转到应用与服务>我的应用程序。单击您的应用。(如果您还没有应用,请参阅登录并添加应用。)
-
创建应用的新版本。在应用名称下方,单击即将推出的版本。
重要须知: 只有在您创建新版本或创建新应用时,才会显示公有密钥的链接。如果在Appstore SDK发布之前,您有一个新版本正在处理中,则必须完成现有版本,然后再创建一个新版本。只有这样才会显示公有密钥链接。(此外,您也可以提交有关应用的“联系我们”案例,请求取消即将推出的版本。) - 转到应用信息选项卡。
- 单击右上角区域的公有密钥。
-
在显示的“Public Key”对话框中,单击AppstoreAuthenticationKey.pem链接,下载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(项目)视图。
“Project”视图 -
展开app文件夹并打开应用的
build.gradle
文件。 -
将Amazon Appstore SDK插入
build.gradle
的依赖项部分,如下所示。dependencies { ... implementation 'com.amazon.device:amazon-appstore-sdk:3.+' }
注意: 上述示例介绍了如何使用主版本3获取最新的Amazon Appstore SDK。您还可以定义特定版本和/或通配符。由于存在不可预见的稳定性问题,通配符不适合用于上线项目。然而,针对最新版的Amazon Appstore SDK对项目进行调试或测试时,在版本声明中使用通配符会非常有用。用
+
替换版本号中的任意段,以使用最新的迭代:// 拉取并编译Amazon Appstore SDK的特定版本 implementation 'com.amazon.device:amazon-appstore-sdk:3.0.3' // 拉取并编译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(项目)视图。
“Project”视图 -
展开app文件夹并选择libs。(如果没有libs文件夹,请创建该文件夹)。将amazon-appstore-sdk-[x].jar文件粘贴到此目录中。
-
打开应用的build.gradle文件,并在amazon-appstore-sdk-[x].jar上添加依赖项。例如,如果JAR版本为3.0.3则代码如屏幕中所示
dependencies { implementation files('libs/amazon-appstore-sdk-3.0.3.jar') }
根据您使用的amazon-appstore-sdk-[x].jar版本自定义上述名称。
如果没有引用特定的JAR,而是有多个依赖项,可以按照下述方法更笼统地引用所有JAR:
dependencies { ... api fileTree(dir: 'libs', include: ['*.jar']) }
后续步骤
现在可以通过DRM API和IAP来使用应用中所需的功能。更多详细信息,请参阅以下主题:
常见问题解答
有关更多详细信息,请参阅以下主题中的常见问题解答: