メインコンテンツまでスキップ

测试您的应用内购买(沙盒环境)

要在 Aptoide Connect 上分发包含应用内购买(IAP)的应用,您的应用需要实现我们的计费解决方案,即 Android Billing SDK

实现之后,您需要测试应用的 IAP,看看集成是否正常工作。为此,我们开发了一个沙盒环境,供您测试 IAP。

要测试您应用的 IAP,您需要:

  1. 下载 Aptoide Wallet 应用。 2.(可选)创建一个专门用于测试的新 Wallet 地址。
  2. 将您的测试 Wallet 地址添加到开发者控制台上的沙盒菜单中。
  3. 使用该测试 Wallet 地址在您的应用上进行购买。
⚠️
必须拥有应用的所有权才能使用沙盒环境

要能够在 Aptoide Wallet 上看到沙盒环境并测试您应用的应用内购买,您必须在 Aptoide Connect 上拥有您应用的所有权。

只有在您将应用添加到账户并成功证明应用所有权之后,您才能看到沙盒环境(在 Aptoide Wallet 上显示为一种支付方式)。要了解如何执行此操作,请点击此处

(可选)创建测试 Wallet 地址

下载 Aptoide Wallet 应用后,您将已经拥有一个默认的、归属于您的主 Wallet 地址。但是,如果您愿意,也可以拥有一个专门用于测试的 Wallet 地址。

要创建新的 Wallet 地址:

  • 访问 Aptoide Wallet;
  • 点击屏幕右上角的齿轮,进入 Wallet 的设置菜单;
  • 点击"Manage Wallet";
  • 在右侧"Manage Wallet"旁边,点击 3 个点 >"New Wallet";
  • 为新 Wallet 命名 > 点击"Submit"。

使用沙盒环境

要访问沙盒菜单,请进入您的 Aptoide Connect 开发者控制台并点击 Apps > Sandbox。

Aptoide Connect 开发者控制台中的沙盒菜单

在此菜单中,您可以添加专门用于测试的 Wallet 地址、查看已添加到账户的所有 Wallet 地址并对其进行管理。

要添加新的测试 Wallet 地址,请点击"Add",将专门用于在沙盒环境中进行测试的 Wallet 地址粘贴进去,然后点击"Add"。

沙盒菜单中的"Added"列指 Wallet 地址添加到 Aptoide Connect 账户的时间。"Expiration"列说明 Wallet 地址将于何时自动设置为非活动状态。最后,"Active"列是您可以切换并更改某个特定 Wallet 地址是否可以使用沙盒环境的地方。

包含状态列和有效期列的沙盒 Wallet 地址列表
📘
添加到沙盒菜单 30 天后,Wallet 地址将自动设置为"Inactive"

当 Wallet 地址添加到沙盒菜单时,其切换开关将设置为"Active",以便可以在沙盒环境中使用。30 天后,此切换开关将自动更改,测试 Wallet 地址将设置为"Inactive"。

当其处于非活动状态时,该 Wallet 地址将成为常规 Wallet,无法在沙盒环境中使用。要再次将其用于测试,您需要再次将切换开关更改为"Active"。

通过查看"Expiration"列中的日期,可以了解 Wallet 地址将于何时自动设置为非活动状态。

或者,您也可以在应用提交表单中访问沙盒菜单。

可从应用提交表单访问的沙盒菜单
❗️
必须配置登录确认才能使用沙盒环境

请注意,为了使用沙盒环境测试您应用的应用内购买,必须配置并激活登录确认。要了解如何执行此操作,请点击此处

测试应用内购买

在 Aptoide Connect 上添加 Wallet 地址后,您可以按照以下步骤在应用内测试应用内购买:

  • 在您的应用上选择您想购买的项目;
  • 向下滚动并选择 Sandbox 选项以继续购买。
移动设备上应用内购买期间的沙盒支付选项

购买完成后,您的屏幕上将显示一条弹出消息,说明购买已完成。要确认您的应用内购买已成功完成,请访问 Aptoide Connect 控制台顶部菜单栏上的 Wallet,并勾选"Only display sandbox transactions"选项:

启用了沙盒交易筛选器的 Wallet 页面

在那里,您将能够看到在沙盒环境中进行的交易列表,并看到您刚刚进行的购买。此外,请在您的应用上检查是否已收到该项目。

如果您能够完成购买、正确收到项目且未发生错误,那么您就已成功集成了我们的计费解决方案!

沙盒特有行为

沙盒环境复现了实时计费系统,但为了让您能更快地测试,特意设置了几处差异。

购买确认和消费时间限制

在沙盒环境中,确认或消费购买的时间限制为 5 分钟,而非实时计费系统中使用的 2 天。

如果在此时间窗口内未确认或消费某笔购买,该购买将被自动退款。这一缩短的限制让您可以在发布应用之前,快速测试失败场景(例如,未确认的购买被撤销)。

如需了解如何确认和消费购买,请参阅 Android Billing SDK 集成指南。

沙盒订阅续订周期

🚧
功能开发中

应用内订阅目前正在开发中,即将发布。以下信息描述的是即将推出的沙盒体验,可能会在正式发布前有所变动。

在沙盒环境中测试订阅时,续订周期会被缩短,因此您无需等待完整的计费周期即可看到续订。我们采用与 Google Play Billing – Test renewals 相同的值:

生产环境订阅周期沙盒续订周期
1 周5 分钟
1 个月5 分钟
3 个月10 分钟
6 个月15 分钟
1 年30 分钟
📘

在沙盒环境中,订阅最多续订 6 次,之后将被自动取消。续订时间为近似值,因此可能会有小幅波动。

常见问题

在沙盒中测试之前,我需要准备什么吗?

简短回答: 需要。请先添加您的应用内商品和一个测试 Wallet。

详情: 在 Android 上测试之前,请按上文所述,在 Aptoide Connect 控制台中添加您的应用内商品,并将测试 Wallet 地址添加到沙盒环境中。只有这样,您才能从应用中完成沙盒购买。

为什么我的沙盒购买被退款了?

简短回答: 因为它未在 5 分钟内被确认或消费。

详情: 请参阅购买确认和消费时间限制。在沙盒环境中,您有 5 分钟的时间来确认或消费购买(而非实时系统中的 2 天);否则该购买将被自动退款。这是预期行为,可让您快速测试未确认购买的场景。