跳过内容

应用页面

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

在 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): 用于过滤和查看统计的控制项:

    • __CAPGO_KEEP_0__ (15): 每日统计(15):
    • __CAPGO_KEEP_1__ (16): 累计统计(16):
    • __CAPGO_KEEP_2__ (17): 当前计费周期统计(17):
    • __CAPGO_KEEP_3__ (18): 自定义时间范围统计(18):

应用信息

应用信息

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

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

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

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

  • 应用图标(2): 显示您的应用程序的图标。您可以点击“更改”按钮上传新的图标。
  • 应用 ID(3): 您的应用程序在 Capgo 内的唯一标识符。该 ID 不可编辑。
  • 应用名称(4): 您的应用程序的显示名称。您可以根据需要修改。
  • 默认上传频道(5): 指定新包将上传到的默认频道。您可以点击编辑图标选择不同的默认频道。
  • 默认下载频道(6): 指定设备从哪个频道下载更新。您可以点击编辑图标选择一个不同的默认频道。见 默认频道配置 详细信息请参见下面的部分。
  • 自动删除未使用的捆绑包(x秒后)(7): 自动删除未使用的旧包,包未使用时间(以秒为单位)超过指定时间后。 0 禁用自动删除。这有助于管理存储空间并保持你的应用列表清洁。
  • 暴露 Bundle 元数据到插件(8): 当启用时,会将捆绑链接和评论字段发送到Capacitor更新插件。这一功能需要插件版本7.35.0或更高。
  • Block Provider 基础设施请求: 当启用时,Capgo 会拒绝来自已知Google和Apple数据中心IP范围的更新、统计和channel-self请求。正常生产流量时请保持启用状态。只有在你故意测试时才临时禁用它。新应用程序默认启用此保护功能,而现有应用程序将保留其之前的禁用设置,直到你改变它。
  • 转移应用所有权(9): 本节提供了将您的应用程序转移到您所在的不同组织的选项。
  • 删除应用按钮: Permanently deletes your application from Capgo. This action is irreversible and will remove all associated data, bundles, channels, and devices.
  • 更新按钮: 保存您在此页面上所做的任何更改(例如应用名称、默认上传频道、自动删除捆绑包设置)。

默认频道配置

默认频道配置

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

When a device requests an update from Capgo, the system determines which channel to use based on the following precedence (highest priority first):

  1. 强制设备映射: 如果设备 ID 在渠道设置中明确强制到一个渠道,那么这个渠道总是会获胜。
  2. Cloud 强制: 如果设备已通过 setChannel() 或手动在控制台中分配到一个渠道,那么这个强制会被使用。
  3. Capacitor 配置 defaultChannel: 如果在你的 capacitor.config.* 文件中设置,那么这个配置用于测试/预发布构建。
  4. 默认下载渠道: 在这里配置的设置——这将是大约 99% 的你的生产用户使用的设置。

平台特定默认渠道

平台特定默认渠道

您可以配置平台特定的默认频道——例如一个用于iOS,一个用于Android,一个用于Electron。

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

要设置平台特定的默认值:

  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的默认频道接收更新
  • Android devices will receive updates from the Android-enabled default channel
标题:单一默认频道(适用于大多数应用)

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

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

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

更改默认频道

标题:更改默认频道

当您更改默认频道时:

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

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

如果您正在使用 应用页面 用于规划仪表板和API操作,连接它 API概览 查看API概览的实现细节 简介 查看简介的实现细节 API密钥 查看API密钥的实现细节 设备 查看设备的实现细节,并 捆绑包 查看捆绑包的实现细节