功能

复制一个安装步骤和完整的Markdown指南的设置提示。

本页面提供了有关Capgo实时更新的全面概述。每个功能都包括简要描述和详细文档的链接。

核心更新系统

实时更新

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

关键功能：

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

了解更新行为 →

Delta Updates (Differential Updates)

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

关键功能：

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

了解更多关于delta更新 →

自动回滚

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

关键功能：

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

了解更多关于回滚 →

校验和验证及降级

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

关键功能：

下载时的校验和验证
损坏检测
自动 fallback 到最后一次工作的捆绑包
可用手动恢复工具

破坏性更新检测

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

关键功能：

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

了解版本目标 →

部署控制

频道系统

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

关键功能：

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

了解更多关于频道 →

设备目标

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

关键功能：

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

频道策略

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

关键功能：

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

了解频道政策 →

开发者工具

打包预览

在部署到设备之前，在web控制台中预览打包，预览打包在live web环境中可用。

位置： Web 控制台 → App → Bundle → 预览 tab

实时调试

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

使用：

npx @capgo/cli app debug [appId]

显示：

更新检查
下载进度
安装状态
错误消息
policy blocks

Bundle Manifest Viewer

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

位置： 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 自动清理
预定清理任务
存储使用跟踪

Usage:

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

分析与监控

更新统计

跟踪用户群中更新采用率、成功率和部署进度等指标.

可用指标：

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

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

设备日志

设备每次更新的完整生命周期日志，从检查到安装。

事件类型：

更新检查
下载开始/完成/失败
安装开始/完成/失败
回滚事件
隐私政策

位置：

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

了解更多关于日志 →

包使用分析

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

指标：

每个包的活跃安装数
下载次数
每个包的存储使用情况
__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

通过频道跟踪性能和采用度指标。

指标：

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

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

部署历史

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

跟踪事件：

捆绑包上传
通道 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 强制 (2FA 强制)

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

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

了解更多关于 2FA →

加密包文件强制

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

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

团队协作

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

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

组织角色：

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

应用角色：

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

位置：

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

了解更多关于 RBAC →

审计日志

完成所有组织和应用活动的完整审计记录，用于合规和安全。

记录事件：

用户操作（登录，注销，权限更改）
Bundle operations (upload, delete, assign)
Channel operations (create, update, delete)
Organization changes (settings, members)

位置： Web Dashboard → Organization → Audit Logs

Webhooks

实时接收应用程序事件的 HTTP 通知。

支持事件：

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 (NEW in 2025)

长期支持

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

当前支持：

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

自定义存储后端

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

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

中国配置

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

了解更多关于中国配置 →

高级功能

自定义更新行为

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

可配置选项：

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

了解更新行为 →

更新类型

可用类型:

后台更新 (默认)

即刻更新
用户控制的安装
用户自主更新
条件更新

了解更新类型 →

积分系统

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

功能：

积分使用跟踪
使用提醒
通过 Stripe 补充积分
积分账单

位置： Web 控制台 → 组织 → 贡献

开始使用

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

需要帮助？

加入我们的 Discord
社区支持查看常见问题解答
浏览 API 文档为 API 整合
联系支持获取企业级支持

继续从功能中

如果您正在使用功能来规划监控和分析，连接它与统计获取统计部分的实施细节日志对于日志中的实现细节 @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.