跳过内容
Capgo - Capacitor 应用程序的实时更新 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 共享主版本。 您不需要 __CAPGO_KEEP_0__ 主版本，因为您正在使用 __CAPGO_KEEP_0__ 8 或更新版本。 始终安装或调用最新的 Capacitor。

  • 最新的 __CAPGO_KEEP_0__ 和控制台与任何支持的版本保持兼容性。 __CAPGO_KEEP_0__ and __CAPGO_KEEP_1__ and __CAPGO_KEEP_2__ use their own versions You do not need CLI major because you are on CLI 8 or updater 8 Always install or invoke the latest Capacitor 8.
  • The latest __CAPGO_KEEP_0__ and __CAPGO_KEEP_1__ and __CAPGO_KEEP_2__ remain compatible with any supported __CAPGO_KEEP_0__ and __CAPGO_KEEP_1__ and __CAPGO_KEEP_2__ do not share major versions with plugins or __CAPGO_KEEP_0__ CLI and __CAPGO_KEEP_1__ and __CAPGO_KEEP_2__ use their own versions
  • You do not need CLI major because you are on CLI 8 or updater @capgo/capacitor-updater （及其相关更新器）主版本。

建议不要使用旧版本的 CLI。推荐：

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

之前插件主版本的LTS标签

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

当您在较旧的 Capacitor 主版本上停留时，请使用LTS dist标签安装匹配的 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发布 按需.

更新器的后向兼容性与其他插件

Updater backports vs 其他插件
包重大版本后端
@capgo/capacitor-updater每月镜像后端到 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 stays available for Capacitor 4 but is not on that monthly cadence
其他Capgo插件按需

相同功能，镜像版本号

相同功能，镜像版本号

长期支持线路镜像当前最新线路的修订和补丁版本，当存在后端时

如果最新版本是 8.3.4，则Capacitor 7 长期支持线路发布 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 , …) 版本是 lts-v6最新版本的后端 LTS 是最新版本的后端 所以同样的工作在之前的 Capacitor 主版本上运行。

因为它追踪最新的，LTS 行的公共 API 可能会改变 当最新的变更 — 即使主版本号保持不变时 7。将 LTS 视为“当前 Capgo 行为在一个较旧的 Capacitor 上”，而不是一个永远的 API 遗留系统。

这对您的应用程序意味着什么

关于您的应用程序意味着什么的部分
  1. 在升级 Capgo 主版本时升级 Capacitor 插件
  2. 始终运行 @capgo/cli@latest — CLI 主版本与 Capacitor/plugins 的同步是多余的
  3. 保持在 Capacitor 7（或较旧的）？使用 @lts-v7 （或匹配的标签），而不是一个随机的旧版本 7.x 从几个月前开始。
  4. 使用 "__CAPGO_KEEP_0__" 的方式为您的实时更新包版本化。请参阅 包版本化和渠道 the same way Capgo versions its packages. See 版本目标 相关文档 标题：相关文档.
—— 安装命令和长期支持标签（LTS）