应用页面
复制一个包含安装步骤和本插件的完整Markdown指南的配置提示。
应用页面显示什么?
标题为“应用页面显示什么?”的部分首先,让我们来看看应用的主页面:
在 Capgo 中,应用代表您的移动应用程序与 Capgo 的实时更新系统集成。它允许您轻松管理更新、频道和设备。

让我们更详细地看看。应用的主页面分为几个关键区域:
-
顶部导航栏: 提供对应用管理视图的访问。截图是示意性的;当前控制台包含:
- 仪表板: 应用的指标和摘要。
- 观察 (beta): 原生启动、WebView、问题和发布健康信号。
- 信息: 核心应用设置和详细信息(参见 应用信息).
- 包: 版本和发布。
- 频道: 上下文:Capgo发布频道功能名称。页面/区域:Capgo解决方案营销页面。角色:短UI标签或导航项。见于:页面解决方案/白标签.astro。消息键`solutions_white_label_visual_cell2_value`(解决方案白标签视觉单元2值)。
- 更新频道和渐进式滚动控制。: 设备
- 已注册设备和覆盖项。: 日志洞察 和原始日志。
- 构建: 原生构建管理。
-
统计显示: 可视化过去一个账单周期内的重要指标(数据反映了您的账单日,而不是每月1日):
- 每月活跃用户(8): 跟踪用户活跃时间的数量。
- 存储(9): 显示当前存储消耗。
- 带宽(10): Monthly Active Users (8):
- 主动包 (11): 显示主动设备在不同应用包中的分布。
-
概要卡片: 提供关键计数的快速概述:
- 包上传 (12): 已上传的应用包总数。
- 更新统计 (13): 包括请求、安装和失败的总更新次数。
- 部署统计 (14): 总部署次数。
-
显示选项 (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):
- 强制设备映射: 如果设备 ID 在渠道设置中明确强制到一个渠道,那么这个渠道总是会获胜。
- Cloud 强制: 如果设备已通过
setChannel()或手动在控制台中分配到一个渠道,那么这个强制会被使用。 - Capacitor 配置
defaultChannel: 如果在你的capacitor.config.*文件中设置,那么这个配置用于测试/预发布构建。 - 默认下载渠道: 在这里配置的设置——这将是大约 99% 的你的生产用户使用的设置。
平台特定默认渠道
平台特定默认渠道您可以配置平台特定的默认频道——例如一个用于iOS,一个用于Android,一个用于Electron。
- 您想在一个平台上发布更新,而在另一个平台上保持稳定
- 您需要根据平台不同来使用不同的更新策略
- 您正在在一个平台上测试新版本,而在另一个平台上保持稳定
要设置平台特定的默认值:
- 为每个平台创建单独的频道(例如
production-ios,production-android在每个频道的设置中,仅启用相关的平台(iOS、Android或Electron切换开关)production-electron) - 将两个频道标记为“默认值”-__CAPGO_KEEP_0__允许在频道目标不同的平台上进行此操作
- 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
单一默认频道(适用于大多数应用)
标题:单一默认频道(适用于大多数应用)对于大多数应用程序,支持所有三个核心平台的单一默认频道是最简单的方法:
- 创建一个频道(例如,
production) - 确保 iOS、Android 和 Electron 切换开启
- 将其标记为默认频道
这确保了所有平台的行为一致,并简化了您的发布流程。
更改默认频道
标题:更改默认频道当您更改默认频道时:
- 新设备 将立即从新默认频道开始接收更新
- 已有设备 已分配频道的设备(通过覆盖或强制)不会自动切换
- 要移动已有设备,请选择以下方法
- 使用
setChannel()覆盖它们以程序化方式 - 强制将其转移到新频道的控制台
- 删除设备条目(它们将重新注册到新默认频道)
- 使用
提示: 在将其设为所有用户的默认频道之前,请始终在强制设备的小组中测试新默认频道
继续从应用页面
标题为“继续从应用页面”的部分如果您正在使用 应用页面 用于规划仪表板和API操作,连接它 API概览 查看API概览的实现细节 简介 查看简介的实现细节 API密钥 查看API密钥的实现细节 设备 查看设备的实现细节,并 捆绑包 查看捆绑包的实现细节