亚马逊应用商店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() 方法中的Google BillingClient对象实例化。在同一时间，应用中只能存在一个BillingClient实例。
• 与应用内结算相关的所有业务逻辑都必须位于一个模块中，并在其中应用切面。不能将这些切面应用于多个模块。

添加切面和相关资源

请按照以下步骤将亚马逊应用商店Easy Port计费切面和相关资源添加到您的项目中。

1. 确定直接与Google Play结算库v5.2.1集成的模块，然后将Easy Port插件应用于该模块。相关说明请参阅应用并配置亚马逊应用商店Easy Port插件。
2. 配置插件并同步更改后，您可以在自己的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)，则必须按照以下说明手动添加切面。
   添加切面的替代方法

   您可以使用以下步骤手动下载和添加切面及资源。

   1. 在此处下载计费切面。

      亚马逊应用商店Easy Port计费切面

   2. 在模块的src文件夹中，添加包含切面文件的easyPort文件夹。
   3. 在此处下载计费注解文件。

      亚马逊应用商店Easy Port计费注解

   4. 在模块的主java文件夹中，添加包含注解的easyport文件夹。
   5. 下载亚马逊应用商店计费兼容性SDK，然后将JAR库文件复制到模块的libs文件夹中。如果对代码进行混淆处理，请按照IAP和代码混淆中的指导说明操作，确保IAP功能不受代码混淆影响。
3. 将上一步中下载的JAR文件添加到模块编译文件中的依赖项块中，如下所示。
   • Kotlin
     build.gradle.kts
   • Groovy
     build.gradle

   复制代码 已复制到剪贴板。

     easyPortImplementation(files("libs/appstore-billing-compatibility-<版本>.jar"))
   

   复制代码 已复制到剪贴板。

     easyPortImplementation(files("libs/appstore-billing-compatibility-<版本>.jar"))
   

   其中<版本>是下载的亚马逊应用商店计费兼容性SDK JAR文件的版本。
4. 在包含步骤2中切面的easyPort文件夹中，创建assets文件夹并添加AppstoreAuthenticationKey.pem文件。要获取PEM文件，请按照使用公钥配置Appstore SDK中的步骤操作。
5. 如果您的应用中存在订阅，请按照以下步骤操作。
   1. 在开发者控制台中添加您的订阅项目，并将其导出到JSON文件中。相关说明请参阅亚马逊应用商店计费兼容性订阅。
   2. 导出应用内商品列表后，将amazon.sdktester.json文件保存在easyPort文件夹下的assets文件夹中。
6. 如有任何冲突，请予以解决。
   重要须知： 亚马逊应用商店Easy Port可以查找、转换Google Play Billing API调用，并将其替换为Amazon IAP API调用。要成功构建，项目的Easy Port变种必须包含Google Play结算库和集成代码。可以在默认配置或特定于Easy Port的配置中添加此依赖项。

相关主题

• 亚马逊应用商店Easy Port
• 亚马逊应用商店Easy Port插件配置参考

---

Last updated: 2024年5月23日