跳过内容
Capgo - Capacitor Live Updates Capgo

更新类型

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: atInstall仅在首次安装或原生应用商店更新后立即应用; 否则使用 atBackground新用户获取最新版本; 已有用户使用后台应用
autoUpdate: onLaunch仅在冷启动时立即应用 (杀死 → 前台); 然后回退到 atBackground平衡新鲜度和会话稳定性
autoUpdate: always在每次前台转换时检查并立即应用更新关键修复，具有简单状态的应用
autoUpdate: onlyDownload自动检查和下载，发出 updateAvailable并且永远不自动应用手动更新或控制更新时机的应用 set()

Configure in capacitor.config.ts:

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

延迟条件

标题：延迟条件

必须满足的条件 在 context:在创建新功能之前创建一个问题并讨论（Create An Issue And Discuss Before Working On A New Feature）| 在提到问题之前（Mention Issue Before Working） setMultiDelay 在它们中组合（所有条件必须满足）。

条件描述示例
日期等待特定日期/时间之后与服务器端发布协调
后台等待应用程序在后台最短持续时间（毫秒）避免在快速应用程序切换期间应用
原生版本要求最低原生二进制版本阻止不兼容的本机code更新
kill等待下一个应用程序杀死事件仅在完全重启时应用
import { CapacitorUpdater } from '@capgo/capacitor-updater';


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

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

控制哪些

阻止不兼容的本机__CAPGO_KEEP_0__更新 semver更新 一个频道将自动分发。通过 --disable-auto-update 在频道中。

策略块允许用例
none无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最严格模式：核心版本无变化
最严格模式：核心版本无移动元数据 min_update_version缺失 version_build ，或在其下方 min_update_version 目标捆绑包，其 version_build小于或等于

自定义兼容性规则每捆绑包 version_build，不是当前安装的下载的包发送为 version_name.

终端窗口
npx @capgo/cli channel set production --disable-auto-update major

context:Capgo解决方案营销页面。角色：部分或页面标题。见于：页面解决方案/版本目标。astro。消息键`solutions_version_targeting_title`（解决方案版本目标标题）。| Capgo解决方案营销页面。角色：短UI标签或导航项。见于：站点头部，组件SolutionsMegaMenu.astro，页面解决方案/版本目标。astro。消息键`solutions_version_targeting`（解决方案版本目标）。”，] }

标题："传输类型"

如何将 捆绑包传输 到设备。

类型描述何时使用
完整捆绑包整个JS捆绑包下载首次安装、较大变化或当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
交付context: 企业产品/价格页面, UI标签, 企业交付标签
相关

继续

如果您正在使用

更新类型 与 live update Capgo 实时更新 为产品工作流程在Capgo Live Updates, 概述 了解概述的实现细节 功能 了解功能的实现细节 更新行为 了解更新行为的实现细节,并 开始 了解开始的实现细节。