测试您的 Google Play 计费库集成

您应该在整个开发过程中测试您的集成。为了在开发阶段进行测试,我们建议利用许可证测试人员Play 计费实验室来完成本节中描述的场景。

许可证测试人员

要配置许可证测试人员,请参阅使用应用许可证测试应用内结算

使用许可证测试人员可提供以下优势

  • 通常,Google Play 计费库会阻止未签名且未上传到 Google Play 的应用。许可证测试人员可以绕过此检查,这意味着您可以对应用进行侧载以进行测试,即使是使用调试版本和调试签名的应用,也无需将应用上传到您的应用的新版本。请注意,包名称必须与配置为 Google Play 的应用的包名称匹配,并且 Google 帐户必须是 Google Play 管理中心帐户的许可证测试人员。
  • 许可证测试人员可以使用测试付款方式,避免为测试人员的购买支付实际费用。您还可以使用测试付款方式来模拟某些情况,例如付款被拒绝的情况。图 1 显示了这些测试形式的付款,它们出现在购买流程中。
  • 许可证测试人员可以快速测试订阅功能
license testers have access to test payment methods
图 1. 许可证测试人员可以使用测试付款方式。

以下是有关测试购买流程的一些其他详细信息

  • 测试购买使用与实际购买相同的应用购买流程。
  • 测试购买不计算税款。
  • Google Play 通过在购买对话框的中心显示通知来指示测试购买。

您可以通过展开购买对话框来确认正在进行购买的帐户。请注意以下事项

  • 测试帐户必须位于测试人员的 Android 设备上。
  • 如果设备上有多个帐户,则使用下载应用的帐户进行购买。
  • 如果没有帐户下载了应用,则使用第一个帐户进行购买。

在发布您的应用之前,您可以使用 Google Play 的测试轨道执行额外的验证。例如,您可以利用测试轨道让您的 QA 团队对新版本进行资格认证。

使用测试轨道,用户可以从 Google Play 安装您的应用并测试尚未公开发布的应用版本。用户可以使用 Google Play 中的任何付款方式进行实际购买。

要使用测试轨道测试您的 Google Play 计费库集成,请执行以下操作

  1. 将您的应用发布到测试轨道。请注意,在将应用发布到测试轨道后,可能需要几个小时才能使应用可供测试人员使用。
  2. 确保每个测试人员加入您的应用的测试。在您测试的加入 URL 上,您的测试人员可以看到有关成为测试人员的意义的说明以及一个加入链接。

您可以在任何运行 Android 1.6 或更高版本的 Android 设备上测试您的集成。设备上必须安装 Google Play 应用程序的最新版本。有关如何设置设备以用于开发 Android 应用程序的常规信息,请参阅 使用硬件设备

Play 结算实验室

Play 结算实验室是一个 Android 应用,可帮助开发者测试其与 Google Play 结算系统的集成。它为开发者提供了一种简单便捷的方式来测试结算功能,更快地集成并以更高的信心推出。您可以从 Play 商店 下载并安装 Play 结算实验室。

Play 结算实验室使您能够在测试中执行以下操作

Play Billing Lab Dashboard
图 2. Play 结算实验室仪表板。

测试一次性产品

测试消耗型产品

在测试消耗型产品时,我们建议测试各种情况,包括以下情况

  • 用户成功购买并收到商品。对于许可证测试人员,您可以使用 测试工具,始终批准 支付方式。
  • 用户购买商品,但支付方式无法收费,用户不应收到商品。对于许可证测试人员,您可以使用 测试工具,始终拒绝 支付方式。
  • 确保商品可以多次购买。

您还应验证购买是否按 处理购买 中所述的方式得到确认。对于来自许可证测试人员的购买,如果您的应用未确认购买,购买将在 3 分钟后退款,您将收到有关取消的电子邮件。您也可以查看 Google Play 管理中心的 订单 选项卡,查看订单是否在 3 分钟后退款。

测试非消耗型产品

