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

配置 Android Sandbox 测试

GitHub

在 Google Play Console 中正确配置内购功能是测试内购所必需的。 本指南将指导您设置 Android 应用的沙盒测试环境。

选择合适的构建

标题：选择合适的构建

在开始之前，请将 Android 构建类型分开：

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

如果您只从 Android Studio 或 adb将 APK 侧载到设备上，Google Play Billing 的行为可能与生产环境不同。对于订阅和内购验证，始终使用从 Google Play 安装的构建进行测试。

前置条件

前置条件
  • 一个Google Play Console开发者帐户。如果您尚未创建一个，请从 Play Console注册.
  • 在Play Console中创建的应用程序记录
  • 在Play Console中创建的您的应用程序内产品或订阅
  • 一个用于测试许可的测试Gmail帐户
  • 一个已签名的发布构建，准备上传

在Play Console中创建应用程序并决定它是否将是 免费 或 context:HTML文本片段来自更长的Capgo UI字符串（父键`alternatives_cta_questions`）。页面/区域：Capacitor实时更新替代方案比较页面。角色：长期营销或法律段落。见于：页面alternatives.astro。保留Capgo产品/品牌和开发者术语完全不变。消息键`alternatives_cta_questions`（替代方案CTA问题）。| HTML文本片段来自更长的Capgo UI字符串（父键`appflow_cta_questions`）。页面/区域：Appflow比较/迁移营销文本。角色：长期营销或法律段落。见于：页面ionic-appflow.astro。保留Capgo产品/品牌和开发者术语完全不变。消息键`appflow_cta_questions`（Appflow CTA问题）。| HTML文本片段来自更长的Capgo UI字符串（父键`capwesome_cta_questions`）。页面/区域：Capawesome比较页面。角色：长期营销或法律段落。见于：页面capwesome.astro。保留Capgo产品/品牌和开发者术语完全不变。消息键`capwesome_cta_questions`（Capwesome CTA问题）。| HTML文本片段来自更长的Capgo UI字符串（父键`consulting_faq_subtitle`）。页面/区域：咨询服务页面。角色：段落标题或标语。见于：页面consulting.astro。保留Capgo产品/品牌和开发者术语完全不变。消息键`consulting_faq_subtitle`（咨询FAQ标题）。| 页面/区域：Appflow比较/迁移营销文本。角色：短UI标签或导航项。见于：页面ionic-appflow.astro，页面ionic-enterprise-plugins.astro，页面解决方案/ionic-enterprise-plugins.astro。消息键`appflow_plugins_or`（Appflow插件或）。. Google lets you move a paid app to free later, but once an app has been offered for free, it cannot be switched to paid.

使用 Android App Bundle (.aab) 来为新 Play Store 应用:

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

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

设置流程

标题：设置流程

  1. 添加测试账户

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

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

    添加测试帐户

  2. 选择测试轨迹

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

    • 内部测试: QA 和billing 烟雾测试的最快路径。新捆绑包通常在几分钟内可用。
    • 关闭测试为了更广泛的测试，且在个人开发者帐户（创建于2023年11月13日后）发布生产版之前，需要使用此功能。

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

    创建测试轨道

  3. 创建测试者列表

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

    如果您正在为新创建的个人帐户争取生产权限，确保使用 和至少12个测试者在14个连续天内保持激活状态。 创建测试者列表

    上传签名的发布构建

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

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

    New Google Play apps should use an Android App Bundle rather than an APK. After upload, save the release, fix any policy or store listing blockers Play flags, then publish the release to the testing track.

    上传发布版

  5. 加入测试计划

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

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

    加入测试

  6. 构建和测试

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

    “这是一个测试订单；您不会被收费。”

    测试购买

重要说明

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

故障排除

故障排除

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

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

“商品不可用”错误：

  • 等待2-3小时后创建产品使其可用
  • 确保应用程序的包名与Play Console中的包名匹配
  • 验证您已使用测试账户登录
  • 确认已上传指向同一包名和产品目录的签名发布构建

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

  • 再次检查账户已添加到许可测试
  • 确保您正在使用测试轨道的构建
  • 验证测试横幅在购买期间显示

更多资源

标题：更多资源

从配置Android沙盒测试继续

标题：从配置Android沙盒测试继续

如果您正在使用 配置Android沙盒测试 以规划商店批准和分发为目的，连接它到 使用@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 的原生能力