特性
复制一个包含安装步骤和本插件的完整Markdown指南的配置提示。
本页面提供了 Capgo Live Updates 中所有可用功能的全面概述。每个功能都包括简要描述和详细文档的链接。
核心更新系统
标题：核心更新系统无线更新（OTA）
标题：无线更新（OTA）直接将 JavaScript、HTML、CSS 和资产更新部署到用户端，无需通过应用商店审批。更新在后台下载，下次应用重启时应用。
关键功能：
- 后台下载
- 自动安装
- 无用户中断
- 跨平台支持（iOS、Android、Electron）
增量更新（差异更新）
增量更新（差异更新）仅下载版本之间变化的文件，降低带宽使用量达95%并加快更新传递速度。
关键功能：
- 自动文件级别差异化
- 基于校验和的验证
- 清单比较
- 智能fallback到全更新时
如果更新无法加载或导致崩溃，系统将自动切换回最后一次工作版本。
关键功能：
- 崩溃检测
- 超时检测
- 自动回滚
- 无需用户干预
校验和验证 & 回退
Section titled “校验和验证 & 回退”通过校验和验证包完整性，并在检测到损坏时自动切换回最后一次工作版本。
关键功能：
- 下载校验
- 下载损坏检测
- 自动切换到上一个可用包
- 手动恢复工具可用
更新破坏检测
更新破坏检测防止不兼容的更新被应用到运行较旧的原生code版本的设备
关键功能：
- 原生版本兼容性检查
- 插件依赖性验证
- 自动阻止不兼容的更新
- 清晰的错误提示
部署控制
部署控制频道系统
频道系统通过灵活的频道配置来组织和管理不同环境和用户段的更新。
关键功能:
- 无限个自定义频道（生产、测试、beta等）
- 每个频道的包分配
- 频道特定的目标规则
- 设备自我分配
- 设备级的频道覆盖
设备目标
设备目标针对特定设备、版本或用户群进行分阶段发布和受控部署。
关键功能:
- 版本目标
- 设备特定覆盖
- 平台过滤（iOS、Android、Electron）
- 自定义元数据过滤
- 模拟器/开发版阻止
频道策略
频道策略配置更新规则和限制，控制每个频道上的更新方式。
关键功能：
- 禁用自动更新
- 阻止重大版本更新
- 禁用模拟器上的更新
- 禁用开发构建中的更新
- 平台特定政策（iOS-only，Android-only，Electron-only）
开发者工具
开发者工具预览包
预览包在实时Web环境中预览包裹，免于在设备上部署，通过Web控制台访问。
位置： Web控制台 → 应用 → 包裹 → 预览选项卡
实时调试
标题：实时调试实时监控特定设备的更新事件，通过CLI显示检查、下载、安装和错误事件。
使用方法：
npx @capgo/cli app debug [appId]显示：
- 更新检查
- 下载进度
- 安装状态
- 错误消息
- 策略阻塞
捆绑清单查看器
捆绑清单查看器查看任何捆绑的完整清单，包括文件列表、校验和和元数据。
位置： Web 控制台 → 应用 → 捆绑 → 清单选项卡
显示：
- 文件列表（带校验和）
- 捆绑元数据
- 原生版本兼容性
- 插件依赖
原生插件依赖
原生插件依赖查看每个捆绑包中包含的所有原生Capacitor插件，以跟踪版本之间的依赖项变化。
位置： Web控制台 → 应用 → 捆绑包 → 依赖项选项卡
显示：
- 插件名称和版本
- 依赖项添加/删除
- 兼容性警告
CLI集成
原生CLI集成全自动部署和CI/CD集成的强大命令行接口。
关键命令：
bundle upload- 上传新包bundle list- 列出所有包bundle delete- 删除包bundle cleanup- 清理旧包channel set- 配置频道app debug- 实时调试
包加密
标题：包加密使用AES-256加密对包进行端到端加密，保护您的code在传输和存储时的安全性。
关键功能:
- RSA 密钥对生成
- AES-256 包文件加密
- Code 签名验证
- 加密密钥管理
包文件清理 & 保留
标题：包文件清理 & 保留根据保留策略自动清理旧包文件以管理存储使用。
关键功能:
- 可配置的保留计数
- 通过 CLI 自动清理
- 定时清理任务
- 存储使用情况跟踪
使用情况：
npx @capgo/cli bundle cleanup --keep=10分析与监控
标题：分析与监控更新统计
标题：更新统计跟踪用户基数中更新采用率、成功率和部署进度。
可用指标：
- 下载成功率
- 安装成功率
- 错误类型的错误率
- 更新采用率随时间变化
- 版本分布
位置： Web控制台 → 应用 → 统计
设备日志
标题为“设备日志”的部分显示完整更新周期（从检查到安装）的设备级事件日志。
事件类型：
- 更新检查
- 下载开始/完成/失败
- 安装开始/完成/失败
- 回滚事件
- 策略阻塞
位置：
- Web 控制台 → 应用 → 设备 → 日志
- Web 控制台 → 应用 → 日志 (所有设备)
包使用分析
关于包使用分析的部分详细的分析，显示哪些包处于活跃状态，下载次数和存储使用情况。
指标：
- 每个包的活跃安装数
- 下载量统计
- 每个包的存储使用情况
- 带宽使用情况
频道统计
频道统计跟踪每个频道的性能和采用度指标。
指标：
- 每个频道的设备数
- 每个频道的更新成功率
- 部署历史
- 每个频道的错误率
位置： Web 控制台 → 应用 → 频道 → 统计
部署历史
部署历史所有包部署、频道分配和配置更改的完整审计记录。
跟踪事件：
- 包上传
- 频道分配
- 策略更改
- 设备覆盖
位置： Web 控制台 → 应用 → 频道 → 历史
安全性 & 合规
Section titled “安全性 & 合规性”在传输和存储中使用业界标准的AES-256加密对数据包进行加密。
Code 签名
Section titled “Code 签名”通过加密签名验证数据包完整性，防止篡改。
SOC 2 Type II 合规性
Section titled “SOC 2 Type II 合规性”企业安全的基础设施和流程已获得SOC 2 Type II认证。
App Store 合规性
《App Store 合规性》完全符合苹果 App Store 和 Google Play Store OTA 更新的政策。
组织级 2FA 强制
《组织级 2FA 强制》要求所有组织成员在访问控制台和 API 时使用双因素认证。
位置: Web 控制台 → 组织 → 安全
加密包文件强制
《加密包文件强制》要求所有包文件在组织级别加密。
位置: Web 控制台 → 组织 → 安全性
团队协作
团队协作基于角色的访问控制 (RBAC)
基于角色的访问控制 (RBAC)组织和应用级别的细粒度权限控制。
组织角色：
org_super_admin- 组织控制权限org_admin- 组织管理（无账单/删除）org_billing_admin- 账单访问权限org_member- 只读组织访问权限
应用角色：
app_admin- 对一个应用有完全控制权app_developer- 上传包，管理设备app_uploader- 仅上传包app_reader- 只读访问
位置：
- Web 控制台 → 组织 → 成员
- Web 控制台 → 应用 → 访问
审计日志
标题为“审计日志”的部分为满足合规和安全要求，记录了所有组织和应用活动的完整审计记录。
已记录事件:
- 用户操作（登录，注销，权限变更)
- 包操作（上传，删除，分配)
- 频道操作（创建，更新，删除)
- 组织变更（设置，成员)
位置: Web控制台 → 组织 → 审计日志
Webhooks
Webhooks实时接收关于应用事件的通知，通过 HTTP Webhooks。
支持的事件:
apps- 应用创建/更新/删除app_versions- 应用程序包上传/删除channels- 频道创建/更新/删除org_users- 成员添加/删除orgs- 组织更新
功能:
- 自定义 webhook URL
- 事件过滤
- 传递日志
- 重试机制
- 测试功能
位置: Web 控制台 → 组织 → webhook
多用户协作
多用户协作邀请团队成员加入组织，分配特定角色和权限。
功能：
- 电子邀请
- 角色分配
- 成员管理
- 权限撤销
位置： Web 控制台 → 组织 → 成员
API 密钥管理
API 密钥管理创建、管理和撤销 API 密钥，支持可选的过期日期和散列存储。
功能能力：
- 每个应用或每个组织的密钥
- 可选的过期日期
- 散列存储（不可逆）
- 密钥轮换支持
位置： Web 控制台 → API 密钥
密码策略
关于“密码策略”的部分组织级别的密码要求，以强制实施安全标准。
可配置策略：
- 最小长度
- 要求大写
- 要求数字
- 要求特殊字符
位置： Web 控制台 → 组织 → 安全
平台支持
平台支持支持 iOS、Android 和 Electron 应用程序的单个 __CAPGO_KEEP_0__。
多平台支持支持 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
自定义存储后端
自定义存储后端使用您自己的存储基础设施（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。
需要帮助？继续查看Features
继续查看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.