📢 频道

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

➕ 添加

别名： a

npx @capgo/cli@latest channel add

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

示例：

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

选项：

参数	类型	描述
设置频道为默认值	boolean	➕ 在 __CAPGO_KEEP_0__ 云中创建一个用于应用程序分发的新频道，管理更新分发。
—自行分配	boolean	允许设备自行分配到此频道
-a	string	API 键以链接到您的帐户
—自定义主机	string	自定义 Supabase 主机 URL（用于自行托管或 Capgo 开发）
—自定义匿名	string	自定义 Supabase 匿名密钥（用于自行托管）

🗑️ 删除

别名： d

npx @capgo/cli@latest channel delete

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

示例：

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 for setup.

📋 List

查看 l

npx @capgo/cli@latest channel list

📋 List all channels configured for an app in Capgo Cloud to review distribution settings.

列表

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	__CAPGO_KEEP_0__ key to link to your account

📦 __CAPGO_KEEP_0__

npx @capgo/cli@latest channel currentBundle

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

示例：

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

选项：

参数	类型	描述
-c	string	获取当前捆绑包的频道
-a	string	API用于链接到您的帐户
–quiet	boolean	仅打印捆绑包版本
–supa-host	string	自定义 Supabase 主机 URL（用于自主托管或Capgo开发）
–supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

⚙️ 设置

别名： s

npx @capgo/cli@latest channel set

⚙️ 为频道配置设置，例如链接包，设置更新策略（主版本，次版本，元数据，补丁，none），或设备目标（iOS，Android，dev，prod，模拟器，设备）。 必须有一个默认频道。

示例：

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	按类型阻止更新：主版本、次版本、元数据、补丁或无（允许所有）
—update-package	string	提供 zip、delta 或两者：all、zip、delta、zip_from_builtin 或 delta_from_builtin
—rollout-bundle	string	逐渐在此频道上发布的包版本
—rollout-percentage	string	从 0 到 100 的滚动百分比
—rollout-percentage-bps	string	从 0 到 10000 的滚动百分比（基点）
—rollout-enable	boolean	启用配置的滚动发布
—rollout-disable	boolean	禁用配置的发布
—rollout-pause	boolean	暂停发布曝光而不回滚选定设备
—rollout-resume	boolean	恢复暂停的发布
—rollout-rollback	boolean	清除发布状态并将设备返回稳定状态
—rollout-promote	boolean	将发布目标提升到稳定状态并清除发布状态
—rollout-cache-ttl-seconds	string	Cloudflare发布决策缓存TTL（秒）
—auto-pause-enabled	boolean	启用回滚自动暂停策略
—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	禁用向生产设备发送更新
—emulator	boolean	允许向模拟器设备发送更新
—no-emulator	boolean	禁用向模拟器设备发送更新
—device	boolean	允许向物理设备发送更新
—no-device	boolean	禁用向物理设备发送更新
—qr-preview	boolean	打印此频道预览更新后的终端QR code
—发送更新通知	boolean	在更新关联的频道包后，向设备发送本机更新检查通知
—package.json	string	多包项目的package.json文件路径（用逗号分隔)
—忽略元数据检查	boolean	如果包中存在node_modules，则忽略检查node_modules兼容性
—自定义Supabase主机URL（用于自主托管或__CAPGO_KEEP_0__开发）	string	Custom Supabase host URL (for self-hosting or Capgo development)
编辑页面	string	上一页