无需 Live Updates 测试 Native Build
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
在测试新的 Native Build 时,请确保应用是从该二进制文件中包含的 Web 资源启动的,而不是从之前下载的 live update 启动。请使用或结合以下保护措施。
1. 提升 Native Baseline 版本
标题为“1. 提升 Native Baseline 版本”设置 CapacitorUpdater.version 高于原生版本的版本号,并为每次 Native Build 进行递增。更新的 Native Baseline 可以使安装的二进制文件与旧的 bundle 区分开来,并且在默认情况下, resetWhenUpdate: true当安装了更新的 Native App 时,会自动移除已下载的 bundle。
import type { CapacitorConfig } from '@capacitor/cli';import pkg from './package.json';
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { // Keep this aligned with, and increase it for, every native build. version: pkg.version, autoUpdate: 'atBackground', }, },};
export default config;例如,使用以下方式构建的二进制文件 version: '1.4.1' 比现有的具有更高的 Native Baseline 1.4.0 bundle。在验证 bundle 资源时,请勿重复使用已有的 Native Build 版本。
2. 在控制台中阻止模拟器和开发版 Build 的更新
标题为“2. 在控制台中禁用模拟器和开发版构建的更新”的部分在 Capgo 控制台中打开您的应用,前往 通道,选择该构建所使用的 channel,然后打开 信息 标签页。将 关闭 两者均设为 允许开发版构建的更新 以及 允许模拟器.

此 channel 策略仅针对所选的 build 类型拦截更新推送。对于已进行 Production 签名的真机,仍会根据该 channel 的其他设置接收更新。
3. 仅在 Native CI Builds 中启用 Live Updates
标题为“3. 仅在 Native CI Builds 中启用 Live Updates”的部分对于希望本地、模拟器及开发者 build 默认保持安全性的团队,可以通过环境变量将 Live Update 设置为 opt-in 模式。下方的配置禁用了更新检查,除非 CAPGO_LIVE_UPDATES 完全等于 true:
import type { CapacitorConfig } from '@capacitor/cli';import pkg from './package.json';
const liveUpdatesEnabled = process.env.CAPGO_LIVE_UPDATES === 'true';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'Example App', plugins: { CapacitorUpdater: { // Bump package.json for every native build. version: pkg.version, // Local builds are off; native CI explicitly enables live updates. autoUpdate: liveUpdatesEnabled ? 'atBackground' : false, }, },};
export default config;仅在同步并构建 Native Build 的 CI 步骤中设置该变量:
- run: CAPGO_LIVE_UPDATES=true npx cap sync- run: ./build-native-app.sh运行 npx cap sync 设置变量后,Capacitor 会在 sync 期间将此配置复制到原生项目中。如果不设置该变量,本地构建和模拟器构建将保持 autoUpdate: false 且不会检查 Live Update。
快速检查清单
标题为“快速检查清单”的部分- Increase the version used by
CapacitorUpdater.version原生二进制版本号。 - 禁用 允许开发版构建 以及 允许模拟器 在测试这些构建类型时,允许其访问该 channel。
- 本地构建,无需
CAPGO_LIVE_UPDATES. - 设置
CAPGO_LIVE_UPDATES=true仅在...之前npx cap sync在应接收 Live Update 的原生 CI 任务中。