跳过内容
Capgo - Live Updates for Capacitor Apps Capgo

版本管理

Capgo 使用 语义版本 (semver) 对于插件、CLI 和我们提供的产品 —— 我们推荐的相同实践 —— 应用程序捆绑包。

本页面解释了这些版本之间的关系、兼容性以及如何使用 LTS 标签将较旧的 Capacitor 主版本固定。

快速规则

快速规则
产品主要版本兼容性说明
Capgo 插件遵循匹配 Capacitor 主要插件主要 8 目标 Capacitor 8 7 目标 Capacitor 7，依次类推
Capgo CLI独立不要同步 CLI 主要版本与插件或 Capacitor。始终使用最新的 CLI
Capgo 控制台独立拥有自己的发布节奏;与支持的更新插件版本兼容

插件遵循 Capacitor 主版本

插件遵循 Capacitor 主版本

每个Capgo插件的主要版本都跟它构建的Capacitor主要版本保持一致:

  • @capgo/capacitor-updater@8 → Capacitor 8
  • @capgo/capacitor-updater@7 → Capacitor 7
  • 其他Capgo插件也遵循相同的模式

当Capacitor发布新主要版本时，Capgo会发布匹配的插件主要版本。这是我们可能会改变 默认选项 如果新默认值对Capacitor的整个生命周期来说更好

API稳定性

API稳定性

插件API在主要版本之间保持稳定，除非设计上有一个变化会影响所有用户（例如Capacitor平台的要求会迫使所有消费者都受到相同的影响）。通常情况下，您可以在升级Capacitor时，移动到Capgo插件的新主要版本而不需要重写您的集成

默认选项可能仍然会在新主要版本中发生变化。请查看发布说明和迁移指南（参见 升级器升级 当你升级时（包括在更新器侧边栏下的迁移指南)

CLI 和控制台各自使用自己的版本

标题：CLI 和控制台各自使用自己的版本

Capgo CLI 和 Capgo 控制台不 与插件或 __CAPGO_KEEP_0__ 共享主版本 share major versions with plugins or Capacitor.

  • 升级 __CAPGO_KEEP_0__ 主 因为你正在使用 __CAPGO_KEEP_0__ 8 或更新器 need CLI major 8 because you are on Capacitor 8 or updater 8.
  • 最新 最新 CLI.
  • CLI 和控制台仍然与任何受支持的 @capgo/capacitor-updater (和相关的更新器) 主版本。

固定旧版本的CLI不建议。请优先:

终端窗口
npx @capgo/cli@latest bundle upload --channel=production

前一个插件主版本的LTS标签

标题：前一个插件主版本的LTS标签

当您在较旧的Capacitor主版本上停留时，请安装匹配的Capgo插件主版本并使用LTS dist-tag，而不是复制过时的锁文件。

终端窗口
# Latest Capgo updater for Capacitor 7
npm i @capgo/capacitor-updater@lts-v7


# Same pattern for other majors
npm i @capgo/capacitor-updater@lts-v6
npm i @capgo/capacitor-updater@lts-v5
npm i @capgo/capacitor-updater@lts-v4

在更新器之外，前一个插件主版本的LTS发布 On demand.

Updater backports vs 其他插件

Updater backports vs 其他插件
包前一个重大修复
@capgo/capacitor-updater每月镜像修复到 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 在 Capacitor 4 中始终可用，但不在每月的时间表中
其他 Capgo 插件页面/区域：企业产品/定价页面。角色：网站副本句子。见于：企业.astro 页面。保留 Capgo 产品/品牌和开发者术语完全不变。消息键 `enterprise_130_plugins` (企业 130 插件)。

On demand

相同功能，镜像版本号

相同功能，镜像版本号

如果最新的发布是 8.3.4, 则Capacitor 7 LTS 行将以 7.3.4 的相同功能集和修复 , 适应于__CAPGO_KEEP_0__ 的重大更新。当您想要“此Capacitor 主要版本的最新”时，请使用标签安装:

Install with the tag when you want “latest for this Capacitor major”:

复制到剪贴板
npm i @capgo/capacitor-updater@lts-v7   # resolves to the current 7.x LTS, e.g. 7.3.4

标题：LTS 是最新的后端

在一个新的插件主版本发布后，一个

(或 lts-v7 protectedTokens lts-v6…) 最新版本的 so the same work runs on the previous Capacitor major.

Because it tracks latest, the LTS line’s public API 可能会改变 当最新的版本发生变化 — 即使主版本号保持不变 7. Treat LTS as “current Capgo behavior on an older Capacitor,” not as a frozen legacy API forever.

对一个较旧的

而不是一个永远不会改变的遗留
  1. Upgrade Capgo plugins when you upgrade Capacitor majors.
  2. 标题：这意味着对于你的应用 @capgo/cli@latest — CLI major sync with Capacitor/plugins is unnecessary.
  3. 继续使用 Capacitor 7 (或更早版本)? 使用 @lts-v7 (或匹配的标签)，而不是几个月前的随机旧 7.x 从几个月前
  4. 使用 semver 为自己的实时更新包版本化 与 __CAPGO_KEEP_0__ 对其包版本化方式相同。请参阅 the same way Capgo versions its packages. See 和 版本目标 相关文档.
添加应用
  • context — 安装命令和LTS标签用于更新器
  • CLI概述 — 如何运行Capgo CLI命令
  • 原生兼容性 — 当一个更改需要一个商店二进制文件而不是OTA包
  • 从V7到V8 — 一个Capacitor对齐插件的重大升级示例