开发者控制台

亚马逊应用商店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() 方法中的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]
          

    添加切面的替代方法

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

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

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

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

     

    复制到剪贴板。

      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. 如有任何冲突,请予以解决。

Last updated: 2024年5月23日