功能
Copy a setup prompt with the install steps and the full markdown guide for this plugin.
本页面提供了有关Capgo实时更新的全面概述。每个功能都包括简要描述和详细文档的链接。
核心更新系统
标题：核心更新系统实时更新
标题：实时更新直接将 JavaScript、HTML、CSS 和资产更新部署到用户端，无需通过应用商店审批。更新在后台下载并在下一次应用重启时应用。
关键功能：
- 后台下载
- 自动安装
- 无用户中断
- 跨平台支持（iOS、Android、Electron）
Delta Updates (Differential Updates)
《Delta Updates (Differential Updates)》只下载版本之间变化的文件，降低带宽使用量达95%，并加速更新推送。
关键功能：
- 自动文件级别差异
- 校验和基准验证
- 清单比较
- 智能fallback到全更新时需要
自动回滚
《自动回滚》如果更新加载失败或导致崩溃，系统会自动切换到最后一次工作版本。
Key capabilities:
- 崩溃检测
- 超时检测
- 自动回滚
- 不需要用户干预
校验和验证 & fallback
校验和验证 & fallback通过校验和验证包完整性，并在检测到损坏时自动切换到最后一次工作版本。
Key capabilities:
- 下载时校验和验证
- 损坏检测
- 自动回退到最后一次工作的捆绑包
- 手动恢复工具可用
更新检测
更新检测防止不兼容的更新被应用到运行旧版本机code版本的设备。
关键功能：
- 本机版本兼容性检查
- 插件依赖项验证
- 自动阻止不兼容的更新
- 清晰的错误消息
部署控制
部署控制频道系统
频道系统灵活的频道配置让您能够在不同环境和用户群中组织和管理更新。
关键功能：
- 无限个自定义频道（生产、测试、beta等）
- 每个频道的包装分配
- 频道特定目标规则
- 设备自我分配
- 设备覆盖频道
设备目标
设备目标设置针对特定设备、版本或用户群进行阶段性发布和受控部署。
主要功能：
- 版本目标
- 设备特定覆盖
- 平台过滤（iOS、Android、Electron）
- 自定义元数据过滤
- 模拟器/开发版阻止
渠道策略
渠道策略配置每个渠道更新如何分发的规则和限制。
主要功能：
- Disable auto-updates
- Block major version updates
- Disable updates on emulators
- Disable updates in development builds
- Platform-specific policies (iOS-only, Android-only, Electron-only)
Learn more about channel policies →
Developer Tools
Section titled “Developer Tools”Bundle Preview
Section titled “Bundle Preview”Preview bundles in a live web environment before deploying to devices, accessible from the web dashboard.
Location: Web 控制台 → App → Bundle → 预览 tab
实时调试
标题：实时调试实时监控特定设备的更新事件，通过 CLI 展示检查、下载、安装和错误事件。
使用方法：
npx @capgo/cli app debug [appId]显示：
- 更新检查
- 下载进度
- 安装状态
- 错误消息
- 《隐私政策》
打包清单查看器
《打包清单查看器》查看任何打包的完整清单，包括文件列表、校验和和元数据。
位置： Web 控制台 → 应用 → 打包 → 清单选项卡
显示：
- 文件列表（带校验和）
- 打包元数据
- 原生版本兼容性
- 插件依赖项
原生插件依赖项
Native Plugin Dependencies查看所有本机Capacitor插件，了解每个版本的依赖项变化。
位置： Web控制台 → 应用 → 包 → 依赖项标签
显示：
- 插件名称和版本
- 依赖项添加/删除
- 兼容性警告
CLI Integration
CLI集成全面的命令行界面，用于自动化部署和CI/CD集成。
关键命令：
bundle upload- 上传新包bundle list- 列出所有包bundle delete- 删除包bundle cleanup- 清理旧包channel set- 配置频道app debug- 实时调试
包加密
标题：包加密对包进行端到端加密，使用 AES-256 加密，保护您的 code 在传输和存储过程中。
关键功能：
- 生成 RSA 密钥对
- __CAPGO_KEEP_0__
- Code
- __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__根据保留策略自动清理旧包以管理存储使用
关键功能：
- 可配置的保留计数
- 通过 CLI 自动清理
- 预定清理任务
- 存储使用情况跟踪
Usage:
npx @capgo/cli bundle cleanup --keep=10分析与监控
分析与监控更新统计
更新统计跟踪用户群中更新采用率、成功率和部署进度
可用指标：
- 下载成功率
- 安装成功率
- 错误类型的错误率
- __CAPGO_KEEP_0__
- 版本分布
位置： Web控制台 → 应用 → 统计
设备日志
设备日志每台设备的事件日志，显示完整的更新生命周期，从检查到安装。
事件类型：
- 更新检查
- 下载开始/完成/失败
- 安装开始/完成/失败
- 回滚事件
- 政策块
位置：
- Web Dashboard → App → Device → 日志
- Web Dashboard → App → 日志 (所有设备)
包使用分析
关于“包使用分析”部分详细分析哪些包处于活跃状态，下载次数和存储使用情况。
指标：
- 包安装次数
- 下载次数
- 包存储使用情况
- 带宽使用量
频道统计
频道统计跟踪每个频道的性能和采用度指标。
指标：
- 每个频道的设备数量
- 每个频道的更新成功率
- 部署历史
- 每个频道的错误率
位置： Web 控制台 → 应用 → 频道 → 统计
部署历史
部署历史所有捆绑包部署、通道 assignments 和配置更改的完整审计记录。
跟踪事件：
- 捆绑包上传
- 通道 assignments
- 策略更改
- 设备覆盖
位置： Web 控制台 → 应用 → 通道 → 历史
安全性 & 合规
部署历史所有捆绑包部署、通道 assignments 和配置更改的完整审计记录。
Section titled “全链路加密”在传输和存储时使用业界标准的AES-256加密来加密包装。
Code Signing
Section titled “Code Signing”使用加密签名来验证包装完整性，防止篡改。
SOC 2 Type II Compliance
Section titled “SOC 2 Type II Compliance”企业安全的基础设施和流程已获得SOC 2 Type II认证。
App Store Compliance
Section titled “App Store Compliance”完全符合Apple App Store和Google Play Store OTA更新的政策。
组织级别的 2FA 强制 (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 控制台 → App → 访问
审计日志
审计日志部分所有组织和 App 活动的完整审计记录，用于合规和安全。
记录事件：
- 用户操作（登录，注销，权限变更)
- Bundle operations (upload, delete, assign)
- Channel operations (create, update, delete)
- Organization changes (settings, members)
位置： Web Dashboard → Organization → Audit Logs
Webhooks
实时通知实时接收应用程序事件的通知，通过 HTTP webhook。
支持事件：
apps- 应用程序创建/更新/删除app_versions- 包上传/删除channels- 频道创建/更新/删除org_users- 成员添加/删除orgs- 组织更新
Features:
- 自定义 webhook URL
- 事件过滤
- 传递日志
- 重试机制
- 测试功能
位置: Web Dashboard → 组织 → Webhooks
多用户协作
多用户协作部分邀请团队成员加入您的组织，指定角色和权限。
功能：
- 电子邮件邀请
- 角色分配
- 成员管理
- 权限撤销
位置： Web 控制台 → 组织 → 成员
API 密钥管理
标题为“API 密钥管理”的部分创建、管理和撤销 API 密钥，支持可选的过期日期和散列存储。
密钥功能：
- 每个应用或每个组织的密钥
- 可选过期日期
- 散列存储（不可逆）
- 密钥轮换支持
位置： Web 控制台 → API 密钥
密码策略
密码策略部分组织级密码要求以强制实施安全标准
可配置策略：
- 最小长度
- 需要大写
- 需要数字
- 需要特殊字符
位置： Web Dashboard → Organization → Security
平台支持
平台支持部分多平台支持
多平台支持部分支持 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)
更新类型
关于不同更新类型的部分适用于不同场景的不同更新类型，从即时更新到用户控制的安装。
可用类型:
- 后台更新 (默认)
- 即时更新
- __CAPGO_KEEP_0__
- __CAPGO_KEEP_1__
__CAPGO_KEEP_2__
__CAPGO_KEEP_3__基于使用的计费系统，使用积分购买带宽、存储和其他资源的服务。
功能：
- 积分使用记录
- 使用提醒
- 通过 Stripe 充值
- 积分账单
__CAPGO_KEEP_4__ Web Dashboard → 组织 → 贡献
Getting Started
名为“Getting Started”的部分准备好使用这些功能了吗？ 请遵循我们的 快速入门指南 来设置第一个应用程序并启用 Capgo 实时更新功能。
需要帮助吗？
名为“需要帮助？”的部分- 加入我们的Discord 获取社区支持
- 查看常见问题 查阅常见问题
- 浏览 API 文档 为 API 整合
- 联系支持 获取企业级支持
继续从功能中
功能标题：继续从功能中如果您正在使用 功能 来规划监控和分析，连接它与 统计 获取统计的实施细节在统计中 日志 为日志中的实现细节 @capgo/capacitor-appinsights 为@capgo/capacitor-appinsights中的实现细节 使用@capgo/capacitor-appinsights 为使用@capgo/capacitor-appinsights的本机功能 @capgo/capacitor-firebase-analytics 为@capgo/capacitor-firebase-analytics中的实现细节