功能

复制一个包含安装步骤和本插件的完整Markdown指南的设置命令。

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

核心更新系统

无线OTA更新

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

关键功能：

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

了解更新行为 →

差分更新（差异更新）

__CAPGO_KEEP_0__

关键功能：

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

了解更多关于delta更新 →

自动回滚

如果更新无法加载或导致崩溃，系统将自动切换到最后一次已知工作版本。

关键功能：

崩溃检测
超时检测
__CAPGO_KEEP_0__
__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__

__CAPGO_KEEP_7__
__CAPGO_KEEP_8__
__CAPGO_KEEP_9__
__CAPGO_KEEP_10__

__CAPGO_KEEP_11__

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

关键功能：

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

了解版本目标 →

部署控制

频道系统

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

关键功能：

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

了解更多关于通道 →

设备目标

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

关键功能：

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

渠道策略

配置每个渠道更新如何分发的规则和限制。

关键功能：

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

了解更多关于频道政策 →

开发者工具

预览包

在部署到设备之前，在web控制台中预览包在一个实时web环境中，

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

实时调试

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

使用:

npx @capgo/cli app debug [appId]

显示:

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

捆绑清单查看器

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

位置： Web 控制台 → 应用 → 捆绑包 → 清单选项卡

显示：

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

原生插件依赖项

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

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

显示：

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

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 Dashboard → App → 统计信息

设备日志

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

事件类型：

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

位置：

Web Dashboard → App → 设备 → 日志
Web 控制台 → App → 日志 (所有设备)

了解更多关于日志 →

包使用分析

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

指标：

包活跃安装数
下载次数
包存储使用情况
带宽使用情况

渠道统计

__CAPGO_KEEP_0__

指标：

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

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

部署历史

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

跟踪事件：

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

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

安全性和合规

端到端加密

使用业界标准AES-256加密对上传包进行静态和动态加密。

了解更多关于加密 →

Code Signing

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

SOC 2 Type II Compliance

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

App Store Compliance

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

了解更多关于合规性 →

2FA组织级别强制

所有组织成员必须使用双因素认证才能访问仪表板和API。

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

了解更多关于双因素认证 →

加密包文件强制执行

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

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

团队协作

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

组织和应用级别的细粒度权限控制

组织角色：

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

应用角色：

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

Location:

Web Dashboard → →
Web Dashboard → App →

了解更多关于 RBAC

审计日志

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

已记录事件：

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

__CAPGO_KEEP_0__ Web Dashboard → →

Webhooks

实时接收应用事件通知

支持事件:

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

功能:

__CAPGO_KEEP_0__
事件过滤
传递日志
重试机制
测试功能

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

多用户协作

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

功能：

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

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

API密钥管理

使用可选过期时间和散列存储创建、管理和撤销API密钥。

密钥功能：

按应用或按组织分配密钥
可选过期时间
散列存储（不可逆）
__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ Web Dashboard → API Keys

了解更多关于 API keys

密码策略

组织级别的密码要求以强制执行安全标准

可配置的策略：

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

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

平台支持

多平台支持

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

支持的平台：

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

长期支持

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

当前支持:

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

自定义存储后端

Use your own storage infrastructure (S3, R2, etc.) instead of Capgo’s default storage.

中国配置

自定义存储后端

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

了解更多关于中国配置 →

高级功能

自定义更新行为

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

可配置选项:

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

了解更新行为 →

更新类型

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

可用类型：

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

了解更新类型 →

Credit System

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

功能：

积分使用跟踪
使用量警报
通过Stripe进行顶级
积分日志

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

开始使用

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

需要帮助？

查看常见问题查看__CAPGO_KEEP_0__文档
查看__CAPGO_KEEP_0__集成联系支持
Browse API documentation for API integration
protectedTokens 企业级支持

从功能中继续

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