跳过内容

应用页面

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

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

主页截图

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

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

    • 仪表板: 应用程序的指标和摘要。
    • 观察 (beta):本机启动、WebView、问题和发布健康信号。
    • 信息: 应用程序的核心设置和详细信息(请参见 应用程序信息).
    • 捆绑包: 版本和发布。
    • 频道: 更新频道和渐进式发布控制。
    • 设备: 已注册设备和覆盖。
    • 日志: 日志洞察 和原始日志。
    • 构建: 原生构建管理。
  2. 统计显示: 可视化上一个账单周期中的重要指标(数据反映了您的账单日,而不是每月1日):

    • 每月活跃用户 (8): 跟踪用户活跃时间的唯一用户数量。
    • 存储 (9): 显示当前的存储消耗。
    • 带宽 (10): 显示带宽使用情况。
    • 活跃捆绑 (11): 显示设备在不同应用捆绑中的分布。
  3. 摘要卡片: 提供关键计数的快速概览:

    • 捆绑上传 (12): 上传的应用捆绑总数。
    • 更新统计 (13): 总共执行的更新次数,包括请求、安装和失败。
    • 部署统计 (14): 总共的部署次数。
  4. 显示选项 (15-18): 用于过滤和查看统计的控制:

    • 每日 (15): 以每日的方式查看统计。
    • 累积 (16): 以时间累积的统计。
    • 计费周期 (17): 查看当前计费周期的统计。
    • Date Range (18): 选择自定义日期范围(例如,最近 30 天)。

App 信息

App 信息

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

App 信息页面
截图较旧,未显示当前控制台中的所有当前设置。请使用以下字段描述作为参考。

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

应用程序图标(2):

  • 显示您的应用程序的图标。您可以点击“更改”按钮上传新的图标。 应用程序 ID(3):
  • App Icon (2): A unique identifier for your application within Capgo. This ID is not editable.
  • 应用名称(4): 应用的显示名称。您可以根据需要修改此名称。
  • 默认上传频道(5): 指定新包将上传到的默认频道。您可以点击编辑图标选择不同的默认频道。
  • 默认下载频道(6): 指定设备将从哪里下载更新。您可以点击编辑图标选择不同的默认频道。请参阅 默认频道配置 部分获取详细信息。
  • 自动删除未使用的包(在x秒后)(7): 此设置允许您自动删除未使用的包(以秒为单位)。设置为 0 禁用自动删除。该设置有助于管理存储并保持包列表清洁。
  • 暴露 Bundle 元数据到插件 (8): 启用后,bundle 链接和注释字段将发送到 Capacitor 更新器插件。这一功能需要插件版本 7.35.0 或更高版本。
  • 阻止供应商基础设施请求: 启用后,Capgo 将拒绝来自已知 Google 和 Apple 数据中心 IP 范围的更新、统计和 channel-self 请求。正常生产流量下请保持启用状态。只有在你有意测试时才临时禁用它。新应用程序启用此保护功能;已有应用程序保留其之前的禁用设置,直到你改变它。
  • 转移应用程序所有权 (9): 本节提供了一个选项来启动将您的应用程序转移到您所在的不同组织的过程。
  • 删除应用程序按钮: 永久删除您的应用程序从 Capgo。此操作不可逆转,并将删除所有相关数据、捆绑包、通道和设备。
  • 更新按钮: 保存您在此页面上编辑的任何更改(例如应用程序名称、默认上传通道、自动删除捆绑包设置)。

默认通道配置

标题:默认通道配置

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

如何默认频道工作

标题:如何默认频道工作

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

  1. 强制设备映射: 如果设备 ID 在频道设置中明确强制到一个频道,那么这个频道总是会获胜。
  2. Cloud 强制: 如果设备已分配到一个频道通过 setChannel() 或手动在控制台中,
  3. Capacitor 配置 defaultChannel: 如果在你的 capacitor.config.* file中设置,这用于测试/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. 将其标记为默认频道

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

更改默认频道

更改默认频道

当您更改默认频道时:

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

提示在切换新默认频道之前,始终在强制设备的小规模用户群中测试新默认频道。

继续从 App 页面

继续从 App 页面

如果您正在使用 App 页面 来规划仪表板和API操作,连接它与 API概览 查看API概览中的实施细节 查看 介绍 API 键 用于API 键的实现细节 设备 用于设备的实现细节 捆绑包 用于捆绑包的实现细节