功能

复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。

本页全面介绍了 Capgo Live Updates 的所有功能。每项功能均附有简要说明及详细文档链接。

核心更新系统

空中更新 (OTA)

直接向用户部署 JavaScript、HTML、CSS 和资源更新，无需应用商店审批。更新将在后台下载，并在下次应用重启时生效。

核心功能：

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

了解更新行为详情 →

增量更新（差分更新）

仅下载版本之间发生变化的文件，最多可减少 95% 的带宽使用，并加快更新交付速度。

核心功能：

自动文件级差异比对
基于校验和的验证
增量文件对比
必要时智能回退至全量更新

详细了解增量更新 →

自动回滚

如果更新加载失败或导致崩溃，系统会自动回退到上一个已知可用的版本。

核心功能：

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

了解回滚详情 →

校验和验证与回退

通过校验和验证 bundle 完整性，若检测到损坏，自动回退到上一个已知可用的版本。

核心功能：

下载时的校验和验证
损坏检测
自动回退到上一个可用的 bundle
手动恢复工具可用

破坏性更新检测

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

核心功能：

原生版本兼容性检查
插件依赖验证
自动拦截不兼容更新
清晰的错误提示

了解版本定向 →

部署控制

渠道系统

通过灵活的 Channel 配置，跨不同环境和用户群体组织并管理更新。

核心功能：

不限数量的自定义 Channel（生产、预发布、Beta 等）
按 Channel 分配 Bundle
Channel 专属定向规则
设备自主分配
按设备覆盖 Channel

了解更多关于 Channel 的信息 →

设备定向

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

核心功能：

基于版本定向
设备级覆盖
平台筛选（iOS、Android、Electron）
自定义元数据筛选
阻止模拟器/开发构建

渠道策略

为每个 Channel 配置更新下发的规则与限制。

核心功能：

禁用自动更新
阻止大版本更新
禁用模拟器上的更新
在开发构建中禁用更新
平台特定策略（仅限 iOS、仅限 Android、仅限 Electron）

了解渠道策略详情 →

开发者工具

Bundle 预览

在部署到设备之前，可在实时 Web 环境中预览 bundle，直接从 Web dashboard 访问。

位置： Web dashboard → App → Bundle → 预览选项卡

实时调试

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

用法：

npx @capgo/cli app debug [appId]

显示内容：

更新检查
下载进度
安装状态
错误信息
策略拦截

Bundle 增量文件查看器

检查任意 bundle 的 delta 文件，包括文件列表、校验和及元数据。

位置： Web Dashboard → App → Bundle → Delta files 选项卡

显示内容：

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

原生插件依赖

查看每个 bundle 中包含的所有原生 Capacitor 插件，以跟踪跨版本的依赖变更。

位置： Web Dashboard → App → Bundle → Dependencies 选项卡

显示内容：

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

CLI 集成

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

主要命令：

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

查看完整 CLI 参考 →

Bundle 加密

使用 AES-256 加密对 bundle 进行端到端加密，保护您的 code 在传输和存储过程中的安全。

核心功能：

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

进一步了解加密 →

Bundle 清理与保留

根据保留策略自动清理旧 bundle，以管理存储用量。

核心功能：

可配置的保留数量
通过 CLI 实现自动清理
定时清理任务
存储用量追踪

用法：

npx @capgo/cli bundle cleanup --keep=10

分析与监控

更新统计

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

可用指标：

下载成功率
安装成功率
按类型划分的错误率
随时间变化的更新采用率
版本分布

位置： Web Dashboard → 应用 → 统计

设备日志

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

事件类型：

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

位置：

Web Dashboard → 应用 → 设备 → 日志
Web Dashboard → App → Logs（所有设备）

详细了解 logs →

Bundle 使用分析

详细分析各 bundle 的活跃状态、下载次数和存储占用。

指标：

每个 bundle 的活跃安装数
下载次数
每个 bundle 的存储占用
带宽使用情况

渠道统计

按渠道跟踪性能与采用率指标。

指标：

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

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

部署历史

所有 bundle 部署、channel 分配和配置变更的完整审计日志。

跟踪事件：

Bundle 上传
Channel 分配
策略变更
设备覆盖

