跳过内容

Configure Android Sandbox Testing

在 Google Play Console 中正确配置内购后,测试内购需要。这个指南将指导您设置 Android 应用的沙盒测试。

选择合适的构建

标题:选择合适的构建

开始之前,分离这三个 Android 构建类型:

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

如果您只从 Android Studio 或 adb, Google Play Billing 在生产环境中可能不会表现出相同的方式。对于订阅和内购验证,始终使用从 Google Play 安装的构建进行测试。

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

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

使用Android应用程序包(.aab)为新Play Store应用程序:

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

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

  1. Add Testing Account

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

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

    添加测试账户

  2. 选择测试跟踪

    前往 测试和发布>测试 并选择以下跟踪之一:

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

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

    创建测试跟踪

  3. 创建测试者列表

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

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

    创建测试者列表

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

    在选择的测试跟踪中创建一个新发布,并上传您的已签名 .aab.

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

    上传发布构建

  5. 加入测试计划

    打开从测试设备中打开的优惠链接并点击 “Become a tester” 成为测试者

    按钮来注册。

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

  6. 加入测试

    构建和测试

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

    测试购买

重要说明

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

测试模式下产品未显示:

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

“Item not available” error:

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

验证您已使用测试账户登录

  • Double-check the account is added to License testing
  • 确保您正在使用测试轨道的构建
  • 在购买时验证测试标志出现

额外资源

额外资源部分

从 Configure Android Sandbox Testing 继续

从 Configure Android Sandbox Testing 继续部分

如果您正在使用 配置 Android Sandbox Testing 为了获得商店的批准和分发,连接它 使用@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的原生能力中