跳过内容
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.
  • __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 和 __CAPGO_KEEP_2__ 控制台不与插件或__CAPGO_KEEP_0__共享主版本。 你不需要__CAPGO_KEEP_0__主版本，因为你正在使用__CAPGO_KEEP_0__8或更新器。 CLI.
  • 最新的CLI和控制台仍然与任何受支持的 @capgo/capacitor-updater (和相关的更新器)主版本兼容。

将旧的CLI版本固定是不鼓励的。请优先使用:

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

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

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

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

终端窗口
# 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 的相同功能集和 bug 修复 , 适应于该__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 和 版本目标 相关文档.
添加应用
  • 添加应用 — 安装命令和LTS标签的更新器
  • CLI概述 — 如何运行Capgo CLI命令
  • 原生兼容性 — 当一个更改需要一个商店二进制文件还是一个OTA包
  • 从V7到V8 — 一个Capacitor对齐插件的重大升级示例