跳转至正文

Beta 测试

无需新的 TestFlight build,即可向 beta 测试人员推送 Web 变更

测试人员只需安装一次 App。之后,每项 JavaScript、HTML 或 CSS 变更都会推送到他们从 App 内加入的 beta channel,并在下次检查更新时获取。原生 code 的变更仍需通过 TestFlight 或 Play 测试轨道。

测试人员可在 App 内选择加入

使用 --self-assign 允许在 channel 上自行分配。App 可通过 listChannels() 列出 channel,并用 setChannel() 切换设备,这样测试人员就能在设置页加入 beta。

setChannel() 参考

在控制台固定单台设备

在 Capgo 控制台中设置设备覆盖(override),无需修改 App 就能把某位测试人员的手机放到某个 channel。覆盖设置会在最后一次设置 90 天后移除。

设备覆盖

用 QR code 分享 build

只需为 App 启用一次预览。之后运行 get-qr,或在 upload 时加上 --qr-preview,就会生成 bundle 或 channel 的 QR code 和预览链接,你可以直接发到 QA 讨论串里。

get-qr 参考

原生变更仍需使用 TestFlight

Live Updates 会更新 JavaScript、HTML、CSS 和资源。添加插件或修改原生 code 时,请提交新的 TestFlight 或 Play 测试 build,然后通过 channels 持续迭代。

哪些场景需要 Native Build

TestFlight 与 Capgo channels 的用途不同

  • 把新 build 交付给测试人员

    TestFlight / Play 测试
    Build、签名、上传,然后等待商店处理
    Capgo beta 测试频道
    使用 CLI 上传 bundle。测试人员下次检查更新时即可获取。
  • 添加测试人员

    TestFlight / Play 测试
    在 App Store Connect 或 Play Console 中邀请他们
    Capgo beta 测试频道
    他们从你的 App 加入 channel,或者由你设置设备 override
  • 把测试人员切换到另一个 build

    TestFlight / Play 测试
    安装另一个 build
    Capgo beta 测试频道
    使用 setChannel() 在应用内切换 channel
  • Native code 和插件变更

    TestFlight / Play 测试
    是
    Capgo beta 测试频道
    不能,需要发布新的二进制包

测试人员仍需通过 TestFlight、Play 测试轨道或应用商店安装一次应用。之后的 Web 层变更由 Channels 接管。 哪些场景需要 Native Build

工作原理

QA 团队如何使用 Capgo 进行 Beta 测试

一个已安装的 Build、一个测试人员可加入的 Channel,以及每次变更对应一次 CLI upload。下面的每条命令都来自 Capgo 文档。

  1. 创建测试人员可加入的 Beta Channel

    Self-assignment 允许应用将设备移入此 Channel。生产 Channel 中请保持关闭。

    npx @capgo/cli@latest channel add beta com.example.app --self-assign
    Channels 文档
  2. 在应用中添加“加入 Beta”开关

    setChannel() 会向 Capgo 询问该 channel 是否允许自行分配,然后把它存到设备上。triggerAutoUpdate 会立即触发更新检查。

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    // Join beta and check for its bundle now
    await CapacitorUpdater.setChannel({ channel: 'beta', triggerAutoUpdate: true })
    
    // Leave beta and go back to the default channel
    await CapacitorUpdater.unsetChannel({ triggerAutoUpdate: true })
    setChannel() 参考
  3. 将每次变更上传到 beta

    只需启用一次预览。之后每次 upload 都打印一个 QR code,让测试人员和审核人员能打开新的 bundle。

    # once
    npx @capgo/cli@latest app set com.example.app --preview
    # every change
    npx @capgo/cli@latest bundle upload --channel beta --qr-preview
    get-qr 参考
  4. 把通过 QA 的版本发布到生产

    把测试过的 bundle 关联到生产,或先推送到一部分生产设备。测试人员会一直留在 beta,直到退出。

    npx @capgo/cli@latest channel set production com.example.app \
      --bundle 1.4.2
    # or roll it out to 10% of production first
    npx @capgo/cli@latest channel set production com.example.app \
      --rollout-bundle 1.4.2 --rollout-percentage 10 --rollout-enable
    渐进式发布文档

