📢 チャンネル

📢 Capgo Cloud でアプリ更新用の配信チャネルを管理し、デバイスへの配信方法を制御します。

➕ 追加

エイリアス: a

npx @capgo/cli@latest channel add

➕ 更新の配信を管理するため、Capgo Cloud にアプリ配信用の新しいチャネルを作成します。

例:

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

オプション:

パラメータ	種類	説明
-d	boolean	チャンネルをデフォルトに設定
—self-assign	boolean	デバイスがこのチャンネルに自動割り当てされることを許可
-a	string	アカウントに紐付ける API キー
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

🗑️ 削除

エイリアス: d

npx @capgo/cli@latest channel delete

🗑️ Capgo Cloud からチャンネルを削除します。オプションで関連する bundle も削除してリソースを解放できます。

例:

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

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
—delete-bundle	boolean	チャンネルに関連付けられたbundleを削除します。App Previewキーを使用する場合、自身のプレビューチャンネルと、共有されていないリンク済みのbundleのみをアトミックに削除できます。
—success-if-not-found	boolean	チャンネルが見つからない場合に成功とみなします
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

注意

組織およびアプリに紐付けられた アプリプレビュー API キーを使用します。 --delete-bundle 非公開のPRプレビューチャネル専用です。このコマンドは、限定的なアトミッククリーンアップルートを使用します。つまり、そのキーが作成した特定のチャネルと、それに関連付けられた共有されていないbundleに対してのみ成功します。既存のデフォルト/メインチャネル、他のプレビューキーのチャネル、または他のキーのbundleに対してこのキーを使用することはできず、一般的な bundle.delete。詳細は API キー のセットアップ権限も付与されません。

📋 一覧

エイリアス: l

npx @capgo/cli@latest channel list

📋 Capgo Cloud でアプリに設定されている全チャンネルを一覧表示し、配信設定を確認します。

例:

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

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

📦 CurrentBundle

npx @capgo/cli@latest channel currentBundle

📦 更新トラッキングのため、Capgo Cloud 内の特定の channel に紐付けられた現在の bundle を取得します。

例:

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

オプション:

パラメータ	種類	説明
-c	string	現在のbundleを取得する対象のChannel
-a	string	アカウントに紐付ける API キー
—quiet	boolean	bundleのバージョンのみを表示
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)

⚙️ 設定

エイリアス: s

npx @capgo/cli@latest channel set

⚙️ bundleの紐付け、アップデート戦略（major, minor, metadata, patch, none）の設定、デバイスターゲット（iOS, Android, dev, prod, emulator, device）の指定など、チャンネルの設定を行います。 必ず1つのチャンネルをデフォルトに設定する必要があります。

例:

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

オプション:

パラメータ	種類	説明
-a	string	アカウントに紐付ける API キー
-b	string	設定するファイルのBundleバージョン番号
-s	string	チャンネルの状態を default または normal に設定
—latest-remote	boolean	capgo クラウドにアップロードされた最新の bundle を取得し、チャンネルに設定します
—latest	boolean	package.json の最新の version キーを取得し、チャンネルに設定します
—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	アップデートの種類（major, minor, metadata, patch）をブロック、またはすべて許可（none）
—update-package	string	zip、delta、またはその両方を配信：all, zip, delta, zip_from_builtin, delta_from_builtin
—rollout-bundle	string	このチャンネルで段階的にリリースするBundleのバージョン
—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	ロールアウトの状態をクリアし、デバイスをstableに戻す
—rollout-promote	boolean	ロールアウト対象をstableに昇格させ、ロールアウト状態をクリアする
—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	自動停止時のアクション: pause、rollback、またはnotify
—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 を、更新後にターミナルに表示する
--send-update-notification	boolean	リンクされたチャンネルのbundle更新後、デバイスにネイティブのアップデート確認通知を送信する
--package-json	string	モノレポ用の package.json ファイルへのパス（カンマ区切り）
--ignore-metadata-check	boolean	bundle内にnode_modulesが存在する場合、その互換性チェックをスキップします
—supa-host	string	カスタム Supabase ホスト URL (セルフホストまたは Capgo 開発用)
—supa-anon	string	カスタム Supabase anon キー (セルフホスト用)