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

配置 Android 桌面测试

GitHub

在应用内购买测试中，需要在 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 注册.
  • 一个在 Play Console 中创建的应用记录，包含您的最终 Android 包名
  • 在 Play Console 中创建的内购产品或订阅
  • 您可以添加到许可测试的测试Gmail账户
  • 已签署的发布构建，准备上传

在进行账单设置之前，创建应用程序并决定它是否将是 免费的 还是 收费的. Google允许您将收费应用程序转换为免费应用程序，但一旦应用程序被免费提供后，就无法将其转换为收费应用程序

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

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

确保您的Android发布签名已经配置好，才能运行 bundleRelease. 如果您的keystore、签名配置或发布密码尚未设置，请使用Android Studio创建签名包 Setup Process添加测试账号

在Play Console中，打开

设置 > 许可测试

  1. 并添加用于您的Android测试设备的主要Google账号。

    这确保了在Play沙盒流程中显示购买，而不是尝试实际收费。 添加测试账号 选择测试跟踪

    In Play Console, open

    Settings > License testing

  2. and add the primary Google account used on your Android test device.

    前往 测试和发布 > 测试 选择以下其中一个路径:

    • 内部测试: 内部测试是 QA 和计费 smoke 测试的最快路径。新包通常在几分钟内可用。
    • 关闭测试: 适合更广泛的测试，且在个人开发者帐户（创建于 2023 年 11 月 13 日后）发布前必需。

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

    创建测试路径

  3. 创建测试者列表

    打开您的路径后，创建测试者列表并添加应接收构建的 Google 账户。

    如果您正在为新创建的个人帐户争取生产访问权限，请务必使用 封闭测试 并至少在 14 个连续的日子里保持 12 名测试者已选入。

    创建测试者列表

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

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

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

    上传发布构建

  5. 加入测试计划

    打开测试设备上的选入 URL，并点击 “Become a tester” 成为测试者

    按钮以注册。

    参与测试

  6. 构建和测试

    在测试设备上启动Play安装的构建并尝试进行一次购买。您应该看到以下信息：

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

    测试购买

重要说明

关于账单QA，卸载任何侧载的应用程序副本，然后安装Play测试构建。
  • 内部测试对于快速烟雾测试很好，但关闭测试才是新个人账户生产访问的重要途径。
  • 测试账户不会为购买而被收费
  • 测试购买使用与生产购买相同的流程
  • 您可以测试所有订阅功能，包括试用期和介绍性优惠
  • __CAPGO_KEEP_0__
  • 测试订阅已加速续费周期，用于快速测试
  • 使用相同的 Google 账户在所有三个地方：设备上的 Google Play 商店、测试者优惠流程和 License 测试

故障排除

故障排除

测试模式下产品不显示：

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

“项目不可用”错误：

  • 创建产品后等待 2-3 小时，直到它们可用
  • 确保应用程序的包名与 Google Play 控制台中的包名匹配
  • 确认您已使用测试账户登录
  • 确认已上传指向同一包名和产品目录的已签名发布构建

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

  • 双重检查账户已添加到许可测试
  • 确保您正在使用测试跟踪的构建
  • 确认测试横幅在购买期间出现

额外资源

标题为“额外资源”

从 Configure Android Sandbox Testing 继续

继续从Configure Android Sandbox Testing

如果您正在使用 Configure 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 的原生能力