位置： Web 控制台 → 应用 → 渠道 → 历史记录

安全与合规

端到端加密

使用行业标准 AES-256 加密，对静态和传输中的 bundle 进行加密。

进一步了解加密 →

Code 签名

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

SOC 2 Type II 合规

基础设施和流程符合 SOC 2 Type II 标准，确保企业级安全。

App Store 合规性

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

了解更多合规信息 →

强制执行 2FA（组织级）

要求所有组织成员在访问 dashboard 和 API 时启用双因素认证。

位置： Web Dashboard → 组织 → 安全

详细了解 2FA →

强制使用加密 Bundle

在组织级别要求所有 bundle 必须加密。

位置： Web Dashboard → 组织 → 安全

团队协作

基于角色的访问控制（RBAC）

细粒度的权限管理，用于组织和应用级别的访问控制。

组织角色：

org_super_admin - 完全组织控制权
org_admin - 组织管理（无计费/删除权限）
org_billing_admin - 仅限计费访问
org_member - 组织只读访问

应用角色：

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

位置：

Web Dashboard → 组织 → 成员
Web Dashboard → 应用 → 访问

了解更多关于 RBAC →

审计日志

完整的组织与应用活动审计追踪，用于合规与安全。

记录的事件：

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

位置： Web Dashboard → 组织 → 审计日志

Webhooks

通过 HTTP webhooks 实时接收应用内事件通知。

支持的事件：

apps - 应用创建/更新/删除
app_versions - Bundle 上传/删除
channels - Channel 创建/更新/删除
org_users - 成员添加/移除
orgs - 组织更新

功能：

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

位置： Web Dashboard → 组织 → Webhooks

多用户协作

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

功能：

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

位置： Web Dashboard → 组织 → 成员

API 密钥管理

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

核心功能：

按应用或按组织的密钥
可选过期日期
哈希存储（不可逆）
支持密钥轮换

位置： Web Dashboard → API 密钥

详细了解 API keys →

密码策略

组织级密码要求，用于落实安全标准。

可配置策略：

最小长度
必须包含大写字母
必须包含数字
必须包含特殊字符

位置： Web Dashboard → 组织 → 安全

平台支持

多平台支持

只需一个 SDK 即可支持 iOS、Android 和 Electron 应用。

支持的平台：

iOS (Capacitor 5、6、7、8)
Android（Capacitor 5、6、7、8）
Electron (2025 年新增)

长期支持（LTS）

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

当前支持的版本：

Capacitor 8（最新）
Capacitor 7
Capacitor 6
Capacitor 5

自定义存储后端

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

详细了解自定义存储 →

中国区配置

面向在中国大陆分发的 App 的特殊配置，以满足当地法规要求。

了解更多中国区配置 →

高级功能

自定义更新行为

通过 SDK 配置检查和应用更新的时机与方式。

可配置选项：

检查间隔 (periodCheckDelay - 最短 600 秒)
自动更新策略 (autoUpdate - off, atBackground, atInstall, onLaunch, always, onlyDownload)
网络要求（仅限 Android - 通过 WorkManager）

了解更新行为详情 →

更新类型

针对不同用例的多种更新类型，从即时更新到用户控制安装。

可用类型：

后台更新（默认）
即时更新
用户提示更新
条件更新

了解更新类型 →

积分系统

基于用量的计费，涵盖带宽、存储及其他资源积分。

功能：

积分用量跟踪
用量警报
通过 Stripe 充值
积分账本

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

快速入门

准备好开始使用这些功能了吗？请按照我们的快速入门指南为你的第一个应用配置 Capgo Live Updates。

需要帮助？

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

继续探索功能

如果你正在使用功能若要规划监控与分析，请将其连接至统计数据查看 Statistics 中的实现细节，日志查看 Logs 中的实现细节， @capgo/capacitor-appinsights 查看 @capgo/capacitor-appinsights 中的实现细节，使用 @capgo/capacitor-appinsights 查看“使用 @capgo/capacitor-appinsights”中的原生能力，以及 @capgo/capacitor-firebase-analytics 查看 @capgo/capacitor-firebase-analytics. 中的实现细节