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

让我们更详细地看看。应用的主页面分为几个关键区域:
-
顶部导航栏: 提供对应用管理主视图的访问。截图是示意性的;当前控制台包含:
- 仪表板: 应用的指标和摘要。
- 观察 (beta): 本地启动、WebView、问题和发布健康信号。
- 信息: 核心应用设置和详细信息(参见 应用信息).
- 捆绑包: 版本和发布。
- 频道: 上下文:Capgo发布频道功能名称。页面/区域:Capgo解决方案营销页面。角色:短UI标签或导航项。见于:页面解决方案/白标签.astro。消息键`solutions_white_label_visual_cell2_value` (解决方案白标签视觉单元2值)。
- 更新频道和渐进式滚动控制。: 设备
- 已注册设备和覆盖项。: 日志洞察 和原始日志。
- 构建: 原生构建管理。
-
统计显示: 可视化过去 billing 期间的重要指标(数据反映了您的 billing 日,而不是每月 1 日):
- 月活跃用户(8): 跟踪用户活跃度的历史趋势。
- 存储(9): 显示当前存储消耗。
- 带宽(10): 显示带宽使用情况。
- 主动包 (11): 显示主动设备在不同应用包中的分布。
-
概要卡片: 提供关键计数的快速概述。
- 包上传 (12): 已上传的应用包总数。
- 更新统计 (13): 包括请求、安装和失败的总更新次数。
- 部署统计 (14): 总部署次数。
-
显示选项 (15-18): 用于过滤和查看统计的控制项:
- 每日 (15): 查看每日统计数据。
- 累计 (16): 查看累计统计数据。
- 计费周期 (17): 查看当前计费周期的统计数据。
- 日期范围 (18): 选择自定义日期范围(例如,最近 30 天)。
应用信息
应用信息本节对应顶部导航栏中的“信息”标签(1)。您可以在此查看和管理应用程序的关键详细信息和设置。

截图较老,可能不显示当前所有设置。请以以下字段描述为准。
以下是可用字段和操作的详细信息:
- 应用图标(2): 显示您的应用程序的图标。您可以点击“更改”按钮上传新的图标。
- 应用ID(3): 在Capgo中为您的应用程序唯一标识符。该ID不可编辑。
- 应用名称(4): 应用程序的显示名称。您可以根据需要修改。
- 默认上传频道(5): 指定新包将上传到的默认频道。您可以点击编辑图标选择不同的默认频道。
- 默认下载频道(6): 指定设备从哪个频道下载更新。您可以点击编辑图标选择一个不同的默认频道。频道页面显示频道是否为默认频道,但您在这里更改频道,而不是在频道上使用切换按钮。打开频道并点击 在应用设置中管理 跳转到此字段。详细信息请参见 默认频道配置 下面的部分。
- 自动删除未使用的包(秒数)(7): 此设置允许您自动删除未使用的包,指定的时间段(秒数)。设置为
0禁用自动删除。该功能有助于管理存储并保持包清单整洁。 - 向插件暴露包元数据(8): 当启用时,包链接和注释字段将发送到Capacitor Updater插件。该功能要求插件版本为7.35.0或更高版本。
- 阻止供应商基础设施请求: 当启用时,Capgo会拒绝来自已知Google和Apple数据中心IP范围的更新、统计和频道自身请求。正常生产流量下请保持启用状态。仅在您有意测试时临时禁用它。新应用程序默认启用此保护功能;已有应用程序保留其之前的禁用设置,直到您更改它。
- 转移应用所有权(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.
Default Upload Channel
Section titled “How Default Channels Work”当设备从 Capgo 请求更新时,系统根据以下优先顺序(最高优先级第一)确定使用哪个频道:
- 强制设备映射: 如果在频道设置中将设备 ID 强制映射到一个频道,那么这个频道总是会获胜。
- Cloud 强制: 如果设备从控制台或公共 API 分配到一个频道,那么这个强制将被使用。
- 插件
setChannel(): 当前插件版本下,这是一个本地 assignments,而不是控制台强制。请参见 设备如何选择频道. - Capacitor 配置
defaultChannel: 如果在你的capacitor.config.*文件中设置了,那么这个配置将用于测试/ beta 版本。 - 默认下载频道: 这里配置的设置。这是您生产用户中大约99%将使用的设置。
平台特定默认频道
平台特定默认频道您可以为每个平台配置特定的默认频道——例如一个用于iOS,一个用于Android,一个用于Electron。这在以下情况下很有用:
- 您想在一个平台上发布更新,而在另一个平台上保持稳定
- 您需要根据平台不同来更新策略
- 您正在在一个平台上测试新版本,而在另一个平台上保持稳定
要设置平台特定默认值,请执行以下步骤:
- 为每个平台创建单独的频道(例如
production-ios,production-android,production-electron) - 在每个频道的设置中,仅启用相关的平台(iOS、Android或Electron切换开关)
- On 应用信息, 将每个通道设置为其平台的默认下载通道。 Capgo 允许当通道目标不同平台时设置多个默认值。
当设备请求更新时:
- iOS 设备将从 iOS 支持的默认通道接收更新
- Android 设备将从 Android 支持的默认通道接收更新
单个默认通道(适用于大多数应用)
单个默认通道(适用于大多数应用)对于大多数应用程序,支持所有三个核心平台的单个默认通道是最简单的方法:
- 创建一个通道(例如:
production) - 确保 iOS、Android 和 Electron 开关都启用
- 将其设置为 Default Download Channel 应用信息
这确保了所有平台的行为一致性,并简化了您的发布流程。
更改默认频道
标题:更改默认频道当您更改默认频道时:
- 新设备 将立即从新默认频道开始接收更新
- 已有设备 已有设备(通过覆盖或强制分配频道)将不会自动切换
- 要将已有设备移动到新频道,请需要:
- 使用
setChannel()(或unsetChannel()从应用程序中删除。删除后端设备记录不会清除本地setChannel()assignment。 - 强制将它们转移到新频道(控制台/API 覆盖;90天后过期)
- 删除控制台/API 覆盖,使其按照顺序降级。仅有云默认的设备会接收到新默认值。
- 使用
提示: 在将新默认频道设置为所有用户的默认值之前,请始终在小组中测试一下。
继续从 App 页面
标题:继续从 App 页面如果您正在使用 App 页面 来规划控制台和API 操作,请将其连接到 API 概览 在 API 概述中了解实现细节 简介 在简介中了解实现细节 API 键 在 API 键中了解实现细节 设备 在设备中, 捆绑包 在捆绑包中了解实现细节