功能

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

核心更新系统

即时更新 (OTA)

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

关键功能：

• 后台下载
• 自动安装
• 无用户干扰
• 跨平台支持 (iOS、Android、Electron)

了解更新行为 →

---

差分更新 (差异更新)

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

关键功能：

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

了解更多关于delta更新 →

---

自动回滚

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

关键功能：

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

了解更多关于回滚 →

---

校验和验证 & 备用

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

关键功能：

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

---

更新破坏检测

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

关键功能：

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

了解版本目标的更多信息 →

---

部署控制

[__CAPGO_KEEP_0__]

[__CAPGO_KEEP_1__]

[__CAPGO_KEEP_2__]

• [__CAPGO_KEEP_3__]
• [__CAPGO_KEEP_4__]
• [__CAPGO_KEEP_5__]
• [__CAPGO_KEEP_6__]
• [__CAPGO_KEEP_7__]

[__CAPGO_KEEP_8__]

---

[__CAPGO_KEEP_9__]

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

关键功能：

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

---

频道策略

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

关键功能：

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

了解更多关于频道政策 →

---

开发者工具

打包预览

在部署到设备之前，在web控制台中预览打包，预览打包在web控制台中的App部分的Bundle部分的预览选项卡

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

---

实时调试

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

使用:

npx @capgo/cli app debug [appId]

显示:

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

---

查看打包清单

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

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

显示：

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

---

原生插件依赖项

查看所有本地 Capacitor 插件，了解每个捆绑包中依赖项的变化。

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

显示：

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

---

CLI Integration

全面命令行接口，用于自动化部署和 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

---

[__CAPGO_KEEP_0__]

[__CAPGO_KEEP_2__]

[__CAPGO_KEEP_3__]

[__CAPGO_KEEP_4__]

• [__CAPGO_KEEP_5__]
• [__CAPGO_KEEP_6__]
• [__CAPGO_KEEP_7__]
• [__CAPGO_KEEP_8__]
• 版本分布

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

---

设备日志

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

事件类型：

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

位置:

• Web Dashboard → App → 设备 → 日志
• Web Dashboard → App → 日志 (所有设备)

了解更多关于日志 →

---

包使用分析

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

指标:

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

---

__CAPGO_KEEP_0__

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

• __CAPGO_KEEP_4__
• __CAPGO_KEEP_5__
• __CAPGO_KEEP_6__
• __CAPGO_KEEP_7__

__CAPGO_KEEP_8__ __CAPGO_KEEP_9__

---

__CAPGO_KEEP_10__

完整的打包部署、通道分配和配置变更审计记录。

跟踪事件：

• 打包上传
• 通道分配
• 策略变更
• 设备覆盖

位置： 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 控制台 → 组织 → 安全

了解更多关于 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 →

---

审计日志

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

记录事件：

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

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

---

Webhooks

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

支持事件：

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

Features:

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

位置: Web Dashboard → 组织 → Webhooks

---

多用户协作

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

功能:

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

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

---

API 密钥管理

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

密钥功能：

• 按应用或按组织分配密钥
• 可选过期日期
• 不可逆的存储（Hashed storage）
• 支持密钥轮换

位置： 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 秒)
• Auto-update policy (autoUpdate - 关闭, 后台, 安装, 启动, 总是, 只下载)
• Network requirements (Android only - via WorkManager)

了解更多关于更新行为 →

---

Update Types

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

Available types:

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

了解更新类型 →

---

积分系统

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

功能：

• 积分使用追踪
• 使用提醒
• 通过 Stripe 充值
• 积分账单

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

---

开始使用

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

需要帮助？

• 获取社区支持 查看常见问题
• 浏览__CAPGO_KEEP_0__文档 Section titled “Need Help?”
• Browse API documentation 为 API 集成
• 联系支持 为企业协助

从功能继续

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