跳过内容
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 主版本匹配。最新的 __CAPGO_KEEP_1__ 与任何支持的更新插件版本兼容。

插件遵循 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主版本上停留时，请安装匹配的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 与其他插件

Updater backports 与其他插件
包上一个主要版本的后端
@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 (or 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 包版本控制和频道 和 目标版本.
相关文档