应用页面

应用程序页面显示什么?

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

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

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

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

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

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

   • 每月活跃用户（8）： 跟踪用户活跃时间的数量。
   • 存储（9）： 显示当前的存储消耗情况。
   • 带宽（10）： 显示带宽使用情况。
   • 活跃捆绑（11）： 显示设备在不同应用捆绑中的分布情况。

3. 概要卡片： 提供了关键计数的快速概览：

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

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

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

应用信息

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

应用信息页面

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

• 应用图标 (2): 显示您的应用程序的图标。您可以点击“更改”按钮上传一个新的图标。
• App ID (3): Capgo 中应用的唯一标识符。该 ID 不可编辑。
• App 名称 (4): 应用的显示名称。您可以根据需要修改此项。
• 默认上传通道 (5): 指定新包将上传到的默认通道。您可以点击编辑图标选择不同的默认通道。
• 默认下载通道 (6): 指定设备将从哪里下载更新。您可以点击编辑图标选择不同的默认通道。详细信息请参见 "通道配置" 部分。 自动删除未使用的包 (x 秒后) (7): 此设置允许您自动删除未使用的包，包的使用时间超过指定的秒数。
• Auto Delete Bundles Not Used (after x seconds) (7): 此设置允许您自动删除未使用的包，包的使用时间超过指定的秒数。 0 __CAPGO_KEEP_0__：关闭自动删除。 这有助于管理存储并保持您的捆绑清单整洁。
• Expose Bundle Metadata to Plugin (8): 当启用时，捆绑链接和注释字段将发送到 Capacitor Updater 插件。这一功能需要插件版本 7.35.0 或更高版本。
• Transfer App Ownership (9): 本节提供了一个选项，用于将您的应用程序转移到您所在的不同组织中。
• Delete App Button: 永久删除您的应用程序从 Capgo。 这一操作不可逆转，并且将删除所有相关数据、捆绑、通道和设备。
• Update Button: 保存您对本页面可编辑字段的任何更改（例如，应用程序名称、默认上传通道、自动删除捆绑设置）。

Default Channel Configuration

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

默认频道如何工作

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

1. 强制设备映射: 如果设备 ID 在频道设置中明确强制到一个频道，那么这个频道总是会获胜。
2. 云端覆盖: 如果设备已被分配到一个频道通过 setChannel() 或手动在控制台中进行分配，那么这个覆盖将被使用。
3. Capacitor配置 defaultChannel: 如果在您的 capacitor.config.* 用于测试/ beta 版本的文件。
4. 默认下载频道: 这里配置的设置—这将是~99% 的生产用户使用的。

平台特定默认频道

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

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

要设置平台特定默认值：

1. 为每个平台创建单独的频道（例如 production-ios, production-android和 production-electron)
2. 在每个频道的设置中，仅启用相关的平台（iOS、Android或Electron切换）
3. 将两个频道标记为“默认” - Capgo允许在不同平台的频道之间这样做

当设备请求更新时：

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

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

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

1. 创建一个频道（例如 production)
2. 确保启用了iOS、Android和Electron的切换
3. 将其标记为默认频道

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

修改默认频道

当您更改默认频道时：

• 新设备 将立即从新默认频道开始接收更新
• 已有的设备 如果这些设备已经有频道 assignments（通过覆盖或强制），则不会自动切换
• 要将已有的设备移动到新频道，请需要：
  • 使用 setChannel() 覆盖它们以程序化方式
  • 强制它们在控制台中切换到新频道
  • 删除它们的设备条目（它们将重新注册到新默认频道）

提示: 总是使用少量强制设备测试新默认频道之前再将其设为所有用户的默认频道。