跳过主要内容

如何CI/CD工具触发OTA更新

了解CI/CD工具如何通过自动化流程来增强OTA更新,确保应用程序部署更快、更安全、更可靠。

Martin Donadieu

Martin Donadieu

内容营销总监

如何CI/CD工具触发OTA更新

CI/CD工具通过自动化流程使OTA更新更快、更安全、更可靠。具体来说:

  • 什么是OTA更新? 他们让您通过CDN即刻更新应用程序资产,如HTML、CSS和JavaScript,避免应用商店审批延迟。
  • CI/CD的帮助: 自动化工具,如 GitHub Actions 简化关键步骤,如构建检查、安全验证和部署,降低错误率72%,并实现同日修复。
  • 关键功能:
    • 安全性: 使用HTTPS、code签名和加密来保护更新。
    • 阶段性发布: 先将更新部署到小组中,以早期捕捉问题。
    • 回滚选项: 如果错误率上升,则自动回滚更新。
  • 工具高亮: Capgo 通过CLI命令、webhook集成和详细的指标跟踪来简化OTA更新。

通过OTA自动化更新来确保更快的交付、更少的错误和更好的应用稳定性。以下是设置CI/CD管道来 Capacitor 应用的步骤指南。

Appflow 实时更新:直接将更新部署到您的用户

Appflow CI/CD 平台界面

准备中 Capacitor 为 OTA 更新

Capacitor 框架文档网站

为 Capacitor 配置 自动进行 (OTA) 更新涉及三个关键步骤:配置设置、实施安全措施和 集成更新系统。 这个过程确保与 CI/CD 自动化兼容,同时保持应用程序的安全性。

在 capacitor.config.json 中配置 OTA 设置

首先更新文件并添加必要的参数: capacitor.config.json 设置合适的检查频率可以减少更新延迟 - 减少它们的47%

{
  "appId": "com.example.app",
  "appVersion": "2.3.1",
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://api.example.com/ota",
      "checkFrequency": 3600,
      "channel": "production"
    }
  }
}

实施 OTA 更新安全措施 [2].

__CAPGO_KEEP_0__

确保OTA更新过程的安全性至关重要,以避免未经授权的更新并保护您的应用程序的完整性。这涉及三个保护层:

安全层 实施 目的
HTTPS安全 证书固定 阻止中间人攻击
Code签名 ed25519签名 确认更新的有效性
包安全 AES-256-GCM加密 保护更新内容

为了应用这些安全功能,请在您的配置中包含以下内容:

{
  "security": {
    "publicKey": "-----BEGIN PUBLIC KEY-----...",
    "requireSignedUpdates": true,
    "validateChecksums": true
  }
}

配置 Capgo OTA更新

Capgo OTA更新控制台界面

Capgo 简化了 OTA更新流程。首先,请安装所需的插件:

npm install @capgo/capacitor-updater

接下来,请将 Capgo 特定的设置添加到您的 capacitor.config.json 文件:

{
  "plugins": {
    "CapacitorUpdater": {
      "apiKey": "CAPGO_XXXX",
      "channel": "production",
      "debug": true
    }
  }
}

Capgo 使用语义版本控制,带有构建标识符,如 2025.02.12-a1b2c3d 以便精确跟踪更新。这样可以更轻松地管理和监控您的应用程序的更新生命周期。

创建 OTA更新管道

一旦您在Capgo中设置了Capacitor环境,下一步就是将其与CI/CD工具进行链接,以便自动更新。这样可以确保更新是安全高效的,同时保持应用程序稳定。

自动更新的Webhook设置

在CI/CD设置中,您的Webhook可以自动触发更新,任何code发生变化时。例如,在GitHub Actions中,您可以创建一个工作流文件,如下所示:

name: OTA Update Trigger
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Trigger OTA Update
        run: |
          curl -X POST \
          -H "X-Capgo-Signature: sha256=${{ secrets.CAPGO_SECRET }}" \
          -H "Authorization: Bearer ${{ secrets.CAPGO_API_KEY }}" \
          https://api.capgo.app/deploy

确保在CI/CD平台的加密存储中安全存储您的API密钥和密钥 以保护敏感数据 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__更新命令

Capgo CLI提供了关键命令来简化更新管理流程。以下是典型的部署工作流程示例:

The Capgo CLI offers key commands to streamline update management within your pipeline. Here’s an example of a typical deployment workflow:

命令 目的 构建
__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ capgo deploy --channel production 上传新构建文件
测试 capgo promote build-123 --group beta 将更新发布到测试组
验证 capgo metrics get --last-24h 检查更新成功指标
发布 capgo promote build-123 --channel stable 将更新部署到所有用户

更新回滚方法

拥有可靠的回滚机制对于保持应用稳定至关重要。您的系统应该能够检测问题并自动回滚更新。例如,您可以使用健康检查端点监控错误率并在需要时触发回滚:

# Rollback script triggered by monitoring
if [ $(curl -s https://api.capgo.app/metrics/errors) -gt 5 ]; then
  capgo rollback v1.2 --channel production
  notify-team "Update rolled back due to high error rate"
fi

这种方法帮助 Gunnebo Safe Storage 将停机时间从小时级缩短到分钟级 [6].

对于高风险的更新,考虑使用 Capgo 的分阶段发布功能。它允许您将更新部署到较小的用户组中,减少在全面发布之前出现广泛问题的机会。

sbb-itb-f9944d2

OTA更新方法

分阶段更新和用户组

分阶段更新让您控制更新如何发布,确保用户体验顺畅。例如, Capgo 的 promote 命令(讨论过的)帮助管理beta组。有企业数据表明,近半数的应用程序(49%)需要每月更新 [4],分阶段发布成为稳定应用程序并逐渐发布更改的关键策略。

基于指标的更新触发器

自动更新 基于性能指标的更新可以节省时间并防止问题。通过设置监控webhook,您可以跟踪重要的指标并决定是否继续或暂停更新:

指标类型 阈值 动作
崩溃率 >2% 暂停发布
错误率 >0.5% 警告团队

您可以将这些检查集成到CI/CD管道中,实现无缝监控。例如:

if [ $(curl -s $MONITORING_API/crash-rate) -gt 2 ]; then
  capgo pause-rollout --channel production
  notify-team "Update paused: High crash rate detected"
fi

这些指标直接与性能跟踪系统相关联,我们将在下一节中探讨。

快速响应更新

当面临严重的安全问题或重大bug时,需要快速部署更新。使用专门用于紧急情况的快速通道,包括设备认证检查和自动回滚选项,以最小化风险。

For urgent updates, you can deploy using a dedicated channel:

capgo deploy --critical --channel hotfix

为了进一步提高交付速度并满足合规要求,考虑使用地理位置基准的渠道与CDN规则。这确保了更新能够高效地到达用户,无论其所在位置如何。

更新性能跟踪

一旦您建立了更新交付方法后,接下来就是测量它们的效果了。使用这些关键性能指标来保持对当前情况的掌控:

更新成功指标

请注意以下三个主要方面: 部署完成率, 验证时间用户采用率. 对于移动应用程序,部署成功率通常在95%至99%之间 [1]. 通过实时监控您的CI/CD管道,您可以实现目标:

指标 目标 严重阈值
部署完成 >98% <95%
验证时间 <45s >120s
用户采纳率 (24h) >75% <50%

错误管理更新

自动系统可以跟踪更新状态并响应错误。对于重大问题,系统应该在设备健康检查检测到问题时自动回滚更新。以下是一个实例:

if [ $DEVICE_SUCCESS_RATE -lt 85 ]; then
    trigger_rollback
fi

这种设置确保了关键故障能够快速解决,减少对用户的干扰。

数据使用量减少

增量更新是减少数据使用量的好方法,相比于全量更新,增量更新可以缩小包大小70-90%。 [4]这些优化可以直接在CI/CD管道中构建,使用以下规则:

  • 增量更新: 只包含已更改的组件的二进制差异。
  • : 将图像转换为格式如WebP或AVIF以减少文件大小。: 在网络流量较低的时间段进行更新以最小化影响。
  • CI/CD管道增量更新

translations

With automated OTA updates integrated into CI/CD pipelines, Capacitor deployments can move from weekly cycles to hourly updates. Simplified Chinese protectedTokens Cloudflare for Capacitor apps [3] GitHub Capgo code [5]API

SDK CLI 用户 目前 73% 的团队 现在使用预合并 CI 检查 [1][2],从而在生产之前发布更高质量的版本。这些努力与数据驱动的部署策略的早期讨论相一致。

自动化管道还确保使用压缩格式和差分更新的更新可靠地传递。通过结合自动化测试、分阶段发布和性能跟踪,团队可以以高效和安全的方式管理Capacitor应用程序更新。

从 CI/CD 工具触发 OTA 更新的下一步

如果您正在使用 从 CI/CD 工具触发 OTA 更新的下一步 来规划安全性和合规性,连接它与 加密 加密的实现细节 合规 针对 Compliance 的实现细节 Capgo 安全扫描器 针对 Capgo 安全扫描器的产品工作流程 Capgo 安全 针对 Capgo 安全的产品工作流程,并且 Capgo 信任中心 针对 Capgo 信任中心的产品工作流程

实时更新Capacitor应用

当web层bug处于活跃状态时,通过Capgo将修复推送到用户,而不是等待几天的应用商店审批。用户在后台接收更新,而原生变化保持在正常的审批路径中。

立即开始

最新博客文章

Capgo 为您提供了创建真正专业的移动应用所需的最佳见解。