谁在使用 Beta 渠道

内部 QA

QA 只需保留一个已安装的 build,就能在 qa、beta 和 feature 渠道间切换,无需为每次 JavaScript 变更重新安装。

选择加入 Beta 的用户

添加一个调用 setChannel() 的“加入 Beta”开关。用户退出时调用 unsetChannel(),回到默认渠道。

相关方评审

通过 get-qr 发送 QR code,让产品负责人打开特定 bundle 或 channel 的预览。

使用 Capacitor 构建的应用

社区应用需要谨慎开放功能

高频使用的消费级应用可以在向所有用户推送新体验前,先通过封闭测试组验证游戏、学习或预测流程。

lichess • Free Online Chess 应用图标 棋盘

lichess • 免费在线象棋

大型社区应用,其锦标赛、分析和社交功能都需要仔细验证。

Google Play 安装量
1130万
应用商店评分
4.3
StudySmarter - 学校与大学应用图标 教育

StudySmarter - 学校与大学

教育类工作流中,onboarding 和练习变更应在发布前审核。

Google Play 安装量
650万
应用商店评分
4.8
Windy.com - 天气预报应用图标 天气

Windy.com - 天气预报

预测并梳理产品变更的交互,在扩大规模前先建立信心。

Google Play 安装量
32.9M
应用商店评分
4.7

客户证言

使用 Capgo 交付的团队怎么说

5.0/5 开发者团队评分 9,400+ 团队 查看评价

Nate van Jole

CTO, 私有

“配置不到一天就完成了。基于 Channel 的发布让我能先在自己的设备上测试,再推给生产用户。”

no-tone @ Webincode

开发者,Webincode

“能把特定 Device ID 加入指定分组,并只向这些分组推送更改,太救命了。”

Michael Haberler 的肖像

Michael Haberler

nethead emeritors

“这个 updater 插件做得太棒了。它在我这儿运行完美,live updates 对快速测试迭代是极大的加速。”

常见问题

QA 和产品团队常问的问题

关于测试人员、build 以及哪些仍需 TestFlight 的简要解答。

Capgo 能替代 TestFlight 或 Play 内部测试吗?

仅适用于 Web 层变更。测试人员只需从 TestFlight、Play 测试轨道或应用商店安装一次应用。之后,JavaScript、HTML、CSS 和资源文件变更可通过 channel 推送给他们。但添加 plugin、升级 Capacitor,或更改原生 code 或 Capacitor 配置,则需要新的 binary。

哪些场景需要 Native Build

测试人员如何加入或退出 beta 测试?

为 beta channel 开启 self-assignment,然后在应用的某个界面中调用 setChannel({ channel: 'beta' })。Capgo 会检查该 channel 是否允许加入,设备会保存该选择。unsetChannel() 会将设备切回默认 channel。默认 channel 本身无法通过 setChannel() 加入。

setChannel() 参考

可以在不修改 App 的情况下,单独迁移某个测试人员的手机吗?

可以。在 Capgo 控制台中打开该设备并设置 channel override。同步到所有 edge server 最多需要 2 分钟,并且会在最后一次设置 90 天后被移除。通过 setChannel() 在 App 里选择的 channel 不会出现在该列表中。

设备覆盖

如何在不受旧版 live update 影响的情况下,测试新的 Native Build?

每次 Native Build 都递增 CapacitorUpdater.version。在默认设置下,安装新版本时,为旧版本下载的 bundle 会被移除。你也可以在 channel 上关闭开发版 build 和模拟器的更新。

无需 Live Updates 即可测试 Native Build

如果 Beta bundle 在启动时崩溃了怎么办?

请在 App 加载完成后调用 notifyAppReady()。如果新 bundle 在 10 秒内没有调用它,设备会将其标记为失败,并回退到上一个可用的 bundle。

notifyAppReady() 与自动回滚

为你自己的 App 设置 Beta channel

创建一个测试人员可以加入的 channel,添加开关,并在 14 天免费试用期间发送你的第一个 bundle。无需信用卡。