配置 Android Sandbox 测试

在 Google Play Console 中正确配置内购后，才能进行测试。 本指南将指导您设置 Android 应用程序的沙盒测试环境。

选择合适的构建

在开始之前，分离这三个 Android 构建类型：

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

如果您只从 Android Studio 或 adbsideload APK，则 Google Play Billing 的行为可能与生产环境不同。对于订阅和内购验证，始终使用从 Google Play 安装的构建进行测试。

前提条件

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

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

使用Android应用程序包（.aab")为新Play Store应用程序：

bunx cap sync android
cd android
./gradlew bundleRelease

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

设置过程

1. 添加测试账户

   In Google Play Console, open 设置 > 许可测试 并添加您 Android 测试设备上使用的主要 Google 账户。

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

   

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 帐户。

   If you are working toward production access on a newly created personal account, make sure you use 关闭测试 并确保至少 12 个测试者在 14 个连续的日子内保持激活状态。

   

4. 上传已签名的发布构建

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

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

   

5. 加入测试计划

   在测试设备上打开从该选入流程创建的优惠链接，点击 “成为测试者” 按钮来注册。

   从Play商店列表中安装应用，而不是从本地导出的APK。

   

6. 构建和测试

   在测试设备上启动已安装在Play的构建并尝试一次购买。您应该看到一个类似这样的消息:

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

   

重要说明

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

故障排除

确保您的应用已上传到测试轨道

• 故障排除
• 验证测试账户已添加到许可测试
• 检查产品在Google Play Console中是否处于激活状态
• 确认应用程序从Google Play安装，而不是本地安装

“商品不可用”错误：

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

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

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

更多资源

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

继续从配置Android沙盒测试

如果您正在使用 配置Android沙盒测试 以规划商店批准和分发，连接它到 使用@capgo/native-purchases 为在使用@capgo/native-purchases中native能力的 @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review 使用 @capgo/capacitor-in-app-review @capgo/capacitor-native-market @capgo/capacitor-native-market 使用 @capgo/capacitor-native-market Using @capgo/capacitor-native-market for the native capability in Using @capgo/capacitor-native-market.