跳过内容
Capgo - Capgo Live Updates for Capacitor 应用 Capgo

功能

本页面提供了Capgo Live Updates中所有可用功能的全面概述。每个功能都包括简要描述和详细文档的链接。

核心更新系统

标题：核心更新系统

无线更新 (OTA)

无线更新 (OTA) 的功能

直接将 JavaScript、HTML、CSS 和资产更新部署到用户端，无需通过应用商店审批。更新在后台下载，下次应用重启时应用。

关键功能：

  • 后台下载
  • 自动安装
  • 无用户干扰
  • 跨平台支持（iOS、Android、Electron）

了解更新行为 →

差分更新 (Delta Updates)

差分更新 (Delta Updates) 的功能

仅下载版本之间变化的文件，减少带宽使用量达 95%，并加速更新传递。

关键功能:

  • 自动文件级别差异检测
  • 基于校验和的验证
  • 差分文件比较
  • 智能fallback到全更新时需要

了解更多关于差分更新 →

自动回滚

关于“自动回滚”

如果更新加载失败或导致崩溃，系统会自动切换到最后一次工作版本。

关键功能:

  • 崩溃检测
  • 超时检测
  • 自动回滚
  • 无需用户干预

了解更多关于回滚 →

校验和验证 & 回退

校验和验证 & 回退

通过校验和验证包完整性，并在检测到损坏时自动回退到最后一次工作版本。

关键功能:

  • 下载时校验和验证
  • 损坏检测
  • 自动回退到最后一次工作包
  • 可用手动恢复工具

破坏性更新检测

Section titled “Live Update Detection”

防止不兼容的更新在运行较旧的本机code版本的设备上被应用。

关键功能：

  • 本机版本兼容性检查
  • 插件依赖项验证
  • 自动阻止不兼容的更新
  • 清晰的错误消息

了解版本目标 →

部署控制

Section titled “部署控制”

频道系统

Section titled “频道系统”

根据环境和用户群组灵活配置通道，管理和组织更新。

关键功能：

  • 无限个定制通道（生产、测试、beta等）
  • 每个通道的包分配
  • 通道特定目标规则
  • 设备自我分配
  • 设备级别的通道覆盖

了解更多关于通道 →

设备目标

关于设备目标的部分

针对特定设备、版本或用户群组进行分阶段发布和控制部署。

关键功能：

  • 基于版本的目标
  • 设备特定覆盖
  • 平台过滤 (iOS, Android, Electron)
  • 自定义元数据过滤
  • 模拟器/开发版阻止

频道策略

频道策略

为每个频道配置更新的规则和限制。

关键功能：

  • 禁用自动更新
  • 阻止主要版本更新
  • 禁用模拟器更新
  • 开发环境下禁用更新
  • 平台特定政策（iOS-only，Android-only，Electron-only）

了解更多关于频道政策 →

开发者工具

开发者工具

预览包

预览包

在设备部署之前，在网页控制台中预览包，通过网页控制台访问。

位置： 网页控制台 → 应用 → 包 → 预览选项卡

实时调试

实时调试

实时监控特定设备的更新事件通过 CLI,显示检查、下载、安装和错误事件。

使用方法:

终端窗口
npx @capgo/cli app debug [appId]

显示:

  • 更新检查
  • 下载进度
  • 安装状态
  • 错误消息
  • 策略阻塞

Bundle 差异文件查看器

Bundle Delta Files Viewer

查看任何捆绑包的delta文件，包括文件列表、校验和和元数据。

位置： Web控制台 → 应用 → 捆绑包 → Delta文件选项卡

显示：

  • 文件列表（带校验和）
  • 捆绑包元数据
  • 原生版本兼容性
  • 插件依赖项

原生插件依赖项

标题为“原生插件依赖项”的部分

查看每个捆绑包中包含的所有原生Capacitor插件，以跟踪依赖项在版本之间的变化。

位置： Web 控制台 → App → 包 → 依赖项标签

显示:

  • 插件名称和版本
  • 依赖项添加/删除
  • 兼容性警告

CLI 集成

标题：CLI 集成

