应用页面

应用页面显示什么?

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

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

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

1. 顶部导航栏: 提供对应用管理不同部分的访问:

   • 仪表盘 (1): 当前视图，显示关键指标和摘要。
   • 信息 (2): 显示应用的核心设置和详细信息（请参见“应用信息”部分）。
   • 捆绑包 (3): 管理应用的版本和发布。
   • 频道 (4): 配置和管理不同的更新频道（例如，生产，beta）。
   • 设备 (5): 查看和管理注册的设备，包括设置特定的覆盖。
   • 日志 (6): 查看详细日志和错误报告。
   • 构建 (7): 查看和管理您的应用程序构建。

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

   • 月活跃用户 (8): 跟踪用户活跃时间。
   • 存储 (9): 显示当前存储消耗。
   • 带宽 (10): 显示带宽使用情况。
   • Active Bundle (11): 显示活跃设备的分布图，根据不同应用程序包。

3. Summary Cards: 提供关键计数的快速概览：

   • Bundle Uploads (12): 已上传的应用程序包总数。
   • Updates Statistics (13): 包括请求、安装和失败的总更新次数。
   • Deployment Statistics (14): 总部署次数。

4. Display Options (15-18): 用于过滤和查看统计数据的控制选项：

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

应用信息

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

App 信息页面

以下是可用的字段和操作的分解：

• App 图标（2）： 显示您的应用程序的图标。您可以点击“更改”按钮上传新的图标。
• App ID（3）： 您的应用程序在 Capgo 内的唯一标识符。该 ID 不可编辑。
• App 名称（4）： 应用程序的显示名称。您可以根据需要修改此项。
• 默认上传通道（5）： 指定新包将上传到的默认通道。您可以点击编辑图标选择不同的默认通道。
• 默认下载通道（6）： 指定设备将从哪里下载更新的默认通道。您可以点击编辑图标选择不同的默认通道。请参见 默认频道配置 请参阅下面的详细信息。
• 自动删除未使用的包（在x秒后）（7）： 此设置允许您自动删除在指定时间段（以秒为单位）内未使用的旧包。设置为 0 以禁用自动删除。该功能有助于管理存储并保持包列表清洁。
• 向插件暴露包元数据（8）： 启用时，包链接和注释字段将发送到Capacitor Updater插件。该功能需要插件版本 7.35.0 或更高版本。
• 转移应用所有权（9）： 此部分提供了一个选项，以便将您的应用程序转移到您所属于的不同组织。
• 删除应用按钮： 永久删除您的应用程序从Capgo。此操作不可逆转，并且将删除所有相关数据、包、频道和设备。
• 更新按钮： 保存您对本页可编辑字段的所有更改（例如，应用名称、默认上传频道、自动删除捆绑包设置）。

默认频道配置

The 默认下载频道 是您应用的最重要设置之一。它决定了新设备连接到Capgo时，会从哪个频道接收更新。

如何默认频道工作

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

1. 强制设备映射: 如果在频道设置中明确强制设备映射到一个频道，那么这个频道总是会获胜。
2. Cloud override: 如果设备已分配到一个频道（通过 setChannel() 或在控制台中手动设置），则使用该覆盖设置。
3. Capacitor config defaultChannel文件中设置了该值，则用于测试/β版构建。 capacitor.config.* 默认下载频道
4. : 这里配置的设置——大约99%的生产用户都会使用。平台特定默认频道

平台特定默认频道

您希望在一个平台上推出更新，而在另一个平台上推出更新

• 您需要根据平台进行不同的更新策略
• __CAPGO_KEEP_0__ 配置
• 您正在在一个平台上测试新版本，而其他平台保持稳定

设置平台特定的默认值：

1. 为每个平台创建单独的频道（例如 production-ios, production-android在每个频道的设置中，仅启用相关的平台（iOS、Android或Electron切换） production-electron)
2. 将两个频道标记为“默认值”- __CAPGO_KEEP_0__ 允许在频道目标不同的平台时这样做
3. Mark both channels as “Default” - Capgo allows this when channels target different platforms

iOS 设备将从启用了iOS的默认频道接收更新

• Android 设备将从启用了Android的默认频道接收更新
• 单个默认频道（适用于大多数应用）

标题：单个默认频道（适用于大多数应用）

For most applications, a single default channel that supports all three core platforms is the simplest approach:

1. 创建一个通道（例如， production)
2. 确保 iOS、Android 和 Electron 的开关都启用
3. 标记它为默认通道

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

改变默认通道

当您改变默认通道时：

• 新设备 将立即从新默认的开始接收更新
• 已有的设备 已经有一个通道分配（通过覆盖或强制）而且不会自动切换
• 要移动已有的设备，您需要：
  • 使用 setChannel() 以编程方式覆盖它们
  • 强制将它们转移到新频道的控制台
  • 删除他们的设备条目（他们将重新注册到新默认值）

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

从 App 页面继续

如果您正在使用 App 页面 来规划控制台和API操作，连接它与 API概览 关于API概述的实现细节 简介 关于简介的实现细节 API密钥 关于API密钥的实现细节 设备 关于设备的实现细节 捆绑包 关于捆绑包的实现细节