跳转到正文

📢 Channel

📢 在 Capgo Cloud 中管理应用更新的分发渠道,控制更新如何分发到设备。

别名: a

终端窗口
npx @capgo/cli@latest channel add

➕ 在 Capgo Cloud 中创建一个新的应用分发渠道,用于管理更新分发。

示例:

终端窗口
npx @capgo/cli@latest channel add production com.example.app --default

选项:

参数类型描述
-dboolean将该 channel 设为默认
—self-assignboolean允许设备自行分配到此 channel
-astringAPI 用于关联您的账户的密钥
—supa-hoststring自定义 Supabase host URL(用于自托管或 Capgo 开发)
—supa-anonstring自定义 Supabase anon key(用于自托管)

别名: d

终端窗口
npx @capgo/cli@latest channel delete

🗑️ 从 Capgo Cloud 中删除频道,并可选择同时删除关联的 bundle 以释放资源。

示例:

终端窗口
npx @capgo/cli@latest channel delete production com.example.app

选项:

参数类型描述
-astringAPI 用于关联您的账户的密钥
—delete-bundleboolean删除与该 channel 关联的 bundle。App Preview key 只能原子性地删除其自身的 preview channel 以及关联的、未共享的 bundle。
—success-if-not-foundboolean如果未找到 channel,则视为成功
—supa-hoststring自定义 Supabase host URL(用于自托管或 Capgo 开发)
—supa-anonstring自定义 Supabase anon key(用于自托管)

别名: l

终端窗口
npx @capgo/cli@latest channel list

📋 列出在 Capgo Cloud 中为应用配置的所有 channel,以查看分发设置。

示例:

终端窗口
npx @capgo/cli@latest channel list com.example.app

选项:

参数类型描述
-astringAPI 用于关联您的账户的密钥
—supa-hoststring自定义 Supabase host URL(用于自托管或 Capgo 开发)
—supa-anonstring自定义 Supabase anon key(用于自托管)
终端窗口
npx @capgo/cli@latest channel currentBundle

📦 获取 Capgo Cloud 中与特定通道关联的当前 bundle,用于更新跟踪。

示例:

终端窗口
npx @capgo/cli@latest channel currentBundle production com.example.app

选项:

参数类型描述
-cstring获取当前 bundle 的 Channel
-astringAPI 用于关联您的账户的密钥
—quietboolean仅打印 bundle 版本
—supa-hoststring自定义 Supabase host URL(用于自托管或 Capgo 开发)
—supa-anonstring自定义 Supabase anon key(用于自托管)

别名: s

终端窗口
npx @capgo/cli@latest channel set

⚙️ 配置渠道的设置,例如关联 bundle、设置更新策略(major、minor、metadata、patch、none),或设备定向(iOS、Android、dev、prod、emulator、device)。 必须有一个渠道设为默认。

示例:

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

选项:

参数类型描述
-astringAPI 用于关联您的账户的密钥
-bstring要设置的文件的 Bundle 版本号
-sstring设置 channel 的状态,default 或 normal
—latest-remoteboolean获取在 capgo 云端上传的最新 bundle,并将其设置到 channel
—latestboolean获取 package.json 中最新的 version 字段,并将其设置到 channel
—downgradeboolean允许降级到低于原生版本的版本
—no-downgradeboolean禁止降级到低于原生版本的版本
—iosboolean允许向 iOS 设备推送更新
—no-iosboolean禁止向 iOS 设备推送更新
—androidboolean允许向 Android 设备推送更新
—no-androidboolean禁止向 Android 设备推送更新
—self-assignboolean允许设备自行分配到此 channel
—no-self-assignboolean禁止设备自行分配到此 channel
—disable-auto-updatestring按类型拦截更新:major、minor、metadata、patch 或 none(允许所有)
—update-packagestring提供 zip、delta 或两者:all、zip、delta、zip_from_builtin 或 delta_from_builtin
—rollout-bundlestring在此渠道上逐步发布的 Bundle 版本
—rollout-percentagestring从 0 到 100 的发布百分比
—rollout-percentage-bpsstring从 0 到 10000 的基点发布百分比
—rollout-enableboolean启用已配置的发布
—rollout-disableboolean禁用已配置的发布
—rollout-pauseboolean暂停发布曝光,但不回滚已选设备
—rollout-resumeboolean恢复已暂停的 rollout
—rollout-rollbackboolean清除 rollout 状态并将设备回退到 stable
—rollout-promoteboolean将 rollout 目标提升为 stable 并清除 rollout 状态
—rollout-cache-ttl-secondsstringCloudflare rollout 决策缓存 TTL(秒)
—auto-pause-enabledboolean启用 rollout 自动暂停策略
—auto-pause-disabledboolean禁用 rollout 自动暂停策略
—auto-pause-window-minutesstringrollout 自动暂停的统计窗口
—auto-pause-failure-rate-bpsstring以基点 (bps) 为单位的失败率阈值
—auto-pause-confidencestring0 到 1 之间的置信度水平
—auto-pause-min-attemptsstring触发自动暂停前所需的最少安装与失败尝试总次数
—auto-pause-min-failuresstring触发自动暂停前所需的最小失败次数
—auto-pause-actionstring自动暂停操作:pause、rollback 或 notify
—auto-pause-cooldown-minutesstring自动暂停再次触发前的冷却时间
—devboolean允许向开发设备发送更新
—no-devboolean禁止向开发设备发送更新
—prodboolean允许向生产设备发送更新
—no-prodboolean禁止向生产设备发送更新
—emulatorboolean允许向模拟器发送更新
—no-emulatorboolean禁止向模拟器设备发送更新
—deviceboolean允许向真机设备发送更新
—no-deviceboolean禁止向真机设备发送更新
—qr-previewboolean更新该 channel 后,在终端打印 QR code 用于预览该 channel
—send-update-notificationboolean更新关联的 channel bundle 后,向设备发送原生更新检查通知
—package-jsonstringMonorepo 中 package.json 文件的路径(以逗号分隔)
—ignore-metadata-checkboolean如果 bundle 中存在 node_modules,则忽略其兼容性检查
—supa-hoststring自定义 Supabase host URL(用于自托管或 Capgo 开发)
—supa-anonstring自定义 Supabase anon key(用于自托管)