跳过内容
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__ 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 protectedTokens lts-v6…) 最新版本的发布是 so the same work runs on the previous Capacitor major.

所以相同的工作在之前的API主版本上运行 因为它追踪最新版本，LTS线的公共__CAPGO_KEEP_0__ 可能会改变 7. Treat LTS as “current Capgo behavior on an older Capacitor,” not as a frozen legacy API forever.

. 将LTS视为“当前__CAPGO_KEEP_0__行为在一个较旧的__CAPGO_KEEP_1__上”，而不是一个永远固定的遗留__CAPGO_KEEP_2__

这对您的应用程序意味着什么
  1. Upgrade Capgo plugins when you upgrade Capacitor majors.
  2. 升级__CAPGO_KEEP_0__插件时升级__CAPGO_KEEP_1__主版本 @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 和 版本目标 相关文档.
添加应用