跳过内容
Capgo - 实时更新 Capacitor 应用程序 Capgo

配置 Android 沙盒测试环境

GitHub

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

选择合适的构建

标题：选择合适的构建

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

  • 本地调试/开发构建: 适合在设备上检查 UI 和原生集成。
  • 已签名的发布 AAB 上传到 Play Console: 必须用于真实的 Google Play billing 测试。
  • Play 安装测试构建: 测试者安装的来自内部或封闭轨道的构建。使用此项进行购买QA。

If you only sideload an APK from Android Studio or adb, Google Play Billing may not behave the same way it does in production. For subscription and in-app purchase validation, always test with a build installed from Google Play.

前提条件

Section titled “前提条件”
  • 一个Google Play Console开发者帐户。如果您尚未创建一个，请从 Play Console signup.
  • 在Play Console中创建的应用程序记录，使用您的最终Android包名
  • 在Play Console中创建的您的内购产品或订阅
  • 一个用于添加到许可测试的测试Gmail帐户
  • 一个已签名的发布构建，准备上传

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

新Play商店应用程序使用Android应用程序包（.aab)。

终端窗口
bunx cap sync android
cd android
./gradlew bundleRelease

在运行之前，请确保您的Android发布签名已经配置好。 bundleRelease如果您的keystore、签名配置或发布密码尚未设置，请从Android Studio中创建签名包 ，它会提示您输入这些值。生成签名应用程序包/ APK

设置流程

设置流程

  1. 添加测试账户

    在Play控制台中打开 设置 > 许可测试 并添加您在Android测试设备上使用的主要Google账户。

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

    添加测试账户

  2. 选择测试轨迹

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

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

    首次发布时，Play 可能会向内部测试者显示临时应用名称和列表信息，持续 48 小时。

    创建测试跟踪

  3. 创建测试者列表

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

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

    创建测试者列表

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

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

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

    上传发布构建

  5. 加入测试计划

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

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

    加入测试

  6. 构建和测试

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

    “This is a test order; you will not be charged.”

    测试购买

重要说明

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

故障排除

Section titled “Troubleshooting”

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

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

“Item not available” error:

  • 产品不可用
  • 错误：
  • 等待2-3小时后产品可用
  • 确保应用的包名与Play Console中的包名匹配

验证您已使用测试账户登录并且已上传指向相同包名和产品目录的签名发布版构建

  • 确认账户已添加到 License 测试
  • 确保您正在使用测试轨道的构建
  • 在购买时验证测试横幅是否出现

额外资源

标题：额外资源

从 Configure Android Sandbox Testing 继续

标题：从 Configure Android Sandbox Testing 继续

如果您正在使用 配置 Android Sandbox 测试 为了获得商店的批准和发布，连接它到 使用 @capgo/native-purchases 在使用 @capgo/native-purchases 中的本机能力， @capgo/capacitor-in-app-review 在 @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 在使用 @capgo/capacitor-native-market 中的本机能力，