日志
__CAPGO_KEEP_4__
__CAPGO_KEEP_11__
《了解应用日志》日志页面提供了应用更新事件和诊断信息的详细历史记录。这对于监控更新过程、排查问题和了解设备如何与 Capgo 交互至关重要。您可以通过 点击您的应用 然后 点击“日志”标签（在某些旧的截图或文档中以前称为“更新”）.
从那里您应该看到一个类似的页面，显示日志条目的列表：
日志页面界面包括：
- 日志标签 - 访问日志视图的导航标签
- 刷新按钮 - 最新数据更新后重新刷新日志列表
- 时间范围 & 动作过滤器 - 根据时间范围和动作类型（以下各节）过滤日志
每一行显示：
- 时间戳 (UTC)
- 设备 ID
- 动作 code (发生了什么)
- 版本名称 (捆绑包或
builtin)
点击一行以跳转到设备详细页面查看完整历史记录。
按日期范围筛选
按日期范围筛选您可以使用日期选择器在特定时间段内筛选日志:
- 快速预设 - 选择常见时间范围：最近 1 小时、3 小时、6 小时或 12 小时
- 开始时间 - 为范围设置自定义开始时间
- 结束时间 - 为范围设置自定义结束时间
- 日历 - 使用日历视图选择特定日期
Click “Select” to apply your chosen date range, or “Cancel” to dismiss the picker.
根据操作类型进行过滤
Section titled “根据操作类型进行过滤”The Actions dropdown lets you filter logs by specific event types:
Available action filters include:
- 设备心跳 - 设备周期性健康检查
- 版本删除请求 - 当一个捆绑版本被删除时
- 恢复到默认版本 - 设备恢复到内置包时
- 版本安装成功 - 包安装成功
- 新版本发送到设备 - 当Capgo向设备发送更新时
- 版本安装失败 - 包安装失败
使用顶部的搜索框快速找到特定动作类型。您可以选择多个动作以显示匹配任何选定类型的日志。
样本日志片段（假数据）
样本日志片段（假数据）| 时间（UTC） | 设备 ID | 动作 | 版本 | 它告诉你什么 |
|---|---|---|---|---|
| 2025-01-14 10:00:01 | A1B2C3 | get | 2.4.1 | 设备询问 Capgo 是否有可用的更新 |
| 2025-01-14 10:00:03 | A1B2C3 | download_manifest_start | 2.4.1 | 清单获取启动; SDK 即将下载文件 |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | 捆绑下载完成 40% |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | zip 文件下载完成 |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | 捆绑安装并标记为下一次运行 |
| 2025-01-14 10:05:00 | B9C8D7 | disableAutoUpdateToMajor | 1.9.0 | 渠道策略阻止跳转到 2.x |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | 内置 | 设备达到请求限制; SDK 等待重启 |
设备日志场景
设备日志场景为了帮助您了解日志的含义，我们提供了示例序列，展示了真实设备更新的旅程：
成功更新流程
成功更新流程这是您的日志中健康更新的样子：
| 时间 | 设备ID | 动作 | 版本 | 含义 |
|---|---|---|---|---|
| 10:00:01 | a1b2c3d4 | get | 1.2.0 | 设备检查更新并接收到版本 1.2.0 的信息 |
| 10:00:02 | a1b2c3d4 | download_10 | 1.2.0 | 下载开始，10%完成 |
| 10:00:03 | a1b2c3d4 | download_50 | 1.2.0 | 下载中，50% |
| 10:00:05 | a1b2c3d4 | download_complete | 1.2.0 | 下载成功 |
| 10:00:06 | a1b2c3d4 | set | 1.2.0 | 包裹安装并激活 |
设备已是最新版本
设备已是最新版本设备检查时已有最新版本：
| 时间 | 设备ID | 操作 | 版本 | 说明 |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | 设备已经是最新版本，更新不需要 |
更新失败并回滚
回滚更新失败当更新失败并回滚时：
| 时间 | 设备ID | 操作 | 版本 | 说明 |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | 设备接收到更新信息 |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | 下载完成 |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | 设置包 |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | 应用程序崩溃或未被调用 - 回滚触发 notifyAppReady() 内置 |
| 11:15:11 | i9j0k1l2 | reset | 设备恢复到内置版本 | 需要动作 |
: 检查您的应用程序是否在初始化成功后调用详细信息，请参见 notifyAppReady() 插件文档 下载失败 当网络问题阻止下载时：
内置
需要动作: 检查您的应用程序是否在初始化成功后调用
| 时间 | 设备 ID | 操作 | 版本 | 这意味着什么 |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.0 | 设备接收到更新信息 |
| 09:45:01 | m3n4o5p6 | download_30 | 1.2.0 | 下载开始但… |
| 09:45:15 | m3n4o5p6 | download_fail | 1.2.0 | 下载失败（网络超时，连接丢失等） |
需要操作: 设备将在下一次应用启动时自动重试。除非发生频繁错误，否则无需执行任何操作。
计划限制已达到
标题：计划限制已达到当您的帐户达到设备限制时：
| 时间 | 设备ID | 操作 | 版本 | 这意味着什么 |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | 直到您升级或billing周期重置，这个设备将不会接收更新 |
需要采取的行动: 升级您的计划 或等待下一个billing周期。
渠道配置阻止更新
渠道配置阻止更新When channel settings prevent an update:
| 时间 | 设备ID | 操作 | 版本 | 这意味着什么 |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | 设备在v1.x上无法自动更新到v2.x（重大版本跳转被阻止） |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | 模拟器检测到，并且频道阻止模拟器 |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | 开发版检测到，并且频道阻止开发版 |
需要操作: 这些是有意的保护措施。如果您想允许这些更新，请修改您的 频道设置.
Capgo 日志代码
Capgo 日志代码这些代码来自 stats_action API (capgo/src/types/supabase.types.ts) 中的枚举。 如果您在 UI 中看到新的 code，它是由 SDK 或后端发出的，并且已验证为此列表中的项。
__CAPGO_KEEP_0__ 快乐路径和生命周期
| Code(s) | 含义 |
|---|---|
get | 设备要求 Capgo 获取当前频道清单 |
download_manifest_start, download_manifest_complete | 清单下载开始/完成（对于delta或多文件包） |
download_zip_start, download_zip_complete | zip 压缩包下载开始/完成 |
download_10 … download_90 | 下载进度里程碑 |
download_complete | 整个捆绑包下载完成 |
set | 捆绑包已为下次启动准备 |
reset | 设备已恢复到内置捆绑包 |
delete | 捆绑包已从本地存储中移除 |
uninstall | 应用卸载检测 |
app_moved_to_foreground, app_moved_to_background | 应用生命周期事件由SDK记录 |
ping | 设备健康/心跳检查 |
setChannel, getChannel | 通道被SDK覆盖或拉取 |
配置或策略阻止
| Code(s) | 为什么更新被阻止 |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | 通道策略禁止此操作 semver 跳过 |
disablePlatformIos, disablePlatformAndroid | 平台在此频道上被禁用 |
disableDevBuild, disableEmulator | 开发版或模拟器不允许 |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | 频道选择或覆盖失败 |
missingBundle, cannotGetBundle | 清单指向一个包 Capgo 无法提供 |
needPlanUpgrade | 组织已达到其计划/设备限制 |
rateLimited | 太多请求; SDK 将在重启前进行限制 |
blocked_by_server_url, backend_refusal, InvalidIp | 服务器端规则阻止了请求 |
下载 / 整合 / 安装失败
| Code(s) | 含义 |
|---|---|
download_fail | 包下载失败（网络或响应错误） |
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail | 无法获取或验证清单文件 |
checksum_fail, checksum_required | 完整性检查失败或校验和丢失 |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | 文件系统或解压验证失败 |
decrypt_fail | 解密失败（加密包） |
update_fail | 安装了包但应用程序从未调用 notifyAppReady(); 回滚触发 |
download_zip_* 无后续 set | 下载完成但安装阶段从未完成 |
➡️ 需要更深入的code指导？请参见 完整日志Code参考和调试指南.
获取关于日志的更多详细信息
标题为“获取关于日志的更多详细信息”如果您点击特定日志条目，它通常会带您到设备的页面。 查看该设备的完整历史记录可以帮助您诊断设备相关问题或了解其更新过程。继续从日志
继续从日志
如果您正在使用日志 来规划仪表板和__CAPGO_KEEP_0__操作，连接它与__CAPGO_KEEP_0__概览 API概览 为API概览提供实施细节的 for the implementation detail in API Overview, 为介绍提供实施细节的 for the implementation detail in Introduction, API 键 为 API 键的实现细节 设备 为设备的实现细节 包 为包的实现细节