应用页面

应用页面显示什么?

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

在 Capgo 中，应用代表了您的移动应用与 Capgo 的实时更新系统集成。它允许您轻松管理更新、频道和设备。

让我们更详细地看看。应用的主页面分为几个关键区域:

1. 顶部导航栏: 提供对应用管理主视图的访问。截图是示意性的；当前控制台包含:

   • 仪表盘: 应用的指标和摘要。
   • 观察 (beta): 原生启动、WebView、问题和发布健康信号。
   • 信息: 核心应用设置和详细信息（参见 应用信息).
   • 包: 版本和发布。
   • 频道: 上下文：Capgo发布频道功能名称。页面/区域：Capgo解决方案营销页面。角色：短的UI标签或导航项。见于：页面解决方案/白标签.astro。消息键`solutions_white_label_visual_cell2_value` (解决方案白标签视觉单元2值)。
   • 更新频道和渐进式滚动控制。: 设备
   • 已注册设备和覆盖项。: 日志洞察 和原始日志。
   • 构建: 原生构建管理。

2. 统计显示: 可视化过去一个账单周期内的重要指标（数据反映了您的账单日的使用情况，而不是每月1日）：

   • 月活跃用户（8）: 跟踪用户活跃度的历史趋势。
   • 存储（9）: 显示当前的存储消耗。
   • 带宽（10）: Monthly Active Users (8):
   • 主动包 (11): 显示主动设备在不同应用包中的分布。

3. 概要卡片: 提供关键计数的快速概述:

   • 包上传 (12): 已上传的应用包总数。
   • 更新统计 (13): 包括请求、安装和失败的总更新次数。
   • 部署统计 (14): 总部署次数。

4. 显示选项 (15-18): 用于过滤和查看统计的控制项:

   • 每日 (15): 查看每日统计数据。
   • 累计 (16): 查看累计统计数据。
   • 计费周期 (17): 查看当前计费周期的统计数据。
   • 自定义日期范围 (18): 选择自定义日期范围（例如，最近 30 天）。

应用信息

此部分对应顶部导航栏中的“信息”标签（1）。您可以在此查看和管理应用程序的关键详细信息和设置。

应用信息页面

截图较老，可能不显示当前设置的所有内容。请以以下字段描述为准。

以下是可用字段和操作的详细信息：

• 应用图标（2）： 显示您的应用程序的图标。您可以点击“更改”按钮上传新的图标。
• 应用 ID（3）： 在 Capgo 中为您的应用程序唯一标识符。该 ID 不可编辑。
• 应用名称（4）： 应用程序的显示名称。您可以根据需要进行修改。
• 默认上传频道（5）： 指定新包将上传到的默认频道。您可以点击编辑图标选择不同的默认频道。
• 默认下载频道（6）： 指定设备从哪个频道下载更新。您可以点击编辑图标选择一个不同的默认频道。频道页面显示频道是否为默认频道，但您在这里更改它，而不是在频道上使用切换按钮。打开频道并点击 在应用设置中管理 跳转到此字段。详细信息请参见 默认频道配置 下面的部分。
• 自动删除未使用的包（秒数）(7): 此设置允许您自动删除未使用的包，指定的时间段（秒数）。设置为 0 禁用自动删除。该功能有助于管理存储并保持包清单整洁。
• 向插件暴露包元数据（8）： 当启用时，包链接和注释字段将发送到Capacitor Updater插件。该功能要求插件版本为7.35.0或更高版本。
• 阻止提供商基础设施请求： 当启用时，Capgo会拒绝来自已知Google和Apple数据中心IP范围的更新、统计和频道自我请求。正常生产流量下请保持启用状态。只在您有意测试时临时禁用它。新应用程序默认启用此保护功能；已有应用程序保留其之前的禁用设置，直到您更改它。
• 转移应用所有权（9）： 本节提供了将您的应用程序转移到您所在的不同组织的选项。
• 删除应用按钮： 永久删除您的应用程序从 Capgo。此操作不可逆转，并且将删除所有相关数据、捆绑包、频道和设备。
• 更新按钮： 保存您在此页面上编辑的字段中的任何更改（例如应用名称、默认上传频道、自动删除捆绑包设置）。

默认频道配置

该 默认下载频道 是您的应用程序的最重要设置之一。它决定了新设备首次连接到 Capgo 时将从哪个频道接收更新。

默认频道的工作原理

当设备请求从 Capgo 更新时，系统根据以下顺序（优先级最高）确定使用哪个频道：

1. 强制设备映射: 如果在频道设置中将设备 ID 强制映射到一个频道，那么这个频道总是会获胜。
2. Cloud 强制: 如果设备从控制台或公共 API 分配到了一个频道，那么这个强制将被使用。
3. 插件 setChannel(): 当前插件版本下，这是一个本地 assignments，而不是控制台强制。请参见 设备如何选择频道.
4. Capacitor 配置 defaultChannel: 如果在你的 capacitor.config.* 文件中设置了这个，那么它将用于测试/测试版构建。
5. 默认下载频道: 这里配置的设置。这是您生产用户中大约99%将使用的设置。

平台特定默认频道

您可以配置平台特定默认频道——例如一个用于iOS，一个用于Android，一个用于Electron。这种做法在以下情况下很有用:

• 您想在一个平台上发布更新，而在另一个平台上保持稳定
• 您需要根据平台不同来更新策略
• 您正在在一个平台上测试新版本，而在另一个平台上保持稳定

要设置平台特定默认值:

1. 为每个平台创建单独的频道（例如 production-ios, production-android, production-electron)
2. 在每个频道的设置中，仅启用相关平台（iOS、Android或Electron切换开关）
3. On 应用信息, 将每个通道设置为其平台的默认下载通道。 Capgo 允许当通道目标不同平台时设置多个默认值。

当设备请求更新时:

• iOS 设备将从 iOS 支持的默认通道接收更新
• Android 设备将从 Android 支持的默认通道接收更新

单一默认通道（适用于大多数应用）

对于大多数应用程序，支持所有三个核心平台的单一默认通道是最简单的方法：

1. 创建一个通道（例如： production)
2. 确保 iOS、Android 和 Electron 切换开启
3. 将其设置为默认下载通道 应用信息

这确保了所有平台上的行为一致性，并简化了您的发布流程。

更改默认频道

当您更改默认频道时：

• 新设备 将立即从新默认频道开始接收更新
• 已有设备 已有设备（通过覆盖或强制分配频道）将不会自动切换
• 要将已有设备移动到新频道，请需要：
  • 使用 setChannel() (或 unsetChannel()从应用程序中删除。删除后端设备记录不会清除本地 setChannel() assignment。
  • 强制将他们转移到新频道（控制台/API 覆盖；90天后过期）
  • 删除他们的控制台/API 覆盖，使他们遵循顺序。只有云默认值的设备会接收新的默认值。

提示: 在将其设为所有用户的默认值之前，始终在小组的强制设备上测试新默认频道。

继续从 App 页面

如果您正在使用 App 页面 来规划控制台和API 操作，请将其连接到 API 概览 在 API 概述中实现详细信息 简介 在简介中实现详细信息 API 密钥 在 API 密钥中实现详细信息 设备 在设备中实现详细信息，并且 捆绑包 在捆绑包中实现详细信息。