非消耗型产品应与消耗型产品一样进行测试,但您应验证商品不能在您的应用中再次购买。请务必验证非消耗型产品和消耗型产品的购买确认(如适用),因为处理两种类型的购买的逻辑有所不同。

测试待处理的购买

您应测试待处理的购买,其中商品应在购买状态变为 PURCHASED 时授予。许可证测试人员可以使用两种测试工具来进行延迟支付方式,这些工具将在几分钟后自动完成或取消支付。

  1. 使用延迟支付方式“慢速测试卡,几分钟后拒绝”,如图 2 所示,进行购买。重新启动应用,验证购买尚未授予。

    test a purchase with a declined slow test card
    图 3. 测试使用拒绝的慢速测试卡进行购买。

  2. 使用延迟支付方式“慢速测试卡,几分钟后批准”,如图 3 所示,进行购买。等待几分钟,验证购买已授予。

    test a purchase with an approved slow test card
    图 4. 测试使用批准的慢速测试卡进行购买。

您可以在 处理待处理的交易 中找到更多信息。

测试订阅特定功能

一次性产品和订阅的购买流程相似,但订阅具有其他场景,例如成功或拒绝订阅续订。要测试续订,您可以使用许可证测试人员可用的 测试工具,始终批准测试工具,始终拒绝 支付方式,如图 1 所示。使用这些支付工具来测试超出成功订阅场景的场景。

与一次性产品类似,您还应验证购买是否按 处理购买 中所述的方式得到确认。对于来自许可证测试人员的购买,如果您的应用未确认购买,购买将在 3 分钟后退款,您将收到有关取消的电子邮件。您也可以查看 Google Play 管理中心的订单选项卡,查看订单是否在 3 分钟后退款。

续订期限

测试订阅的续订速度快于实际订阅,并且测试订阅最多可以续订六次,不包括免费试用和入门期。

下表列出了各种期限的订阅的测试续订时间。这些时间只是近似值。您可能会看到事件精确时间略有变化。为了弥补这种变化,请在每个订阅到期日期后调用 API 以查看当前状态。

生产订阅期限 测试订阅续订
1 周 5 分钟
1 个月 5 分钟
3 个月 10 分钟
6 个月 15 分钟
1 年 30 分钟

基于时间的订阅功能(如免费试用)在测试中也会缩短。下表列出了与基于时间的订阅功能相关的测试时间段。

功能 测试期限
购买确认 5 分钟
免费试用 3 分钟
入门价期限 与订阅测试期限相同
宽限期(3 天和 7 天) 5 分钟
账户保留 10 分钟
暂停(1 个月) 5 分钟
暂停(2 个月) 10 分钟
暂停(3 个月) 15 分钟

试用优惠

使用 Play 结算实验室试用优惠测试功能,许可证测试人员可以通过选中“测试免费试用或入门优惠”复选框并应用更改,无限次地测试和使用免费试用或入门优惠。这样就无需创建多个帐户来测试仅供新订阅者使用的试用优惠。

test trial offers
图 5. 测试试用优惠。

价格更改

您还可以使用 Play 结算实验室和许可证测试人员来测试 订阅价格更改,而不会影响其他活跃订阅者,方法是执行以下步骤

  1. 单击 仪表板订阅设置 卡片上的 管理
  2. 选择要测试的活跃订阅。
  3. 输入新价格。
  4. 根据您的测试要求选择或取消选中 用户选择退出 复选框。
  5. 单击 应用
test subscription price change
图 6. 测试订阅价格更改。

应用更改后,价格将从下次续订开始更新,仅针对测试人员更新。其他活跃订阅者不会受到影响。所有许可证测试人员规则都将应用于测试订阅。然后,测试人员可以测试其应用以了解由价格更改触发的下游流程,例如价格更改通知。

在计划测试期限时,请牢记以下事项

  • 由于许可证测试人员的续订期限较短,因此从管理中心进行的价格迁移可能不会在许可证测试人员中注册。为了确保可以测试价格更改通知和电子邮件,开发者应在触发价格更改后至少延迟一小时进行结算。
  • 降价没有通知期限。用户会在批次迁移后很快收到降价通知。这在测试时保持不变。
  • 对于涨价,测试通知时间与实际涨价的计算方式相同。
    • 用户将在强制性通知期限后的第一个结算周年纪念日首次收费。
    • 通知时间从首次收费日期倒计时计算。
    • 最后一个通知始终在收费前 1 分钟,无论结算期限如何。

