跳过内容

应用页面

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

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

主页面截图

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

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

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

    • 每月活跃用户 (8): __CAPGO_KEEP_0__
    • __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
    • __CAPGO_KEEP_2__ __CAPGO_KEEP_3__
    • __CAPGO_KEEP_4__ __CAPGO_KEEP_5__
  3. __CAPGO_KEEP_6__ __CAPGO_KEEP_7__

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

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

应用信息

应用信息

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

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

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

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

默认下载通道 是应用程序的最重要设置之一。它决定了新设备在首次连接到 __CAPGO_KEEP_0__ 时将从哪个通道接收更新。 is one of the most important settings for your app. It determines which channel new devices will receive updates from when they first connect to Capgo.

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

  1. 强制设备映射: 如果在频道设置中明确将设备 ID 强制到一个频道,那么这个频道总是会获胜。
  2. Cloud override: 如果设备已分配到频道(通过 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

__CAPGO_KEEP_0__

  • iOS 设备将从 iOS 支持的默认频道接收更新
  • Android 设备将从 Android 支持的默认频道接收更新
单个默认频道(适用于大多数应用)

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

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

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

当您更改默认频道时:

  • 新设备 将立即从新默认的
  • 现有设备 已分配渠道的设备(通过覆盖或强制)不会自动切换
  • 要移动现有设备,请使用以下方法之一:
    • 覆盖它们 setChannel() 强制它们在控制台中切换到新渠道
    • 删除它们的设备条目(它们将重新注册到新默认的)
    • 提示:

在将新默认渠道应用于所有用户之前,请始终在强制设备的小组中测试一下继续从 App 页面

targetLanguageCode

继续从 App 页面

如果您正在使用 App 页面 to plan dashboard and API operations, connect it with API 概览 for the implementation detail in API Overview, __CAPGO_KEEP_0__ 概览 查看 API for the implementation detail in API Keys, 设备 查看 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__