特性

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

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

核心更新系统

无线更新

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

关键功能：

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

了解更新行为 →

增量更新（差异更新）

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

关键功能：

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

了解更多关于增量更新 →

自动回滚

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

关键功能：

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

了解更多关于回滚 →

校验和验证 & 回退

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

关键功能：

下载校验
数据损坏检测
自动切换到上一个可用的包
手动恢复工具可用

破坏性更新检测

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

关键功能：

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

了解更多关于版本目标 →

部署控制

频道系统

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

关键功能:

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

了解更多关于频道 →

设备目标

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

关键功能：

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

频道策略

根据每个频道配置规则和限制，更新如何分发。

关键功能：

禁用自动更新
阻止主要版本更新
禁用模拟器更新
禁用开发版更新
平台特定政策（仅限iOS，仅限Android，仅限Electron）

了解更多关于频道政策 →

开发者工具

预览包

在实时Web环境中预览包裹，免于在设备上部署，通过Web控制台访问。

位置： 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控制台 → 应用 → 统计

设备日志

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

事件类型：

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

位置：

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

了解更多关于日志 →

包使用分析

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

指标：

每个包的活跃安装数
下载量统计
每个包的存储使用量
带宽使用量

频道统计

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

指标：

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

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

部署历史

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

跟踪事件:

包上传
频道 assignments
策略更改
设备覆盖

位置: 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)

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

组织角色：

org_super_admin - 组织控制权限
org_admin - 组织管理（无 billing/deletion 权限）
org_billing_admin - 只有 billing 权限
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 控制台 → 组织 → 安全

平台支持

多平台支持

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

支持的平台:

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

长期支持

Continued support for older Capacitor versions to maintain compatibility with legacy apps.

当前支持:

Capacitor 8 (latest)
Capacitor 7
Capacitor 6
Capacitor 5

自定义存储后端

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

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

中国配置

了解更多关于中国配置 →

高级功能

自定义存储后端

自定义更新行为

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

可配置选项：

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

了解更新行为 →

更新类型

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

可用类型：

后台更新 (默认)
即刻更新
用户触发更新
条件更新

了解更新类型 →

积分系统

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

功能:

积分使用跟踪
使用提醒
通过 Stripe 充值
Live Updates功能

位置： Web控制台 → 机构 → 信用

开始使用

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

设置第一个应用程序并开始使用__CAPGO_KEEP_0__ Live Updates。

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

继续查看Features

如果您正在使用 Features 来规划监控和分析，连接它与统计为统计的实现细节日志为日志的实现细节 @capgo/capacitor-appinsights 为@capgo/capacitor-appinsights的实现细节使用@capgo/capacitor-appinsights 为使用@capgo/capacitor-appinsights的原生能力 @capgo/capacitor-firebase-analytics for the implementation detail in @capgo/capacitor-firebase-analytics.