下表显示了一些实际结算期限的测试结算和通知期限。

实际基本计划结算期限 测试结算期限 测试通知期限(具有 30 天通知期限的选择加入和选择退出区域) 测试通知期限(具有 60 天通知期限的选择退出区域)
1 周 5 分钟 5 分钟 10 分钟
1 个月 5 分钟 5 分钟 10 分钟
3 个月 10 分钟 3 分钟 6 分钟
6 个月 15 分钟 2 分钟 4 分钟
1 年 30 分钟 3 分钟 6 分钟

测试用例

通过单击 显示/隐藏 来扩展以下部分,以显示您应用来验证订阅集成的测试场景。

测试挂起的交易

您应该测试挂起的交易是否正确处理,并在购买状态变为PURCHASED时相应地更新权利。许可测试人员可以使用两种测试工具来进行延迟的支付方式测试,其中支付将在几分钟后自动完成或取消。

  1. 使用延迟支付方式“慢速测试卡,几分钟后拒绝”,如图 2 所示,进行购买。重新启动应用,验证购买尚未授予。

    test a purchase with a declined slow test card
    图 2. 使用拒绝的慢速测试卡测试购买。

  2. 使用延迟支付方式“慢速测试卡,几分钟后批准”,如图 3 所示,进行购买。等待几分钟,验证购买已授予。

    test a purchase with an approved slow test card
    图 3. 使用已批准的慢速测试卡测试购买。

测试促销代码

您可以使用 Google Play 管理中心 为自己的测试创建代码。请记住,您每个季度最多只能为应用中的所有托管产品创建 500 个促销代码。

您应该测试以下促销代码兑换场景

  • 在您应用中启动的购买对话框中输入促销代码时。
  • 在 Google Play 商店应用中兑换促销代码时。
  • https://play.google.com/store 上使用左侧导航栏中的“兑换”按钮兑换促销代码时。

在这些场景中,您应该尽可能多地测试兑换代码的方式。我们建议至少执行以下测试

  • 在安装应用之前兑换。
  • 在应用处于前台运行时兑换。请注意,对于此测试,您需要另一台设备来使用 Google Play 商店应用进行测试。请务必测试从应用中的不同屏幕进行兑换。
  • 多窗口模式下兑换,其中您的应用和 Google Play 商店应用同时显示。

对于每个测试,请确保正确检测到项目,并且用户已收到通知。

在不同的地区测试购买体验

您可以在使用或不使用 Play 计费实验室的情况下测试购买体验

使用

使用 Play 计费实验室 Android 应用,您可以在任何地区测试购买流程。但是,要使用 Play 计费实验室,您必须是许可测试人员。请按照以下步骤进行测试

  1. 注册应用计费用户为许可测试人员。
  2. 使用同一个用户登录 Play 计费实验室应用。
  3. 选择所需的国家/地区,并在 Play 计费实验室中应用更改。
  4. 在正在测试的应用中启动购买流程。
test purchase experience in different regions
图 7. 在不同的地区测试购买体验。

不使用

您也可以在任何地区测试购买流程,而不使用 Play 计费实验室。请按照以下步骤进行测试

  1. 创建一个新的 Gmail 帐户。该帐户可以在任何国家/地区创建。
  2. 您可以选择将用户设置为许可测试人员。
  3. 使用 VPN 连接到您要测试的国家/地区。
  4. 启动购买流程。

您可以清除 Play 商店数据和缓存,然后使用任何您想要测试的国家/地区重复步骤 #3 和 #4。切换到新的国家/地区后,您需要清除 Google Play 商店的数据以删除与先前国家/地区相关的数据。

这两种测试购买方法都允许您测试优惠区域资格和用户体验,无论您在物理上进行测试的地区是什么。