全面命令行界面，用于自动部署和 CI/CD 集成。

关键命令:

  • bundle upload - 上传新包
  • bundle list - 列出所有包
  • bundle delete - 删除包
  • bundle cleanup - 清理旧版包
  • channel set - 配置频道
  • app debug - 实时调试

查看完整 CLI 参考 →

包加密

标题：包加密

对包进行 AES-256 加密，保护您的 code 在传输和休眠期间的安全性。

关键功能：

  • RSA 密钥对生成
  • AES-256 包加密
  • Code 签名验证
  • 加密密钥管理

了解更多关于加密 →

清理包裹 & 保留

清理包裹 & 保留

根据保留策略自动清理旧包裹以管理存储使用。

关键功能:

  • 可配置的保留计数
  • 通过 CLI 自动清理
  • 预定清理任务
  • 存储使用跟踪

使用:

终端窗口
npx @capgo/cli bundle cleanup --keep=10

功能

Analytics & Monitoring

统计

Update Statistics

跟踪用户群中更新采用率、成功率和部署进度。

可用指标:

  • 下载成功率
  • 安装成功率
  • 错误类型
  • 更新采用率
  • 版本分布

位置: Web 控制台 → 应用 → 统计

设备日志

设备日志

每台设备的事件日志，显示完整的更新周期，从检查到安装。

事件类型：

  • 更新检查
  • 下载开始/完成/失败
  • 安装开始/完成/失败
  • 回滚事件
  • 策略阻塞

位置：

  • Web 控制台 → 应用 → 设备 → 日志
  • Web 控制台 → 应用 → 日志 (所有设备)

了解更多关于日志 →

包使用分析

包使用分析

详细的分析，显示哪些包处于激活状态，下载次数和存储使用情况。

指标：

  • 每个包的激活安装数
  • 下载次数
  • 每个包的存储使用情况
  • 带宽使用情况

频道统计

频道统计

监控每个频道的性能和采用度指标。

指标：

  • 每个频道的设备数
  • 每个频道的更新成功率
  • 部署历史
  • 每个频道的错误率

位置： Web 控制台 → 应用 → 频道 → 统计

部署历史

部署历史

完整的所有包部署、频道分配和配置更改的审计记录。

跟踪事件：

  • 上传包
  • 频道分配
  • 策略变更
  • 设备覆盖

Location: 位置：

Web 控制台 → 应用 → 频道 → 历史

安全性和合规

安全性和合规

端到端加密

端到端加密

以行业标准 AES-256 加密方式在数据存储和传输过程中加密包裹。

Code 签名

Code 签名

通过加密签名验证捆绑包完整性，防止篡改。

SOC 2 Type II 合规

SOC 2 Type II 合规

企业级安全的基础设施和流程已获得SOC 2 Type II认证。

App Store 合规

App Store 合规

完全符合苹果App Store和谷歌Play Store OTA更新的政策。

了解更多关于合规 →

2FA 强制 (组织级)

2FA 强制 (组织级)

要求所有组织成员使用两因素身份验证才能访问仪表板和API。

位置： Web 仪表板 → 组织 → 安全

了解更多关于 2FA →

加密包封

加密包封

要求所有包在组织级别加密。

位置： Web 仪表板 → 组织 → 安全

团队协作

团队协作

角色权限控制 (RBAC)

Section titled “基于角色的访问控制（RBAC）”

组织和应用级访问控制的细粒度权限。

组织角色：

  • org_super_admin - 全部组织控制
  • org_admin - 组织管理（无账单/删除）
  • org_billing_admin - 账单访问权限
  • org_member - 只读组织访问

应用角色：

  • app_admin - 一个应用的完全控制
  • app_developer - 上传包，管理设备
  • app_uploader - 仅上传包
  • app_reader - 只读访问

位置:

  • Web 控制台 → 组织 → 成员
  • Web 控制台 → 应用 → 访问

了解更多关于 RBAC

审计日志

审计日志

为满足合规和安全要求，记录所有组织和应用活动的完整审计记录。

