如何使用语义版本控制与 Capgo OTA更新

想简化应用程序更新和版本控制？ 语义版本控制（SemVer）与 Capgo的即时更新（OTA）功能结合起来，管理 Capacitor 应用程序更容易和更快。以下是如何做到的：

语义版本控制基础： 使用的版本格式为 MAJOR.MINOR.PATCH:
- MAJOR: 主要版本更新
- MINOR: 新功能，向后兼容
- PATCH: 修复bug
为什么要使用 SemVer 与 Capgo?
- 清晰的更新通知
- 更智能的版本管理
- 避免依赖冲突
- 有序的发布计划
Capgo 安装步骤：
1. 安装 Capgo 的更新插件.
2. 配置应用程序的版本在 capacitor.config.json 和其他文件中.
3. 使用您的 API 密钥初始化.
4. 使用 Capgo CLI 来打包和上传更新.
管理版本和频道:
- 使用单独的频道（例如，测试“beta”，稳定发布“production”）。
- 控制更新策略（自动更新补丁，重大更改手动批准）。
- __CAPGO_KEEP_0__
部署流程：
- 更新版本号遵循SemVer规则。
- 在部署之前，务必进行充分的测试。
- 使用CLI命令上传和分发更新。

Capgo确保更新快速可靠地到达用户，提供工具来处理中断并维持稳定性。适合使用CI/CD工作流程自动化更新的团队。

快速提示： 始终测试更新并使用渠道来有效地管理阶段性发布。

语义版本控制 | 提升水平

Capgo 设置指南

Capgo 实时更新控制台界面

以下是如何设置Capgo来轻松管理实时更新和版本控制。

初始设置步骤

首先安装 Capgo 更新插件:

npm install @capgo/capacitor-updater  
npx cap sync

确保您的 capacitor.config.json 文件使用语义版本格式:

{ 
  "appId": "com.example.app", 
  "appName": "My App", 
  "version": "1.0.0" 
}

对于较旧的项目，更新版本详细信息在以下位置:

package.json (查找 version 字段)
android/app/build.gradle (更新 versionName)
ios/App/App.xcodeproj/project.pbxproj (更新 CURRENT_PROJECT_VERSION)

配置完成后，使用您的API密钥初始化Capgo:

npx @capgo/cli@latest init YOUR_API_KEY

快速参考表格：

设置阶段	密钥操作	验证步骤
安装	安装插件并同步	检查 `package.json`
配置	设置版本号	在所有文件中验证
初始化	与 API key 建立连接	测试连接状态
构建	创建初始包	确认上传成功

版本控制集成

Capgo 与 CI/CD 平台兼容，自动更新简单。支持的平台包括:

如果您正在进行本地开发，为了禁用自动更新，请将以下内容添加到您的配置中：

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

这确保了Capgo不会覆盖您的本地修改。一旦您的设置就绪，上传您的第一个版本：

npx @capgo/cli@latest bundle upload  
npx @capgo/cli@latest channel set production -s default

最后，在您的应用程序的主文件中通知本机插件关于捆绑包健康状况：

import { CapacitorUpdater } from '@capgo/capacitor-updater';  
CapacitorUpdater.notifyAppReady();

这确保了您的应用程序准备好进行平滑的OTA部署和版本管理。

使用语义版本号管理Capgo

版本号管理

Capgo使用语义版本号（SemVer）管理应用程序版本，格式为 MAJOR.MINOR.PATCH。这是如何工作的：

主版本号（X.0.0): 增加 MAJOR 数字以修复不兼容的更改。
Minor Version (1.X.0): 增加 MINOR 数字以添加不影响兼容性的新功能。
Patch Version (1.0.X): 增加 PATCH 数字以修复不影响兼容性的 bug 修复。

版本类型	何时递增	自动更新行为
Major (X.0.0)	为了修复 API 的破坏性更改	需要手动批准
Minor (1.X.0)	For new features	在 Capgo 中可配置
Patch (1.0.X)	For bug fixes	通常自动

通过遵循 SemVer 规则，您可以简化版本管理并确保您的部署通道中的更新更顺畅。

版本控制指南

Capgo 允许您通过设置不同阶段的工作流程的不同通道来有效地管理部署。

基于通道的版本管理:通过创建用于测试和生产的独立通道来组织您的部署过程。例如：
- 使用“beta”通道（例如 1.2.0-beta）进行测试新功能。
- 保持“生产”通道（例如 1.2.0）用于稳定发布。
- 在解决平台特定问题时，添加平台特定通道（例如，“ios-hotfix”版本1.2.1）
更新策略配置：使用Capgo的配置选项来控制更新的应用方式。例如：
```
{
  "plugins": {
    "CapacitorUpdater": {
      "disableAutoUpdate": "minor"
    }
  }
}
```
此设置确保用户自动接收补丁更新，而小版本和大版本更新需要手动批准
版本回滚策略：使用预发布标识符来维护清晰的回滚选项。这一方法允许您在出现问题时回滚到之前的版本，同时保持所有通道的版本号一致

这些最佳实践使得管理更新、测试新功能和维持应用部署过程的稳定性变得更加容易

sbb-itb-f9944d2

OTA更新部署

