应用页面

应用页面显示哪些内容？

首先，让我们来看看应用的主页面：

在 Capgo 中，App 指你集成了 Capgo 的 live update 系统的移动应用。你可以用它无缝管理更新、频道和设备。

我们仔细看看。主应用页面分为几个关键区域：

1. 顶部导航栏： 用于访问主要的 App 管理视图。截图仅供参考；当前控制台包含：

   • Dashboard： App 的指标和汇总。
   • Observe （beta）：原生启动、WebView、问题和发布健康度信号。
   • 信息： 应用核心设置和详情（参见 App 信息).
   • Bundle: 版本与发布。
   • 通道: 更新通道与渐进式发布控制。
   • 设备: 已注册设备与覆盖配置。
   • 日志: 日志洞察 以及原始日志。
   • Builds： Native Build 管理。

2. 统计数据展示： 可视化上一个账单周期的重要指标（数据反映的是自账单日起的用量，而非每月 1 日）：

   • 月活跃用户数 (8)： 追踪随时间变化的独立活跃用户数量。
   • 存储空间 (9)： 显示当前的存储消耗情况。
   • 带宽 (10)： 显示带宽使用情况。
   • 活跃 Bundle (11)： 显示不同 app bundle 之间活跃设备的分布情况。

3. 概览卡片： 快速查看关键数据统计：

   • Bundle Uploads (12)： 已上传的 app bundle 总数。
   • 更新统计 (13)： 执行的更新总数，包括请求、安装和失败。
   • 部署统计 (14)： 部署总数。

4. 显示选项 (15-18)： 用于筛选和查看统计数据的控件：

   • 每日 (15)： 按天查看统计数据。
   • 累计 (16)： 查看随时间变化的累计统计数据。
   • 计费周期 (17)： 查看当前账单周期的统计数据。
   • 日期范围 (18): 选择自定义日期范围（例如：过去 30 天）。

App 信息

此部分对应顶部导航栏中的“Information”标签页 (1)。在这里，您可以查看并管理应用程序的关键详情与设置。

App Information 页面

截图版本早于当前控制台，可能未显示所有最新设置。请以下方字段说明为准。

以下是可用字段和操作的详细说明：

• 应用图标 (2): 显示您的应用程序图标。您可以点击“Change”按钮来 upload 新图标。
• App ID (3): 您的应用在 Capgo 中的唯一标识符。此 ID 不可修改。
• 应用名称 (4): 应用的显示名称。您可以根据需要进行修改。
• 默认上传 Channel (5): 指定新 bundle 默认上传到的 channel。您可以点击编辑图标来选择其他默认 channel。
• 默认下载 Channel (6): 指定设备下载更新时默认使用的 channel。您可以点击编辑图标来选择其他默认 channel。Channel 页面会显示该 channel 是否为默认，但您需要在此处进行更改，而不是通过 channel 上的开关。打开一个 channel 并点击 在 App 设置中管理 即可跳转至此字段。详情请参阅下方的 默认 Channel 配置 章节。
• 自动删除未使用 Bundle (x 秒后) (7): 此设置允许您自动删除在指定时长（以秒为单位）内未使用的旧 bundle。设置为 0 以禁用自动删除。这有助于管理存储空间并保持 bundle 列表整洁。
• 向插件暴露 Bundle 元数据 (8): 启用后，bundle 链接和注释字段将发送至 Capacitor Updater 插件。此功能需要 7.35.0 或更高版本的插件。
• 拦截服务商基础设施请求: 启用后，Capgo 会拒绝来自已知 Google 和 Apple 数据中心 IP 段的 update、stats 和 channel-self 请求。请保持启用以确保正常的生产流量。仅在您有意从服务商基础设施进行测试时才临时禁用。新应用默认启用此保护；现有应用将保留之前的禁用设置，直到您手动更改。
• 转移 App 所有权 (9): 此部分提供了一个选项，用于将您的应用转移到您所属的其他组织。
• 删除 App 按钮: 从 Capgo 中永久删除您的应用。此操作不可逆，并将移除所有关联的数据、bundle、channels 和 devices。
• 更新按钮: 保存您对本页面可编辑字段所做的任何更改（例如：应用名称、默认上传 Channel、自动删除 Bundle 设置）。

默认 Channel 配置

本指南中介绍的 默认下载 Channel 是您应用中最重要的设置之一。它决定了新设备在首次连接 Capgo 时，将从哪个 channel 获取更新。

默认 Channel 的工作方式

当设备向 Capgo 请求更新时，系统会按以下优先级（从高到低）决定使用哪个 channel：

1. 强制设备映射：如果设备 ID 在 channel 设置中被显式强制指定到某个 channel，则该 channel 始终优先。
2. 云端覆盖: 如果设备已通过 dashboard 或 Public API 被分配到某个 channel，则优先使用该覆盖设置。
3. 插件 setChannel(): 在当前的 plugin 版本中，这属于本地分配，而非 dashboard 覆盖。请参阅 设备如何选择 channel.
4. Capacitor 配置 defaultChannel: 如果在你的 capacitor.config.* 文件中设置，则用于测试/beta 版本。
5. 默认下载 Channel: 此处配置的设置。约 99% 的生产环境用户将使用此设置。

平台专属默认 Channel

你可以配置特定平台的默认 channel——例如分别为 iOS、Android 和 Electron 配置。这在以下场景非常有用：

• 你想先在一个平台推送更新，再推送到另一个平台
• 你需要针对不同平台采用不同的更新策略
• 你正在一个平台上测试新版本，同时让另一个平台保持稳定

要设置特定平台的默认配置：

1. 为每个平台创建独立的 channel（例如 production-ios, production-android，以及 production-electron)
2. 在每个 channel 的设置中，只启用对应平台（iOS、Android 或 Electron 开关）
3. 当 App 信息），并将这些 channel 分别设为对应平台的默认下载 channel。当这些 channel 面向不同平台时，Capgo 允许设置多个默认 channel。

当设备请求更新时：

• iOS 设备会从已启用 iOS 的默认 channel 接收更新
• Android 设备将从支持 Android 的默认 channel 获取更新

单一默认 Channel（推荐大多数 App 使用）

对于大多数应用，使用一个支持所有三个核心平台的单一默认 channel 是最简单的方案：

1. 创建一个 channel（例如， production)
2. 确保已启用 iOS、Android 和 Electron 开关
3. 将其设置为 Default Download Channel App 信息

这能确保所有平台行为一致，并简化您的发布工作流。

修改默认 Channel

当您更改默认 channel 时：

• 新设备 将立即开始接收新的默认配置更新
• 现有设备 若已分配了 channel（通过 override 或 force），则不会自动切换
• 若要迁移现有设备，您需要：
  • 使用 setChannel() (或 unsetChannel()) 从 App 中删除。仅删除后端设备记录并不会清除本地 setChannel() 分配。
  • 在 dashboard 中强制将其切换至新 channel (console/API override；90 天后过期)
  • 删除其 console/API override，使其遵循优先级规则。仅保留 cloud default 的设备随后将获取新的默认配置。

提示: 在将新默认 channel 设为所有用户的默认 channel 之前，请务必先在一小批强制更新设备上测试。

从 App Page 继续

如果你正在使用 应用页面 要规划 dashboard 和 API 操作，请将其连接到 API 概览 关于 API Overview 中的实现细节， 简介 关于 Introduction 中的实现细节， API 密钥 有关 API Keys 的实现细节， 设备 有关 Devices 的实现细节，以及 Bundle 有关 Bundles 中的实现细节。