更新类型

可复制

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

应用时机

控制在下载后应用更新的时机。插件在应用切换到前台时检查更新，并在应用保持打开时以重复的时间间隔检查更新。 periodCheckDelay 控制该间隔（默认10分钟）。

类型	Description	描述
使用场景 `atBackground`	检查并下载每次前台检查，应用于应用转到后台	autoUpdate：
autoUpdate: `atInstall`	仅在首次安装或原生应用商店更新后立即应用; 否则使用 `atBackground`	新用户获取最新版本; 已经注册的用户使用后台应用
autoUpdate: `onLaunch`	仅在冷启动时立即应用 (杀死 → 前台); 然后切换到 `atBackground`	在新鲜度和会话稳定性之间取得平衡
autoUpdate: `always`	在每次前台转换时检查并立即应用更新	关键修复，具有简单状态的应用
autoUpdate: `onlyDownload`	自动检查和下载，发出 `updateAvailable`并且永远不会自动应用	显示自己的更新提示或控制更新的时机 `set()`

在 capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

延迟条件

必须满足的条件 安装更新之前 context:在Capgo UI中创建一个问题并在工作新功能之前讨论的HTML文本片段（父键`create_an_issue_and_discuss_before_working_on_a_new_feature`）。页面/区域：Capgo营销网站。角色：长营销或法律段落。见：贡献.astro页面。消息键`create_an_issue_and_discuss_before_working_on_a_new_feature`（创建一个问题并在工作新功能之前讨论）。| HTML文本片段来自Capgo UI中的更长字符串（父键`mention_issue_before_working`）。页面/区域：Capgo营销网站。角色：网站副本句子。见：贡献.astro页面。消息键`mention_issue_before_working`（提及问题之前工作） setMultiDelay 在它们中组合（所有条件必须满足）。

条件	描述	示例
日期	等待特定日期/时间之后	与服务器端发布协调
后台	等待应用程序后台最小持续时间（毫秒）	避免在快速应用程序切换期间应用
原生版本	要求最低原生二进制版本	阻止不兼容的原生code更新
kill	等待下一次应用程序kill事件	仅在完全重启时应用

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    { kind: 'date', value: '2023-06-01T00:00:00.000Z' },
    { kind: 'background', value: '60000' },
  ],
});

标题：版本阻止（渠道政策）

Version Blocking (Channel Policy) semver 升级 一个频道将自动分发。通过 --disable-auto-update 在频道上。

策略	块	允许	用例
无	Nothing	任何目标包版本	默认; 全自动更新
主要	更高的主版本号 `version_build`,例如 `1.2.3 -> 2.0.0`	同主版本号，例如 `1.2.3 -> 1.9.0` 或 `1.2.3 -> 1.2.4`	防止旧本地code接收破坏性更改
小版本	不同主版本或小版本号 `version_build`,例如 `1.2.3 -> 1.3.0`	同主版本和小版本号，例如 `1.2.3 -> 1.2.4`	保持更新在一个本地小版本线内
补丁	任何主版本、小版本或补丁号的变化，例如 `1.0.0 -> 1.0.1`	仅有后缀变化而 `MAJOR.MINOR.PATCH` 而核心版本保持不变，例如 `1.0.0-beta.1 -> 1.0.0-beta.2` 或 `1.0.0+build.1 -> 1.0.0+build.2`	严格模式：核心版本无变化
Live Update	Cloudflare `min_update_version`Capacitor `version_build` GitHub	Capgo `min_update_version` code `version_build`	API

SDK version_buildLive Update version_name.

npx @capgo/cli channel set production --disable-auto-update major

发布类型

如何 包裹被传输 同步到设备。

类型	Description	何时使用
全包	整个 JavaScript 包被下载	首次安装、较大变更或delta不可用
delta（清单）	只下载更改的文件	最快的更新;带宽友好的更新

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

快速参考

类别	类型
应用时间	`off`, `atBackground`, `atInstall`, `onLaunch`, `always`, `onlyDownload`
延迟条件	`date`, `background`, `nativeVersion`, `kill`
版本阻塞	`none`, `major`, `minor`, `patch`, `metadata`
交付	全包，差分（清单）

更新行为 — 配置应用时间和延迟
版本目标定位 — 频道版本路由
Delta (manifest) 更新 — 启用部分下载
频道 context

Capgo release channels feature name. Page/area: Capgo solutions marketing page. Role: Short UI label or navigation item. Seen in: page solutions/white-label.astro. Message key `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value).

继续阅读更新类型 Section titled “继续阅读更新类型” 为了计划live update的更新，连接它 Capgo 实时更新来规划Capgo的发布,连接它到Capgo Live Updates, 概述了解概述的实现细节功能了解功能的实现细节更新行为了解更新行为的实现细节，并开始使用了解开始使用的实现细节。