亚马逊应用商店Easy Port计费切面
亚马逊应用商店Easy Port计费切面
重要须知: 亚马逊应用商店Easy Port目前处于开发者预览版阶段。
如果您的应用使用Google Play Billing并与Google Play结算库版本5.2.1集成,则可以在应用中使用亚马逊应用商店Easy Port计费切面,将应用移植到Fire OS。Easy Port计费切面针对Google Play结算库v5.2.1,将该库的API调用替换为来自亚马逊应用商店计费兼容性v4.1.0的调用。
要求
- 应用不得已与亚马逊应用内购买 (IAP) API集成。应用不得通过Appstore SDK或亚马逊应用商店计费兼容性SDK使用Amazon IAP。
- 应用必须与亚马逊应用商店Easy Port插件集成。有关集成步骤,请参阅集成亚马逊应用商店Easy Port插件。
- 应用的目标API级别必须为24或更高,即应用必须启用Java8+ API的desugaring。
- 在主UI线程中的活动中,应用必须将
onCreate()
方法中的GoogleBillingClient
对象实例化。在同一时间,应用中只能存在一个BillingClient
实例。 - 与应用内结算相关的所有业务逻辑都必须位于一个模块中,并在其中应用切面。不能将这些切面应用于多个模块。
添加切面和相关资源
请按照以下步骤将亚马逊应用商店Easy Port计费切面和相关资源添加到您的项目中。
- 确定直接与Google Play结算库v5.2.1集成的模块,然后将Easy Port插件应用于该模块。相关说明请参阅应用并配置亚马逊应用商店Easy Port插件。
- 配置插件并同步更改后,您可以在自己的gradle任务的
easy Port
组下找到一个名为AspectDownloadTask
的任务。运行此任务会下载所需的切面并将资产复制到相应的文件夹,如下所示:- src/easyPort - 包含切面类的文件夹
- src/main/java/easyport - 包含Easy Port注释的文件夹
libs/appstore-billing-compatibility-<版本>.jar - 亚马逊应用商店计费兼容性SDK JAR文件
要查找亚马逊应用商店计费兼容性SDK JAR文件的路径,请查看
AspectDownloadTask
日志。
示例日志:将以下库添加到build.gradle中的依赖项块中。 [libs/appstore-billing-compatibility-4.1.0.jar]
注意: 如果您未在模块中使用标准Android文件夹结构 (src/main/java),则必须按照以下说明手动添加切面。添加切面的替代方法您可以使用以下步骤手动下载和添加切面及资源。
- 在此处下载计费切面。
- 在模块的src文件夹中,添加包含切面文件的easyPort文件夹。
- 在此处下载计费注解文件。
- 在模块的主java文件夹中,添加包含注解的easyport文件夹。
- 下载亚马逊应用商店计费兼容性SDK,然后将JAR库文件复制到模块的libs文件夹中。如果对代码进行混淆处理,请按照IAP和代码混淆中的指导说明操作,确保IAP功能不受代码混淆影响。
- 将上一步中下载的JAR文件添加到模块编译文件中的依赖项块中,如下所示。
easyPortImplementation(files("libs/appstore-billing-compatibility-<版本>.jar"))
easyPortImplementation(files("libs/appstore-billing-compatibility-<版本>.jar"))
<版本>
是下载的亚马逊应用商店计费兼容性SDK JAR文件的版本。 - 在包含步骤2中切面的easyPort文件夹中,创建assets文件夹并添加AppstoreAuthenticationKey.pem文件。要获取PEM文件,请按照使用公有密钥配置Appstore SDK中的步骤操作。
- 如果您的应用中存在订阅,请按照以下步骤操作。
- 在开发者控制台中添加您的订阅项目,并将其导出到JSON文件中。相关说明请参阅亚马逊应用商店计费兼容性订阅。
- 导出应用程序内商品列表后,将amazon.sdktester.json文件保存在easyPort文件夹下的assets文件夹中。
- 如有任何冲突,请予以解决。
重要须知: 亚马逊应用商店Easy Port可以查找、转换Google Play Billing API调用,并将其替换为Amazon IAP API调用。要成功构建,项目的Easy Port变种必须包含Google Play结算库和集成代码。可以在默认配置或特定于Easy Port的配置中添加此依赖项。
相关主题
Last updated: 2024年5月23日