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

测试您的应用内购买（沙盒环境）

要在 Aptoide Connect 上分发带有应用内购买（IAP）的 iOS 应用程序，您的应用需要实现我们的计费解决方案。您可以选择集成我们的 Swift SDK 或我们的 Unity 插件。

实现这两种解决方案中的任意一种后，您需要测试应用的 IAP 并查看集成是否正常工作。因此，我们开发了一个沙盒环境供您测试 IAP。

要测试应用的 IAP，您需要：

  1. 获取您的测试钱包地址。
    在 Swift 中，您可以通过调用以下方法实现： 
    Sandbox.getTestingWalletAddress()
    在 Unity 中： 
    AppCoinsSDK.Instance.GetTestingWalletAddress()
  2. 将您的测试 Wallet 地址添加到开发者控制台的沙盒菜单中。
  3. 使用该测试 Wallet 地址在您的应用上进行购买。
🚧
将帐户关联到沙盒钱包

了解钱包类型：

  • 默认情况下，SDK 使用访客钱包（临时且特定于设备）
  • 调用 .getTestingWalletAddress() 会返回当前活动的钱包地址

要使用持久的沙盒钱包：

  1. 在您的应用中发起任意购买
  2. 当结账界面出现时登录某个帐户
  3. 登录后，您的帐户将与一个永久钱包关联
  4. 此后，.getTestingWalletAddress() 将返回此帐户的钱包地址

优势：

  • 您的沙盒钱包会在应用多次启动之间保持持久
  • 通过登录同一帐户，您可以在多台设备上访问同一钱包
  • 更易于管理和重复使用沙盒资金进行测试
🚧
必须拥有应用的所有权才能使用沙盒环境

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

只有在您将应用添加到帐户并成功证明应用所有权后，您才能看到沙盒环境（在 Aptoide Wallet 上显示为一种支付方式）。

使用沙盒环境​

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

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

​

在此菜单中，您将能够添加专用于测试的 Wallet 地址，查看添加到帐户的所有 Wallet 地址，并对其进行管理。

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

​

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

带有状态和有效期列的沙盒钱包地址列表
📘
添加到沙盒菜单 30 天后，Wallet 地址会被自动设置为"Inactive"

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

当它处于非活动状态时，Wallet 地址将变为普通钱包，无法在沙盒环境中使用。要再次将其用于测试，您需要再次将切换开关更改为 "Active"。

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

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

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

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

测试应用内购买​

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

  • 在您的应用上选择要购买的商品；
  • 向下滚动并选择 Sandbox 选项以继续购买。
移动端应用内购买期间的沙盒支付选项

​

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

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

在那里，您将能够看到在沙盒环境中进行的交易列表，并看到您刚刚进行的购买。同时，请在您的应用上检查是否已收到商品。

如果您能够完成购买、正确收到商品且没有发生错误，那么您就已成功集成了我们的计费解决方案！

常见问题（FAQ）​

在沙盒中测试之前需要先上传我的应用吗？​

简短回答： 不需要，在 iOS 上您可以直接从 Xcode 构建进行测试。

详情： iOS 应用内购买可以直接从 Xcode 构建在沙盒中进行测试，无需事先上传。（在 Android 上，流程有所不同：您需要先在 Aptoide Connect 控制台中添加应用内商品，并将钱包添加到沙盒环境。请参阅测试您的应用内购买。）

我可以在 Simulator 上运行 iOS 沙盒测试吗？​

简短回答： 不可以，测试计费分支（Apple IAP 与 Aptoide 计费）需要使用实体设备。

详情： 用于识别安装来源的 Apple AppDistributor 框架在 Simulator 上不可用，因此 .isAvailable() 在那里始终返回 true。因此，您无法在 Simulator 上验证 Apple 应用内购买与 Aptoide 计费之间的分支；请使用实体设备。

如何为沙盒测试购买退款？​

简短回答： 沙盒测试购买的退款是手动进行的。

详情： 将交易 UID 分享给 Aptoide 支持团队并申请退款。

常见疑难​

无法选择 iOS 沙盒环境​

简短回答： 您的测试钱包未处于活动状态。

如何修复： 在开发者控制台的 Sandbox 部分中，确认已添加测试钱包地址，并且 其 Active 开关已开启。

输入钱包地址时钱包恢复失败​

简短回答： 无法通过手动输入地址（0x...）来恢复钱包。

如何修复： 请使用在 Aptoide Wallet 应用中创建钱包时保存的备份文件或恢复文本。