跳转到正文

无需 Live Updates 测试 Native Build

在测试新的 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,然后打开 信息 标签页。将 关闭 两者均设为 允许开发版构建的更新 以及 允许模拟器.

Capgo channel 信息页签,显示了 Allow development build 和 Allow Emulators 设置
这些控制项位于 channel 信息页签中。禁用这两个高亮设置,即可让开发版 build 和模拟器保持使用其 bundle 中的 web 资源。

此 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。

  1. Increase the version used by CapacitorUpdater.version 原生二进制版本号。
  2. 禁用 允许开发版构建 以及 允许模拟器 在测试这些构建类型时,允许其访问该 channel。
  3. 本地构建,无需 CAPGO_LIVE_UPDATES.
  4. 设置 CAPGO_LIVE_UPDATES=true 仅在...之前 npx cap sync 在应接收 Live Update 的原生 CI 任务中。
  • 通道 — Channel 路由与策略。
  • 更新行为 — 何时检查并应用更新。
  • 版本定向 — 确保 bundle 与 Native Build 版本兼容。