跳过内容

应用程序页面

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

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

主页截图

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

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

    • 仪表板(1): 当前视图,显示关键指标和摘要。
    • 信息(2): 显示应用程序的核心设置和详细信息(请参见“应用程序信息”部分)。
    • 捆绑包(3): 管理应用程序的版本和发布。
    • 渠道(4): 配置和管理不同的更新频道(例如,生产,测试)。
    • 设备(5): 查看和管理已注册的设备,包括设置特定的覆盖
    • 日志(6): 访问详细日志和错误报告
    • 构建(7): 查看和管理您的应用程序构建
  2. 统计显示: 可视化过去一个账单周期内的重要指标(数据反映您的账单日,非月初):

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

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

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

应用信息

应用信息

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

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

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

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

默认通道配置

标题:默认通道配置

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

如何默认通道工作

标题:如何默认通道工作

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

  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的默认频道接收更新
  • Windows设备将从启用Windows的默认频道接收更新
标题:单个默认通道(适用于大多数应用)

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

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

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

更改默认通道

标题:更改默认通道

当您更改默认通道时:

  • 新设备 将立即从新默认通道开始接收更新
  • 已有的设备 那些已经分配了频道(通过覆盖或强制)
  • 不会自动切换
    • 要移动已有的设备,您需要 setChannel() 使用
    • 覆盖它们
    • 强制将它们转移到新频道

删除设备条目(它们将重新注册到新默认频道)提示: