配置 Android Sandbox Testing
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
测试应用内购买需要在 Google Play Console 中进行正确配置。本指南将带你完成 Android 应用的沙盒测试配置。
为任务选择合适的 build
标题为“为不同任务选择合适的构建”的章节开始前,请区分以下三种 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 androidcd android./gradlew bundleRelease在运行之前,请确保已配置好 Android 发布签名 bundleRelease。如果尚未设置 keystore、签名配置或发布密码,请使用 Android Studio 通过以下方式创建签名 bundle 构建 > 生成已签名的 App Bundle / APK,该操作会提示您输入这些值。
设置流程
标题为“设置流程”的章节-
添加测试账号
在 Play Console 中,打开 设置 > 许可证测试 并添加在您的 Android 测试设备上使用的主要 Google 账号。
这可以确保购买操作显示 Play 沙盒流程,而不是尝试进行真实扣款。

-
选择测试轨道
前往 测试和发布 > 测试 并选择以下轨道之一:
- 内部测试:QA 和计费冒烟测试的最快路径。新 bundle 通常几分钟内即可用。
- 封闭测试:更适合更广泛的测试,并且对于 2023 年 11 月 13 日之后创建的个人开发者账号,在生产环境发布前是必需的。
对于首次发布,Play 可能会向内部测试人员显示临时的应用名称和列表信息,最长可达 48 小时。

-
创建测试者列表
打开轨道后,创建一个测试者列表,并添加应接收该构建版本的 Google 账号。
如果您正在使用新创建的个人账号申请生产环境访问权限,请确保使用 封闭测试 并让至少 12 名测试者连续 14 天保持加入状态。

-
上传已签名的 Release 构建
在选定的测试轨道中创建新 release,并上传您已签名的
.aab.新的 Google Play 应用应使用 Android App Bundle 而非 APK。上传后,保存 release,修复 Play 标记的任何策略或商店列表阻碍项,然后将 release 发布到测试轨道。

-
加入测试计划
在测试设备上打开加入测试的 URL,然后点击 “成为测试人员” 按钮即可加入。
请从该加入测试流程生成的 Play Store 商品详情页安装应用,不要安装本地导出的 APK。

-
构建与测试
在测试设备上启动从 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. 时的原生能力