跳过内容

应用页面

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

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

主页截图

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

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

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

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

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

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

应用信息

应用信息

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

应用信息页面
应用信息页面

截图较老,截图中没有显示当前控制台中的所有当前设置。以下字段描述作为参考。

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

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

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

如何默认频道工作

标题:如何默认频道工作

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

  1. 强制设备映射: 如果设备 ID 在频道设置中明确强制到一个频道,那么这个频道总是获胜。
  2. Cloud override: 如果设备已分配到一个频道通过 setChannel() 或手动在控制台中分配,那么这个覆盖将被使用。
  3. Capacitor配置 defaultChannel: 如果在你的 capacitor.config.* 文件中设置,这用于测试/β版构建。
  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 Overview 查看API Overview中的实施细节 查看Introduction中的实施细节 介绍 API 键 用于API 键的实现细节 设备 用于设备的实现细节 捆绑包 用于捆绑包的实现细节