跳转到正文

配置 Android Sandbox Testing

GitHub

测试应用内购买需要在 Google Play Console 中进行正确配置。本指南将带你完成 Android 应用的沙盒测试配置。

开始前,请区分以下三种 Android 构建类型:

  • 本地调试/开发构建:适合在设备上检查 UI 和原生集成。
  • 上传到 Play Console 的签名发布 AAB:进行真实的 Google Play 计费测试所必需。
  • 通过 Play 安装的测试构建:测试人员从内部或封闭轨道安装的构建。请用于购买 QA。

如果你仅从 Android Studio 侧载 APK 或 adb,Google Play Billing 的行为可能与生产环境不同。对于订阅和 IAP 验证,请务必使用从 Google Play 安装的构建进行测试。

  • 一个 Google Play Console 开发者账号。如果还没创建,请从这里开始: Play Console 注册.
  • 在 Play Console 中用最终 Android 包名创建的应用记录
  • 你在 Play Console 中创建的应用内商品或订阅
  • 一个可以添加到许可测试的测试 Gmail 账号
  • 一个已签名、可上传的 release build

在花时间设置结算之前,先在 Play Console 中创建应用,并决定它是 免费 或 付费。Google 允许你之后把付费应用改为免费,但应用一旦免费提供过,就不能再改为付费。

使用 Android App Bundle (.aab) 适用于新的 Play Store 应用:

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

在运行之前,请确保已配置好 Android 发布签名 bundleRelease。如果尚未设置 keystore、签名配置或发布密码,请使用 Android Studio 通过以下方式创建签名 bundle 构建 > 生成已签名的 App Bundle / APK,该操作会提示您输入这些值。

  1. 添加测试账号

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

    这可以确保购买操作显示 Play 沙盒流程,而不是尝试进行真实扣款。

    添加测试账号

  2. 选择测试轨道

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

    • 内部测试:QA 和计费冒烟测试的最快路径。新 bundle 通常几分钟内即可用。
    • 封闭测试:更适合更广泛的测试,并且对于 2023 年 11 月 13 日之后创建的个人开发者账号,在生产环境发布前是必需的。

    对于首次发布,Play 可能会向内部测试人员显示临时的应用名称和列表信息,最长可达 48 小时。

    创建测试轨道

  3. 创建测试者列表

    打开轨道后,创建一个测试者列表,并添加应接收该构建版本的 Google 账号。

    如果您正在使用新创建的个人账号申请生产环境访问权限,请确保使用 封闭测试 并让至少 12 名测试者连续 14 天保持加入状态。

    创建测试者列表

  4. 上传已签名的 Release 构建

    在选定的测试轨道中创建新 release,并上传您已签名的 .aab.

    新的 Google Play 应用应使用 Android App Bundle 而非 APK。上传后,保存 release,修复 Play 标记的任何策略或商店列表阻碍项,然后将 release 发布到测试轨道。

    上传 release 构建

  5. 加入测试计划

    在测试设备上打开加入测试的 URL,然后点击 “成为测试人员” 按钮即可加入。

    请从该加入测试流程生成的 Play Store 商品详情页安装应用,不要安装本地导出的 APK。

    加入测试

  6. 构建与测试

    在测试设备上启动从 Play 安装的构建,并尝试购买。你应该会看到类似以下消息:

    “这是一笔测试订单;你不会被扣款。”

    测试购买

  • 进行计费 QA 时,请先卸载所有侧载的应用副本,再安装 Play 测试构建。
  • 内部测试很适合快速冒烟测试,但封闭测试才是新个人账号获取生产环境访问权限的关键轨道。
  • 测试账号购买时不会被扣费
  • 测试购买与生产环境购买流程一致
  • 你可以测试所有订阅功能,包括试用和推介优惠
  • 测试订阅的续订周期会缩短,方便更快测试
  • 请在以下三个地方使用同一个 Google 账号:设备上的 Play Store、测试人员选择加入流程以及 License 测试

测试模式下产品不显示:

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

“项目不可用”错误:

  • 创建产品后,请等待 2-3 小时使其可用
  • 确保应用的包名与 Play Console 中的包名一致
  • 确认您已使用测试账号登录
  • 确认您上传了指向相同包名和产品目录的签名 release build

测试购买显示为真实扣款:

  • 再次检查该账号是否已添加到 License testing 中
  • 确保您使用的是来自测试轨道(testing track)的 build
  • 验证购买过程中是否出现测试横幅

从“配置 Android Sandbox Testing”继续

“继续配置 Android 沙盒测试”部分

如果你正在使用 配置 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. 时的原生能力