已记录事件:

  • 用户操作（登录，注销，权限变更）
  • 包操作（上传，删除，分配）
  • 频道操作（创建，更新，删除）
  • 组织变更（设置，成员）

位置: Web Dashboard → 机构 → 审计日志

Webhooks

Webhooks

通过 HTTP webhook 接收实时通知，了解您的应用程序发生的事件。

支持的事件:

  • apps - 应用程序创建/更新/删除
  • app_versions - 包上传/删除
  • channels - 频道创建/更新/删除
  • org_users - 成员添加/删除
  • orgs - 机构更新

功能:

  • 自定义 webhook URL
  • 事件过滤
  • 交付日志
  • 重试机制
  • 测试功能

位置： Web 控制台 → 组织 → webhook

多用户协作

多用户协作

邀请团队成员加入您的组织，分配特定角色和权限。

功能：

  • 电子邮件邀请
  • 角色分配
  • 成员管理
  • 权限撤销

位置： Web 控制台 → 组织 → 成员

API 密钥管理

API 密钥管理

创建、管理和撤销 API 密钥，支持可选的过期日期和散列存储。

密钥功能：

  • 应用级或组织级密钥
  • 可选的过期日期
  • 散列存储（不可逆）
  • 密钥轮换支持

位置： Web 控制台 → API 密钥

了解更多关于 API 密钥 →

密码策略

密码策略

组织级别的密码要求，用于强制实施安全标准。

可配置策略：

  • 最小长度
  • 要求大写
  • 要求数字
  • 要求特殊字符

位置: Web 控制台 → 组织 → 安全性

平台支持

标题：平台支持

多平台支持

标题：多平台支持

支持 iOS、Android 和 Electron 应用程序的单个 SDK.

支持的平台:

  • iOS（Capacitor 5, 6, 7, 8）
  • 安卓（Capacitor 5, 6, 7, 8）
  • Electron (2025 年新功能)

长期支持

长期支持

继续支持旧版Capacitor以保持与遗留应用程序的兼容性。

当前支持:

  • Capacitor 8 (最新)
  • Capacitor 7
  • Capacitor 6
  • Capacitor 5

自定义存储后端

自定义存储后端

使用自己的存储基础设施（S3，R2等）而不是Capgo的默认存储。

了解更多关于自定义存储 →

中国配置

Section titled “中国配置”

为遵守中国大陆地区的相关法规，特别配置用于在中国大陆地区发布的应用程序。

了解更多关于中国配置 →

高级功能

Section titled “高级功能”

自定义更新行为

Section titled “自定义更新行为”

通过 SDK 配置更新何时以及如何进行检查和应用。

可配置选项：

  • 检查间隔（periodCheckDelay 分钟最小 10 分钟)
  • 自动更新策略（autoUpdate - off, 背景启动, 安装时, 启动时, 总是, 只下载)
  • Android 设备网络需求 (仅通过 WorkManager)

了解更多关于更新行为 →

更新类型

关于 “更新类型” 的部分

适用于不同场景的不同更新类型，从即刻更新到用户控制的安装。

可用类型:

  • 后台更新 (默认)
  • 即刻更新
  • 用户提示更新
  • 条件更新

了解更多关于更新类型 →

付费系统

付费系统

基于使用的计费系统，使用积分计量带宽、存储空间和其他资源。

功能:

  • 积分使用跟踪
  • 使用提醒
  • 通过Stripe进行顶级
  • 积分账单

位置: Web控制台 → 机构 → 积分

开始使用

开始使用

准备好开始使用这些功能了吗？请遵循我们的 快速入门指南 来设置第一个应用程序并启用Capgo实时更新。

需要帮助？

标题：需要帮助？

继续从功能

功能标题：继续从功能

如果您正在使用 功能 为功能规划监控和分析，连接它到 统计 功能统计的实施细节在统计 日志 功能的实施细节在日志 @capgo/capacitor-appinsights 功能的实施细节在@capgo/capacitor-appinsights 使用@capgo/capacitor-appinsights 为native能力在使用@capgo/capacitor-appinsights, 和 @capgo/capacitor-firebase-分析 为@capgo/capacitor-firebase-analytics实现细节