频道

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

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

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

为什么 云默认 是主要路径：

• 无需重建或重新发布原生二进制文件即可实现即刻发布或回滚。
• 一个地方管理iOS、Android和Electron行为。
• 更安全：您可以在切换默认值之前确认包存在且设置正确。
• 可审计的更改（团队成员可以在UI/日志中看到谁改变了什么）。 设计原则：上层（强制/覆盖/配置）是 异常 (单个用户调试、QA切换、测试构建默认值)。正常用户流向云默认。

改变 云默认值 频道影响 新 正常设备：

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

如果测试构建与 defaultChannel: 'beta' 并且您稍后将云默认值更改为 production开始的设备 beta 通过配置 setChannel()直到您：（a）使用覆盖它们，（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通过配置、覆盖或强制，已经在另一个频道上的设备将不会自动移动；只有新设备（或您清除覆盖/强制的设备）才会接收它。

---

管理频道

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

创建频道

如您所见，在下右角有一个加号按钮。1 （在图像中）点击它将打开一个模态窗口，您可以在其中创建一个新频道。

然后您点击 Add 新频道应该出现在列表中。

什么是配置不正确的含义？

有时频道的配置不是有效的。在这种情况下，您将获得一个大警告，列中 Misconfigured 将说 Yes 由于一个或多个频道。 您可以在这里了解更多。 删除频道

删除一个频道

删除频道非常简单。只需点击垃圾桶图标并确认删除。 (2 在图片中)

管理频道

点击频道名称将打开一个模态窗口，您可以在其中管理频道设置。 (3 在图片中)

频道设置页面包含了所有频道配置选项。让我们逐一介绍每个设置。

---

首先是 Default channel 开关。启用后，这个频道将成为新设备的默认频道。有关默认频道的详细说明，包括如何设置平台特定的默认值（iOS、Android和Electron），请参见 默认频道配置 section.

---

第二步： IOS 设置。这个设置相对简单。如果这个设置为假，那么iOS设备将无法从这个频道下载更新。

第三步： Android 设置。这个设置与 IOS类似。如果这个设置为假，那么Android设备将无法从这个频道下载更新。

第四步： Electron 设置。这个设置与 IOS 类似， Android。如果这个设置为假，那么Electron应用将无法从这个频道下载更新。

第五步： Disable auto downgrade under native 设置。如果这个设置为真，那么就无法从原生版本降级。这意味着，如果您已经上传了一个 1.2.0 将应用程序版本发布到应用商店或Google Play商店，然后尝试将渠道版本设置为 1.1.0 然后更新（降级）将会失败。

第六是 Disable auto update. 这个设置比较复杂，您可以在这里学习更多关于它 关于

. 如果这个设置为真，则开发构建将允许从这个渠道下载更新。如果不为真，则任何设置为 Allow development build的更新请求都会被拒绝。这主要适用于测试目的。 prod 第七是

. 如果这个设置为假，则 Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.

第八是 Allow devices to self associate. 如果这个设置为真，则 设置频道 如果设置为 false,并且尝试使用此频道调用 设置频道 方法,则调用将失败。