📢 频道

📢 在 Capgo Cloud 中管理应用程序更新的分发渠道，控制更新如何传递给设备。

➕ 添加

别名: a

npx @capgo/cli@latest channel add

➕ 在 Capgo 云中创建一个用于应用程序分发的新频道，以便管理更新的传递。

示例：

npx @capgo/cli@latest channel add production com.example.app --default

选项：

参数	类型	描述
-d	boolean	设置频道为默认值
—自行分配	boolean	允许设备自行分配到此频道
-a	string	API 键用于链接到您的帐户
—自定义主机	string	自定义 Supabase 主机 URL（用于自行托管或 Capgo 开发）
—自定义匿名	string	自定义 Supabase 匿名密钥（用于自行托管）

🗑️ 删除

别名： d

npx @capgo/cli@latest channel delete

🗑️ 从 Capgo 云中删除一个频道， 可选地移除关联的捆绑包以释放资源。

示例：

npx @capgo/cli@latest channel delete production com.example.app

选项：

参数	类型	描述
-a	string	API 的密钥以链接到您的帐户
--delete-bundle	boolean	删除与该频道关联的包。一个 App 预览密钥可以原子性地删除其自己的预览频道和链接的未共享包。
—success-if-not-found	boolean	如果频道不存在则成功
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	自主托管时的自定义 Supabase 匿名密钥

注意

使用组织和应用绑定的 App 预览 API 密钥 --delete-bundle 仅用于非公开 PR 预览频道。该命令使用狭窄的原子清理路线：它仅在频道和与其相关的、未共享的包中成功。该密钥无法在现有默认/主频道、另一个预览密钥的频道或另一个密钥的包中使用，并且它仍然不会接收一般 bundle.delete. See API Keys __CAPGO_KEEP_0__密钥

📋 List

Alias: l

npx @capgo/cli@latest channel list

📋 列出在Capgo Cloud中配置的应用程序的所有频道，以查看分发设置。

Example:

npx @capgo/cli@latest channel list com.example.app

选项:

参数	类型	描述
-a	string	API
自定义 Supabase 主机 URL（用于自主托管或__CAPGO_KEEP_0__开发）	string	Custom Supabase host URL (for self-hosting or Capgo development)
当前捆绑包	string	—supa-host

📦 —supa-anon

npx @capgo/cli@latest channel currentBundle

📦 获取与特定频道关联的当前包在 Capgo Cloud 中进行更新跟踪。

示例：

npx @capgo/cli@latest channel currentBundle production com.example.app

选项：

参数	类型	描述
-c	string	获取当前捆绑包的频道
-a	string	API
——静默	boolean	仅打印捆绑包版本
——自定义主机	string	自定义 Supabase 主机 URL（用于自主托管或Capgo开发）
——自定义匿名	string	自定义 Supabase 匿名密钥（用于自主托管）

⚙️ 设置

别名： s

npx @capgo/cli@latest channel set

⚙️ 为频道配置设置，例如链接包、设置更新策略（重大、次要、元数据、补丁、无）或设备目标（iOS、Android、开发、生产、模拟器、设备）。 必须有一个默认频道。

示例：

npx @capgo/cli@latest channel set production com.example.app --bundle 1.0.0 --state default

选项：

参数	类型	描述
-a	string	API 与您的帐户关联的密钥
-b	string	设置文件的包版本号
-s	string	设置渠道的状态，缺省或正常
--latest-remote	boolean	从capgo云获取最新的包并设置到渠道
--latest	boolean	获取package.json中的最新版本号并设置到渠道
--downgrade	boolean	允许降级到原生版本以下的版本
--no-downgrade	boolean	禁止降级到原生版本以下的版本
—ios	boolean	允许向iOS设备发送更新
—no-ios	boolean	禁用向iOS设备发送更新
—android	boolean	允许向Android设备发送更新
—no-android	boolean	禁用向Android设备发送更新
—self-assign	boolean	允许设备自行分配到此频道
—no-self-assign	boolean	禁用设备自行分配到此频道
—disable-auto-update	string	按类型阻止更新：主版本、次版本、元数据、补丁版本或 none（允许所有）
—rollout-bundle	string	逐渐在此频道发布版本
—rollout-percentage	string	从 0 到 100 的滚动百分比
—rollout-percentage-bps	string	从 0 到 10000 的滚动百分比（基点）
—rollout-enable	boolean	启用配置的滚动
—rollout-disable	boolean	禁用配置的滚动
—rollout-pause	boolean	暂停发布
Pause rollout exposure without rolling back selected devices	boolean	—rollout-resume
恢复发布	boolean	Resume a paused rollout
—rollout-rollback	boolean	回滚发布
Clear rollout state and return devices to stable	string	Cloudflare rollout decision cache TTL in seconds
发布目标升级	boolean	Promote rollout target to stable and clear rollout state
—auto-pause-disabled	boolean	禁用回滚自动暂停策略
—auto-pause-window-minutes	string	回滚自动暂停统计窗口
—auto-pause-failure-rate-bps	string	失败率阈值（基点）
—auto-pause-confidence	string	置信度（0-1）
—auto-pause-min-attempts	string	安装失败尝试次数达到自动暂停触发阈值
—auto-pause-min-failures	string	失败次数达到自动暂停触发阈值
—auto-pause-action	string	自动暂停动作：暂停、回滚或通知
—auto-pause-cooldown-minutes	string	自动暂停再次触发前的冷却时间
—dev	boolean	允许将更新发送到开发设备
—no-dev	boolean	禁止将更新发送到开发设备
—prod	boolean	允许将更新发送到生产设备
—no-prod	boolean	禁止将更新发送到生产设备
—模拟器	boolean	允许将更新发送到模拟器设备
—no-emulator	boolean	禁用将更新发送到模拟器设备
—设备	boolean	允许将更新发送到物理设备
—no-device	boolean	禁用将更新发送到物理设备
—QR预览	boolean	打印此频道预览更新后的终端QR code
—发送更新通知	boolean	更新链接频道包后将设备发送本机更新检查通知
—package-json	string	多包仓库中的package.json文件路径（逗号分隔）
—ignore-metadata-check	boolean	忽略bundle中node_modules兼容性检查
—supa-host	string	自主托管或开发时的自定义Supabase主机URL（Capgo）
—supa-anon	string	自主托管时的自定义Supabase匿名密钥