StudySmarter - 学校与大学
教育类应用,课时、课程和订阅的变更需经利益相关者审核。
- Google Play 安装量
- 650万
- 应用商店评分
- 4.8
您的 CI 会把每个 Pull Request 的 web build 上传到独立的 Capgo channel。评审人员扫描 QR code 或在 App 里切换 channel,就能在自己的设备上试用;PR 关闭后,该 channel 会自动删除。native code 的改动仍需重新 build。
问题
开发者打开 PR
变更已准备好审查,但还没有人能在手机上尝试。
构建、签名并上传
有人为该分支构建原生二进制文件,签名,上传到 TestFlight 或 Play 测试轨道,然后等待处理。
邀请并安装
审查者需要被添加为测试者,并安装该特定构建。
每次修复都重复
每个改变 code 的审查评论都意味着另一次构建、另一次上传和另一次安装。
即使只有 JavaScript 变更,每轮审查都要等待原生构建。
每次 build
等待商店处理
你上传到 TestFlight 或 Play 测试轨道的每个 build,都需要先经过处理,测试人员才能安装。每个 build 都是如此。
每个 PR
都需要单独的 Native Build 才能测试
如果没有 Live Updates,即使只是 Web 端的改动,审核人员也得等有人完成构建、签名并上传新的二进制文件后,才能测试该分支。
反馈滞后
审核时作者已转向其他任务
当审核要等 build 时,反馈会更晚到达,作者可能已在处理其他任务,分支也会逐渐偏离 main。
工作原理
四个 CI 步骤:一次性设置作用域密钥、每次 push 时上传、分享预览、关闭时清理。以下所有命令均来自 Capgo 文档。
管理员为 CI 创建一个 App Preview API 密钥。它可以创建预览 channel 并上传 bundle,但无法更改默认 channel 或生产 channel。每个 App 只需开启一次预览。
# once, run by an admin (not the preview key)
npx @capgo/cli@latest app set com.example.app --preview App Preview API 密钥 每次 push 时,CI 会构建 web 应用并以唯一的 bundle 版本上传。如果 pr-<number> channel 不存在,bundle upload --channel 会创建该 channel 并把 bundle 关联上去。
npx @capgo/cli@latest bundle upload com.example.app \
--apikey "$CAPGO_PREVIEW_KEY" \
--path ./dist \
--channel "pr-$PR_NUMBER" \
--bundle "1.2.3-pr.$PR_NUMBER.$GITHUB_RUN_NUMBER" channels 文档中的 PR 预览 get-qr 会为该 channel 打印 QR code,加上 --url 则输出预览 URL,方便 CI 把它们加到 PR 评论里。
npx @capgo/cli@latest get-qr com.example.app \
--channel "pr-$PR_NUMBER" \
--apikey "$CAPGO_PREVIEW_KEY" \
--url get-qr 参考 在 pull request closed 事件中运行。使用 App Preview 密钥时,它只会删除该密钥创建的 channel 和关联的 bundle。
npx @capgo/cli@latest channel delete \
"pr-$PR_NUMBER" com.example.app \
--apikey "$CAPGO_PREVIEW_KEY" \
--delete-bundle \
--success-if-not-found channel CLI 参考 两者都需要一个允许自行分配的 channel。App Preview key 无法设置这一点,因此使用该 key 时,请分享 QR preview,或在控制台中设置 device override。
在内部构建中开启摇一摇菜单。测试人员摇晃设备即可打开 Capgo 的测试菜单,摇一摇频道选择器则让他们选择频道。
// capacitor.config.ts (internal builds)
CapacitorUpdater: {
shakeMenu: true,
} 在开发者设置页面添加一个频道字段,并用 PR 频道名称调用 setChannel()。
import { CapacitorUpdater } from '@capgo/capacitor-updater'
await CapacitorUpdater.setChannel({
channel: 'pr-123',
triggerAutoUpdate: true,
}) setChannel() 参考 任何评审 Pull Request 的人都能在手机上查看,而不只是作者。
找到符合团队需求的解决方案
使用 Capacitor 构建的应用
学习、活动及社区类应用可以同时评审 onboarding、练习、直播课和订阅变更。PR previews 让产品、QA 和支持团队在合并前检查移动端可用的 build。
教育类应用,课时、课程和订阅的变更需经利益相关者审核。
实时互动应用,活动流程应在合并前完成测试。
社区应用,其锦标赛和分析界面可受益于设备预览。
CTO, 私有
“配置不到一天就完成了。基于 Channel 的发布让我能先在自己的设备上测试,再推给生产用户。”
nethead emeritors
“这个 updater 插件做得太棒了。它在我这儿运行完美,live updates 对快速测试迭代是极大的加速。”
开发者,Webincode
“能把特定 Device ID 加入指定分组,并只向这些分组推送更改,太救命了。”
常见问题
为配置 CI 的人和做评审的人提供直截了当的答案。
如果 PR 只改动了 Web 层,就不需要。评审人员只需安装一次 app,每个 PR 的 JavaScript、HTML、CSS 和 assets 都会进入各自的 channel。如果 PR 新增了 plugin 或改动了原生 code,就需要原生 build。在 CI 中运行 build needed 即可检测出这种情况。
哪些场景需要 Native Build使用 App Preview API key 时不会。它可以创建 preview channel、上传 bundle,并且只能删除自己创建的 channel 和 bundle。它无法更改默认或主 channel。在 GitHub Actions 中,请在 pull_request 而非 pull_request_target 上运行 job,并限制为只处理来自同一仓库的 PR。
App Preview API 密钥管理员用 app set --preview 启用一次预览即可。之后 get-qr 会为该 PR channel 输出一个 QR code,--url 会输出 Web 预览 URL 和 deep link。把它们发到 PR 评论里就行。
get-qr 参考在 pull request closed 事件中添加一个 job,运行带 --delete-bundle 和 --success-if-not-found 的 channel delete。使用 App Preview key 时,这会删除该 channel 及其关联的 bundle。更早 push 产生的 bundle 可以用有 delete 权限的 key 通过 bundle cleanup 清理掉。
channel CLI 参考可以。步骤就是 Capgo CLI 命令,因此能在任何 CI 中运行。文档里有 GitHub Actions、GitLab CI、Bitbucket Pipelines 和 Azure DevOps 的集成指南。
CI/CD 集成在免费试用期间,把 upload、QR 和 cleanup 步骤加到你的 CI 里,并在自己的 App 上试试。
体验 Capgo PR 预览:每个 pull request 都有自己的 live update channel。
来自 Martin 的人工支持
14 天无限免费试用。无需信用卡 14 天退款保证。随时取消。
14 天免费试用,无需信用卡。原生变更仍需重新 build。