一旦您的版本管理设置准备就绪，请按照以下步骤有效地部署OTA更新

更新准备

首先更新版本在 package.json 和 capacitor.config.json确保版本遵循 SemVer 格式（主版本.次版本.修订版本）：

Bug 修复：增加修订版本号（例如，1.0.1 → 1.0.2）
新功能：增加次版本号（例如，1.0.0 → 1.1.0）
重大变更：增加主版本号（例如，1.0.0 → 2.0.0）

彻底测试您的构建并确认应用程序与服务器通信使用 notifyAppReady.

接下来，决定您的更新策略. 你可以选择:

自动更新:自动强制执行最小版本要求。
手动控制:为更新指定具体版本要求。
频道:使用频道进行测试和阶段性发布。

Capgo CLI 更新命令

使用Capgo的CLI轻松部署更新。这里是如何做到的:

# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]

# Upload your update bundle
npx @capgo/cli bundle upload [appId]

# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]

Capgo确保安全部署，使用端到端加密和安全密钥管理。

“@Capgo是一种聪明的方式来进行热code推送（而不是像@AppFlow那样花所有的钱 🙂）”

一旦部署完成，您可以通过Capgo的控制台监控更新。更新通常在用户打开应用程序后几分钟内就可以到达。整个过程如下：

应用程序检查更新。
在后台下载更新。
在用户退出应用程序时将新版本标记为活动。
在下一次启动时应用更新。

对于企业级部署，您可能需要集成CI/CD自动化。

“我们实行敏捷开发，@Capgo在持续向用户交付方面是 mission-critical！”

问题解决和提示

版本管理问题

在Capgo中管理语义版本号有时会使更新部署复杂化。为了避免覆盖开发工作，请在您的 capacitor.config.json 文件中配置以下内容：

{ 
  "plugins": { 
    "CapacitorUpdater": { 
      "autoUpdate": false 
    } 
  } 
}

如果更新失败，请尝试以下方法：

设置 autoUpdate 为 false 开发期间
卸载应用程序
重新安装它使用修正的版本
重新启用自动更新一旦一切稳定

对于主要版本更新，使用 disableAutoUpdateBreaking 标志并监听 majorAvailable 事件以正确处理更新：

CapacitorUpdater.addListener('majorAvailable', (info) => {
  console.log(`Major update available: ${info.version}`);
  // Add your update prompt logic here
});

通过将这些配置与良好的团队实践结合起来，您可以维护版本一致性并减少错误

团队版本控制

一旦个人更新被管理，团队就必须建立强大的版本控制实践

“在合并到主仓库之前测试每个变更将加强稳定性并避免昂贵的错误” [4]

确保一致性的方法有：

定义一个分支作为 主仓库 作为真实来源
为开发和生产环境使用独立的Capgo频道.
通过CI/CD管道自动上传版本.
以清晰详细的提交信息记录所有code变更.

对于更大的团队，以下版本管理矩阵可以帮助组织更新：

环境	频道	自动更新	版本模式
开发	dev	禁用	0.x.x
测试	beta	启用	x.x.x-beta
生产	stable	启用	v.v.v

更新恢复步骤

即使采取了预防措施，更新也可能失败。如果发生这种情况，请遵循以下恢复步骤：

回滚到上一个稳定的捆绑包。
为任何新修复增加版本号（注意：版本号在删除后不能重复使用） [2].
在应用启动时验证更新，以确保它们按预期工作。

Capgo的更新器旨在处理中断。例如，如果服务器不可达或更新被删除，应用将继续正常运行 [3]此外，失败的网络请求将在下一次应用启动时自动重试 [3]这项内置的弹性功能最小化了停机时间并确保了更顺畅的运作

概要

语义版本控制，结合了Capgo，使Capacitor应用的OTA更新更高效。通过将947.6亿次更新交付给并且1,400个生产应用使用了此系统 [1],部署过程已经变得高效了81% [1]. 这种设置允许开发者快速推送更新并在受控的方式下进行，绕过应用商店的延迟。

开发者们在说：

“我们在生产环境中推出了 Capgo OTA更新，我们的用户数量超过5000。我们看到 OTA部署到@Capgo后，大多数用户在几分钟内都能保持最新状态。” - colenso [1]

MAJOR.MINOR.PATCH版本系统使得轻松地沟通重大更新、新功能和bug修复 [5]. 这尤其有帮助，尤其是当团队通过Capgo的平台管理多个每周的发布时

Capgo的加密解决方案,与CI/CD工具集成，也是节省成本的方式 - 在五年内节省了$26,100 [1]. 自定义频道确保更新在正确的时间到达正确的用户

“我们实行敏捷开发，@Capgo在持续交付给用户方面是 mission-critical！” - Rodrigo Mantica [1]

继续使用如何使用语义版本控制与Capgo OTA更新

如果您正在使用 如何使用语义版本控制与Capgo OTA更新 来规划回滚和版本控制，连接它与回滚回滚的实现细节在回滚中版本目标版本目标的实现细节在版本目标中更新行为更新行为的实现细节在更新行为中打包打包的实现细节在打包中 Capgo 实时更新为产品工作流程在 Capgo 实时更新中使用.