配置 Android 沙盒测试

在 Google Play Console 中正确配置内购功能是测试内购所必需的。 本指南将指导您设置 Android 应用程序的沙盒测试环境。

选择合适的构建

在开始之前，请将 Android 构建类型分开为以下三种类型：

• 本地调试/开发构建: 适合在设备上检查 UI 和本机集成。
• 已签名的发布 AAB 上传到 Play Console: 为 Google PlayBilling 测试提供了现实的环境。
• Play 安装测试构建: 测试者从内部或闭源轨道安装的构建。使用此构建进行购买 QA。

如果您只从 Android Studio 或 adb将 APK 侧载到设备上，Google Play Billing 的行为可能与生产环境不一样。对于订阅和内购验证，始终使用从 Google Play 安装的构建进行测试。

前提条件

• 一个Google Play Console开发者帐户。如果您尚未创建一个，请从 Google Play Console注册.
• 在Play Console中创建的应用程序记录
• 在Play Console中创建的您的应用程序内购买产品或订阅
• 一个用于测试许可的测试Gmail帐户
• 一个已签名的发布构建，准备上传

在您花费时间设置计费之前，先在Play Console中创建应用程序，并决定它是否将是 免费 或 付费Google允许您将付费应用程序转换为免费应用程序，但一旦应用程序被免费提供，无法切换为付费应用程序。

使用Android App Bundle（.aab）创建新Play Store应用程序：

bunx cap sync android
cd android
./gradlew bundleRelease

确保您的Android发布签名已配置好，才能运行 bundleRelease。如果您的keystore、签名配置或发布密码尚未设置，请使用Android Studio创建签名包 Build > 生成签名应用程序包/ APK，系统会提示您输入这些值。

设置过程

1. 添加测试账户

   在 Play Console 中，打开 设置 > 许可测试 并添加您 Android 测试设备上使用的主要 Google 帐户。

   这确保购买显示 Play sandbox 流程，而不是尝试实际收费。

   

2. 选择测试轨迹

   转到 测试和发布 > 测试 并选择以下轨迹之一：

   • 内部测试: QA 和billing 烟雾测试的最快路径。新捆绑包通常在几分钟内可用。
   • 关闭测试: 在生产环境之前，个人开发者帐户（创建于 2023 年 11 月 13 日之后）需要使用此功能进行更广泛的测试。

   For a first release, Play may show a temporary app name and listing information to internal testers for up to 48 hours.

   

3. 创建测试者列表

   在打开您的轨道后，创建测试者列表并添加应接收构建的 Google 帐户。

   如果您正在为新创建的个人帐户争取生产访问权限，请确保使用 关闭测试 并至少在 14 个连续天内保持 12 个测试者选中。

   

4. 上传签名的发布构建

   创建一个新发布在所选的测试轨道中，并上传您的签名 .aab.

   新 Google Play 应用程序应使用 Android App Bundle 代替 APK。上传后，保存发布，修复任何政策或商店列表阻塞 Play 标志，然后将发布发布到测试轨道。

   

5. 加入测试计划

   在测试设备上打开优惠链接并点击 “成为测试者” 按钮以注册。

   从Play Store中安装由该优惠流程创建的应用程序，而不是从本地导出的APK。

   

6. 构建和测试

   在测试设备上启动已安装在Play Store中的构建并尝试一次购买。您应该看到一个消息，如下所示：

   “这是一个测试订单；您不会被收费。”

   

重要说明

• 为了billing QA，请在安装Play测试版之前卸载任何sideloaded的应用副本。
• 内部测试对于快速smoke测试很好，但关闭测试才是新个人账户生产访问的关键。
• 测试账户不会为购买而被收费。
• 测试购买使用相同的流程
• 您可以测试所有订阅功能，包括试用期和介绍性优惠
• 测试订阅具有加速续订周期以便更快地测试
• 请使用相同的Google账户在三个地方：设备上的Play商店、测试者优惠流程和许可测试

故障排除

产品在测试模式下不显示:

• 确保您的应用已上传到测试轨道
• 验证测试账户已添加到许可测试
• 检查产品在Google Play Console中是否处于激活状态
• 确认从Google Play安装的构建，而不是本地侧载

“商品不可用”错误：

• 等待2-3小时后创建产品后它们可用
• 确保您的应用程序包名与Play Console中的包名匹配
• 验证您已使用测试账户登录
• 确认已上传指向相同包名和产品目录的已签名发布构建

测试购买显示为真实收费：

• 双重检查账户已添加到许可测试
• 确保您正在使用测试轨道的构建
• 验证测试横幅在购买期间出现

更多资源

• 使用 Google Play Billing 进行测试
• 设置一个开放、关闭或内部测试
• 新个人开发者帐户的测试要求

继续从配置 Android Sandbox Testing

配置 Android Sandbox Testing 以规划商店批准和分发，连接它与 使用 @__CAPGO_KEEP_0__/native-purchases 为 Using @capgo/native-purchases 中的本机能力 for the native capability in Using @capgo/native-purchases, 在capgo/capacitor内购评论 为@capgo/capacitor内购评论的实现细节 使用@capgo/capacitor内购评论 为@capgo/capacitor内购评论的原生能力 capgo/capacitor原生市场 为capgo/capacitor原生市场的实现细节, 和 使用capgo/capacitor原生市场 为capgo/capacitor原生市场的原生能力