功能

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

核心更新系统

无线（OTA）更新

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

关键功能：

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

了解更新行为 →

差分更新（Delta Updates）

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

关键功能：

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

了解更多关于delta更新 →

自动回滚

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

关键功能：

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

了解更多关于回滚 →

校验和验证 & fallback

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

关键功能：

下载时进行校验和验证
检测损坏
自动切换到最后一次工作包
可用手动恢复工具

破坏性更新检测

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

关键功能：

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

了解版本目标的更多信息 →

部署控制

通过灵活的通道配置来组织和管理不同环境和用户段的更新。

组织和管理不同环境和用户段的更新，通过灵活的通道配置。

Key capabilities:

无限自定义渠道（生产、测试、beta等）
按渠道分配打包
渠道特定目标规则
设备自我分配
设备级渠道覆盖

了解更多关于渠道 →

设备目标

针对特定设备、版本或用户段进行阶段性发布和受控部署

Key capabilities:

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

渠道策略

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

关键功能：

禁用自动更新
阻止重大版本更新
禁用模拟器更新
禁用开发构建更新
平台特定政策（iOS-only，Android-only，Electron-only）

了解更多关于频道政策 →

开发者工具

打包预览

在部署到设备之前，在web控制台中预览打包，实时查看设备更新事件。

位置： Web控制台 → App → Bundle → 预览选项卡

实时调试

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

Usage:

npx @capgo/cli app debug [appId]

显示:

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

捆绑清单查看器

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

位置: Web 控制台 → 应用 → 打包 → 清单标签

显示:

带校验和的文件列表
打包元数据
原生版本兼容性
插件依赖

原生插件依赖

查看每个打包中包含的所有原生 Capacitor 插件，以便跟踪依赖项版本变化。

位置: Web 控制台 → 应用 → 打包 → 依赖项标签

显示:

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

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

分析 & 监控

更新统计

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

可用指标：

下载成功率
安装成功率
错误类型
时间序列更新采用率
版本分布

位置： Web 控制台 → App → 统计

设备日志

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

事件类型：

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

位置：

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

了解更多关于日志 →

包使用分析

详细分析哪些包处于激活状态、下载次数以及存储使用情况。

指标：

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

渠道统计

跟踪每个渠道的性能和采用度指标。

Metrics:

渠道设备数
渠道更新成功率
部署历史
渠道错误率

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

部署历史

跟踪事件:

打包上传

部署历史
频道分配
策略变更
设备覆盖

位置： Web控制台 → 应用 → 频道 → 历史

安全性和合规

端到端加密

使用业界标准AES-256加密对数据进行在存储和传输时加密。

了解更多关于加密 →

Code 签名

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

SOC 2 Type II 合规

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

App Store 合规

完全符合Apple App Store和Google Play Store OTA更新的政策。

了解更多关于合规 →

组织级别的2FA强制

要求所有组织成员在访问控制台和API时使用两因素身份验证。

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

了解更多关于 2FA →

加密包文件强制执行

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

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

团队协作

基于角色的访问控制 (RBAC)

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__:__CAPGO_KEEP_1__

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

__CAPGO_KEEP_0__:__CAPGO_KEEP_2__

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

位置:

Web 控制台 → 组织 → 成员
Web 控制台 → App → 访问

了解更多关于 RBAC →

审计日志

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

已记录事件：

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

位置： Web 控制台 → 组织 → 审计日志

Webhooks

通过 HTTP Webhooks 接收关于应用程序事件的实时通知。

支持的事件：

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

功能：

自定义 Webhook URL
事件过滤
事件日志
重试机制
测试功能

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

多用户协作

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

功能：

电子邀请
角色分配
成员管理
访问撤销

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

API 密钥管理

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

密钥功能：

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

位置: Web 控制台 → API 密钥

了解更多关于 API 密钥 →

密码策略

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

可配置的策略:

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

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

平台支持

多平台支持

支持使用单个 SDK 开发 iOS、Android 和 Electron 应用

支持的平台：

iOS (支持 Capacitor 5, 6, 7, 8)
Android (支持 Capacitor 5, 6, 7, 8)
Electron (2025 年新功能)

长期支持

继续支持较旧的Capacitor版本，以保持与遗留应用的兼容性。

当前支持：

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

自定义存储后端

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

了解自定义存储 →

中国配置

特别配置 mainland 中国地区发布的应用程序以符合当地法规。

了解更多关于中国配置 →

高级功能

自定义更新行为

配置更新何时和如何检查以及应用程序 SDK。

可配置选项：

检查间隔（periodCheckDelay - 最少 600 秒）
直接更新时间（directUpdate - atInstall, onLaunch, always)
自动更新开关 (autoUpdate)
网络要求 (仅 Android - 通过 WorkManager)

了解更新行为 →

更新类型

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

可用类型：

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

了解更新类型 →

__CAPGO_KEEP_0__

基于使用量的计费，使用积分计量带宽、存储空间等资源。

功能：

积分使用记录
使用提醒
通过Stripe进行充值
积分账单

位置： Web控制台 → 组织 → 积分

开始使用

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

需要帮助？

加入我们的Discord 社区支持
查看常见问题查看__CAPGO_KEEP_0__文档
了解API集成 for API integration
查看__CAPGO_KEEP_0__文档 __CAPGO_KEEP_0__