频道

如何 Capgo 选择一个频道（优先级）

当设备要求 Capgo 更新时，使用的频道将按照以下顺序（最高优先级）决定：

1. 强制设备映射: 如果设备 ID 被明确强制到一个频道（请参见 强制设备 （频道设置中的列表），该频道总是获胜。
2. Cloud override (由 setChannel() 或 Webapp 动作): 呼叫 setChannel (或在仪表板中更改设备的频道) 会在云中写入一个持久的覆盖，绑定到该设备 ID。 这个覆盖会在强制映射之后，但在任何默认值之前被咨询。 重新安装应用程序不会清除它；删除设备条目不会。 __CAPGO_KEEP_0__ 配置 (测试构建默认值)
3. Capacitor config defaultChannel (遗留密钥) defaultChannel 在 channelCloud override (created by capacitor.config.* 所以测试设备从预发布频道开始（例如， beta, pr-123如果缺失，设备将继续使用云端默认。生产版本通常不设置此项。
4. 云端默认频道（99%用户的主要策略): 大多数真实用户都会在此频道中。任何没有强制、没有覆盖、没有配置的新设备都使用此频道。改变它会在秒级对所有人进行推送（或回滚）—无需新二进制文件。 defaultChannel 为什么

云端默认 是主要路径： 秒级推送或回滚，无需重建或重新发布原生二进制文件。

• 一处管理iOS、Android和Electron行为。
• 更安全：您可以在切换默认之前确认包裹存在并且设置正确。
• 可审计的更改（团队成员可以在UI/日志中看到谁修改了什么)。 设计原则：上层（强制/覆盖/配置）是
• __CAPGO_KEEP_0__ 异常 (单用户调试, QA切换, 测试构建默认值). 正常用户流向云端默认值.

更改 云端默认值 频道影响 新 正常设备:

• 不被强制
• 不已经有一个云端覆盖
• 没有一个应用级别 defaultChannel 定义

如果一个测试构建带有 defaultChannel: 'beta' 并且您稍后改变云默认值为 production,启动的设备 beta 通过配置文件中的设置来保持其状态，直到您：(a) 使用 setChannel(), (b) 强制更改，或者 (c) 删除设备条目。

设备除非您：

• 强制将其更改为另一个频道。
• 调用 setChannel() (创建/替换云覆盖) 或在控制台中手动更改。
• 删除/归档它们所在的频道（然后它们将在下一次检查时通过顺序重新选择）。

如果一个频道对于一个平台被禁用（请参见 iOS / Android / Electron 切换开关），并且它将被选择，那么选择将跳过它并跳到下一个规则。

注意：设置 defaultChannel 意味着更改它需要一个新的二进制文件；请在测试/QA中有意使用它，而不是在一般生产控制中使用。

Capacitor 配置示例

capacitor.config.ts

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    Capgo: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

如果您稍后更改仪表板的默认设置，则 production通过配置、覆盖或强制方式连接的设备（via config、override 或 force）不会自动移动；只有新设备（或您清除的覆盖/强制）才会接收它。

---

管理频道

首先，让我们来看看频道页面。您可以通过 点击您的应用 然后 点击频道选项卡.

创建频道

如图所示，页面右下角有一个加号按钮。点击它会弹出一个模态框，允许您创建一个新的频道。1 在图片中

新频道 Add 然后点击

频道创建后

配置不正确的意思 Misconfigured 列将显示 Yes 您可以在这里了解更多 这里

删除频道

要从 web 应用中删除频道，请打开 频道 选项卡并找到频道行。在 操作 列中，点击垃圾桶图标，然后在确认对话框中点击 删除 __CAPGO_KEEP_0__

如果垃圾箱图标不可见，说明您的账户没有该应用的 channel.delete 权限。请向组织或应用管理员请求授予删除频道的角色，或者删除具有权限的频道（API）：

npx @capgo/cli@latest channel delete <channel-name> <app-id>

管理频道

点击频道名称会打开一个弹出窗口，您可以在其中管理频道设置。（3 频道设置

首先

---

第二 Default channel toggle. 当启用时，这个频道将成为新设备的默认频道。有关默认频道的全面说明，包括如何设置平台特定的默认值（一个用于 iOS，一个用于 Android，一个用于 Electron），请参见 Default Channel Configuration 第二个

---

设置。这个设置比较简单。如果这个设置为 false，则 iOS 设备将无法从这个频道下载更新。 IOS 第三个

设置。这个设置与 Android 类似。如果这个设置为 false，则 Android 设备将无法从这个频道下载更新。 IOS第四个

设置。这个设置与 Electron 和 IOS 类似。如果这个设置为 false，则 Electron 应用将无法从这个频道下载更新。 Android__CAPGO_KEEP_0__

第五点是设置。如果这个设置为真，那么就无法从原生版本降级。这意味着，如果您已经上传了一个版本到应用商店或Google Play商店，并尝试将渠道版本设置为，那么更新（降级）将会失败。 Disable auto downgrade under native 如果这个设置为真，那么就无法从原生版本降级。这意味着，如果您已经上传了一个版本到应用商店或Google Play商店，并尝试将渠道版本设置为，那么更新（降级）将会失败。 1.2.0 第六点是设置。这是一个比较复杂的设置，您可以在这里了解更多关于它的信息。 1.1.0 关于设置。如果这个设置为真，那么开发构建将允许从这个渠道下载更新。如果不为真，那么任何更新请求中设置为假的请求将会被拒绝。这主要用于测试目的。

第七点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。 Disable auto update第八点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。 第九点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。

第十点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。 Allow development build第十一点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。 prod 第十二点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。

第十三点是设置。如果这个设置为假，那么__CAPGO_KEEP_0__将拒绝任何来自模拟器的更新请求。这主要用于测试目的。 Allow Emulators第十四点是设置。如果这个设置为假，那么Capgo将拒绝任何来自模拟器的更新请求。这主要用于测试目的。

八是正确的 Allow devices to self associate如果这是真的，那么 __CAPGO_KEEP_0__ 方法将可用。如果将其设置为false，并尝试使用此频道调用 __CAPGO_KEEP_0__ 方法，则调用将失败。

从频道继续

如果您正在使用 频道 来规划频道路由和阶段性发布，请将其连接到 频道 Channels的实现细节 Channels Channels的实现细节 等给浏览器的端当给管理器 等给浏览器的端当给管理器 等给浏览器的端当给管理器和 等给浏览器的端当给管理器和 Capgo Environment Best Practices: Staging with One Mobile App ID for the practical context in Capgo Environment Best Practices: Staging with One Mobile App ID.