特性

复制一个包含安装步骤和本插件的完整 Markdown 指南的配置提示。

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

核心更新系统

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

后台下载

自动安装

无用户中断
跨平台支持（iOS、Android、Electron）
跨平台支持（iOS、Android、Electron）
跨平台支持（iOS、Android、Electron）

了解更新行为 →

Delta Updates (Differential Updates)

只下载版本之间变化的文件，降低了带宽使用量达 95%，并加快了更新的传递速度。

关键功能：

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

了解更多关于delta updates →

自动回滚

If an update fails to load or causes crashes, the system automatically reverts to the last known working version.

关键功能：

崩溃检测
超时检测
自动回滚
不需要用户干预

了解更多关于回滚 →

校验和验证 & 回滚

通过校验和验证软件包完整性，并自动回滚到最后一次工作版本，如果检测到损坏。

关键功能：

下载时校验和验证
Corruption detection
Automatic fallback to last working bundle
Manual recovery tools available

Breaking Update Detection

Prevents incompatible updates from being applied to devices running older native code versions.

Key capabilities:

Native version compatibility checking
Plugin dependency validation
Automatic blocking of incompatible updates
Learn more about version targeting →

Learn more about version targeting →

部署控制

频道系统

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

关键功能：

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

了解更多关于频道 →

设备目标

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

关键功能：

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

频道策略

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

關鍵功能：

禁用自動更新
阻止主要版本更新
禁用模擬器中的更新
禁用開發版本中的更新
平台特定政策（iOS-only，Android-only，Electron-only）

了解更多關於頻道政策 →

開發者工具

打包預覽

在部署到設備之前，在網頁控制台中預覽打包，從網頁控制台訪問

位置: Web 控制台 → 应用 → 包 → 预览标签

实时调试

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

使用:

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 → Statistics

设备日志

事件类型：

更新检查

下载开始/完成/失败
安装开始/完成/失败
__CAPGO_KEEP_0__
回滚事件
策略块

位置：

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

了解更多关于日志 →

包使用分析

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

指标：

每个包的活跃安装数
下载次数
每个捆绑包的存储使用量
带宽使用量

频道统计

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

指标：

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

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

部署历史

所有捆绑包部署、通道 assignments 和配置更改的完整审计记录

跟踪事件：

捆绑包上传
通道 assignments
策略更改
设备覆盖

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

安全性 & 合规

端到端加密

在传输和存储时使用业界标准的 AES-256 加密来加密包

了解更多关于加密 →

Code 签名

使用加密签名来验证包完整性并防止篡改

SOC 2 Type II 合规

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

App Store 合规

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

了解更多关于遵守性 →

组织级别的2FA强制 (2FA Enforcement (Organization-level))

要求所有组织成员在访问控制台和API时使用双因素认证。

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

了解更多关于2FA →

加密包文件强制 (Encrypted Bundles Enforcement)

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

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

团队协作

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

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

组织角色：

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

应用角色：

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

位置：

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

了解更多关于 RBAC →

审计日志

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

已记录事件：

用户操作 (登录, 登出, 权限变更)
包操作 (上传, 删除, 分配)
频道操作 (创建, 更新, 删除)
组织变更 (设置, 成员)

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

Webhooks

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

支持事件：

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

功能:

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

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

多用户协作

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

功能：

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

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

API 密钥管理

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

功能优势:

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

位置： Web 控制台 → API 密钥

了解更多关于 API 密钥 →

密码策略

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

可配置的策略：

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

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

平台支持

多平台支持

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

支持的平台：

iOS (Capacitor 5, 6, 7, 8)
Android (Capacitor 5, 6, 7, 8)
Electron (NEW in 2025)

长期支持

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

当前支持：

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

自定义存储后端

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

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

中国配置

为在中国大陆地区发布的应用程序配置特殊设置，以符合当地法规。

了解更多关于中国配置 →

高级功能

自定义更新行为

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

可配置选项：

检查间隔（periodCheckDelay - 最少 600 秒）
自动更新策略（autoUpdate - 关闭，后台，安装，启动，总是，仅下载）
网络要求（仅 Android - 通过 WorkManager）

了解更新行为 →

更新类型

可用类型：

后台更新（默认）

Learn more about update behavior →
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__

了解更新类型 →

积分系统

基于使用的计费系统，使用积分购买带宽、存储和其他资源

功能：

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

Location: Web Dashboard → →

开始使用

准备好使用这些功能了吗？请遵循我们的快速入门指南 to set up your first app with Capgo Live Updates.

需要帮助？

加入我们的社区支持
查看FAQ 常见问题
浏览API文档 API集成
联系支持企业级支持

从特性继续

如果您正在使用特性用于监控和分析规划，连接它统计统计的实现细节日志日志的实现细节 @capgo/capacitor-appinsights @capgo/capacitor-appinsights的实现细节使用@capgo/capacitor-appinsights 使用@capgo/capacitor-appinsights的原生功能 @capgo/capacitor-firebase-analytics @capgo/capacitor-firebase-analytics的实现细节

特性

核心更新系统

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

Delta Updates (Differential Updates)

自动回滚

校验和验证 &#x26; 回滚

Breaking Update Detection

部署控制

频道系统

设备目标

频道策略

開發者工具

打包預覽

实时调试

捆绑清单查看器

原生插件依赖项

CLI集成

包加密

清理包装件 &#x26; 保留

分析与监控

更新统计

设备日志

包使用分析

频道统计

部署历史

安全性 & 合规

端到端加密

Code 签名

SOC 2 Type II 合规

App Store 合规

组织级别的2FA强制 (2FA Enforcement (Organization-level))

加密包文件强制 (Encrypted Bundles Enforcement)

团队协作

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

审计日志

Webhooks

多用户协作

API 密钥管理

密码策略

平台支持

多平台支持

长期支持

自定义存储后端

中国配置

高级功能

自定义更新行为

更新类型

积分系统

开始使用

需要帮助？

从特性继续

校验和验证 & 回滚

清理包装件 & 保留