跳过内容
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 控制台 不 不与插件或 Capacitor 共享主要版本。

  • 您可以 不 因为您正在使用 CLI 8 或更新器 8 始终安装或调用最新的 Capacitor 8.
  • __CAPGO_KEEP_0__ 和控制台使用自己的版本 latest 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发布 按需发布.

Updater 后端 vs 其他插件

标题：Updater 后端 vs 其他插件
包前一个主要版本的后端
@capgo/capacitor-updater每月镜像后端到 v7 / v6 / v5 (lts-v7, lts-v6, lts-v5). lts-v4 在 Capacitor 4 中保持可用，但不在该月度计划中
其他 Capgo 插件按需

按需

相同功能，镜像版本号

标题：相同功能，镜像版本号

长期支持线路镜像当前最新线路的次要和补丁版本，当存在后端时。 8.3.4，Capacitor 7 LTS 线发布为 7.3.4 同一特性集和 bug 修复 ，适用于该__CAPGO_KEEP_0__ 主版本安装时使用标签，当您想要“此Capacitor 主版本的最新”时：

安装时使用标签“Capacitor”主版本的最新版本。

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

LTS 是最新的后端

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

(或 lts-v7 …）发布是 lts-v6context 最新版本的回溯 因此，相同的工作在之前的Capacitor主版本上运行。

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

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

标题：这对您的应用程序意味着什么
  1. 在升级Capgo主版本时升级Capacitor插件。
  2. 始终运行 @capgo/cli@latest — CLI主版本的同步与Capacitor/插件的同步是多余的。
  3. 仍然在Capacitor 7（或较旧的）上？使用 @lts-v7 （或匹配的标签），而不是一个随机很久以前的 7.x 几个月前
  4. 使用版本号（semver）来版本自己的实时更新包 版本号 同样的方式 Capgo 包管理其版本。见 包版本和渠道 和 版本目标.
相关文档