チャンネル

コピー用のプロンプト

Capgo がチャンネルを選択する方法 (優先順位)

Capgo がデバイスからアップデートを要求されたとき、使用するチャンネルは、次の順序 (優先順位が高い順) で決定されます:

強制デバイスマッピングデバイス : デバイス ID が明示的に強制的にチャンネルにマッピングされる場合 (チャンネルページの "デバイス" タブ)、そのチャンネルは常に勝ちます。強制マッピングはコンソール/__CAPGO_KEEP_0__ のオーバーライドです。 __CAPGO_KEEP_1__ は、最後のオーバーライドの書き込みから 90 日後に削除されます。詳しくは "コンソールと __CAPGO_KEEP_0__ のオーバーライドの有効期限" を参照してください。 tab on the channel page), that channel always wins. Forced mappings are console/API overrides. Capgo removes them 90 days after the last override write. See Console and API overrides expire.
Cloud override (Dashboard or Public API)Cloud override (Dashboard or Public API) : Changing a device’s channel in the dashboard or via the Public __CAPGO_KEEP_0__ writes an override tied to that device ID. Reinstalling the app does
not setChannel() clear it; deleting the override does. The same 90-day retention applies.Plugin setChannel() (local) setChannel() : On current plugin versions,
Capacitor config defaultChannel again if you still want that channel.__CAPGO_KEEP_0__ config (test build default): For internal / beta / test builds you can set defaultChannel (レガシーキー) channel) in capacitor.config.* なので、テスト用デバイスは、プレリリースチャンネル (例えば beta, pr-123) にスタートします。これが欠如している場合、デバイスはクラウドのデフォルトに進みます。生成物のビルドは通常、この値を未設定にします。
クラウドデフォルトチャンネル (99% のユーザーにとっての主な戦略): 実際のユーザーがほとんどが到達する、主な生産チャンネルです。強制、オーバーライド、ローカル設定、または構成がなければ、デバイスはこの値を使用します。この値を変更すると、秒単位で全員にロールアウト (またはロールバック) され、ビンナリを再構築または再公開する必要はありません。 setChannel()なぜ defaultChannel クラウドデフォルト

が主なパスであるか ロールアウトまたはロールバックが即時で、ビンナリを再構築または再公開する必要がないため is the main path:

Instant rollout or rollback without rebuilding or re‑publishing native binaries.
iOS、Android、Electronの動作を1つの場所で管理
安全: バンドルが存在し、設定が正しいことを確認してデフォルトを切り替えることができます
変更履歴 (チームメンバーはUIやログで変更した内容を確認できます)。設計原則: 上位レイヤー (強制 / オーバーライド / 設定) は例外 (デバッグ用に 1 人のユーザーを対象に、QA の切り替え、テストビルドのデフォルト)。通常のユーザーはクラウドのデフォルトに流れます。

クラウドデフォルトの変更は クラウドデフォルト 次の新規の通常のデバイスに影響します: 強制されていない クラウドのオーバーライドが既に存在しない

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
アプリレベル defaultChannel 定義されていません

テストビルドが defaultChannel: 'beta' のデフォルトを productionに変更した場合、 beta で起動した defaultChannelを通じて設定された setChannel() は、優先順位の高い割り当てが適用されるか、または

を出荷するまでそのまま残ります。

Force them to another channel (console or Public API).
Change the cloud override in the dashboard or Public API.
を強制することです。 setChannel() (__CAPGO_KEEP_0__の現在のプラグインバージョンにローカル割り当てがある).
(チャンネルが現在のプラグインバージョンにローカル割り当てがある場合に使用します。)
Wait until a console/API override expires after 90 days.
(90日後に有効期限切れになるコンソール/__CAPGO_KEEP_0__オーバーライドを待ちます。) setChannel() (アプリを再インストールすると、ローカル割り当てがクリアされますが、コンソール/APIオーバーライドはクリアされません。)

(プラットフォームごとに有効/無効を切り替えるiOS / Android / Electronのスイッチを参照してください。チャンネルが有効になっていない場合、選択はそのチャンネルをスキップし、次のルールにフォールバックします。)

(注:設定を変更すると、新しいバイナリが必要になります。テスト/QA用に意図的に使用してください。一般的な生産制御では使用しないでください。) defaultChannel (テスト/QA用に意図的に使用してください。)

Capacitorの設定例

// Example: a TestFlight or internal QA build defaults to the beta channel.
const config = {
  plugins: {
    CapacitorUpdater: {
      defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default.
      // legacy key: channel
    },
  },
};
export default config;

後でデフォルトのダッシュボードを変更した場合 productionすでに別のチャンネル (config、override、またはforce) を通じて接続されているデバイスは自動で移動しない; ただし、最新のデバイス (またはoverride/forceをクリアしたデバイス) は新しい設定を受け取る。

チャンネルの管理

まず、チャンネルページを見てみましょう。アクセスするにはアプリをクリックそしてチャンネルタブをクリック.

チャンネルの作成

下部右隅にプラスボタンが見えます。1 イメージ内でクリックすると、モーダルウィンドウが開き、新しいチャンネルを作成できます。

次に、クリックすると Add 新しいチャンネルがリストに表示されます。

何が不正設定であるか?

チャンネルの設定が有効でない場合があります。その場合、警告が大きく表示され、 Misconfigured 列は Yes 1 つ以上のチャンネルで有効でないためです。詳しくはここで学習できます。

チャンネルの削除

Webアプリからチャンネルを削除するには、 チャンネル コンテキスト:Capgoのリリースチャンネル機能名。ページ/エリア:Capgoのソリューションマーケティングページ。ロール:短いUIラベルまたはナビゲーションアイテム。見られる場所:ページソリューション/ホワイトラベル.astro。メッセージキー`solutions_white_label_visual_cell2_value` (ソリューションホワイトラベルビジュアルセル2 値)。タブアクション列削除

確認ダイアログ channel.delete permission for that app. Ask an organization or app admin to grant a role that can delete channels, or delete the channel with an API key that has permission:

npx @capgo/cli@latest channel delete <channel-name> <app-id>

組織とアプリに紐づいた アプリプレビュー キーは、非公開のプレビューチャンネルと、そのキーで作成されたバンドルを、原子的に削除することができます。既存のデフォルト/メインチャンネル、別のプレビューキーのチャンネル、または別のキーのバンドルを変更または削除することはできません。詳しくは channel delete <preview-channel> <app-id> --delete-bundle__CAPGO_KEEP_0__ キー API Keys チャンネルの管理

「チャンネルの管理」

チャンネル設定

__CAPGO_KEEP_0__

ダッシュボードこのチャンネルの現在のバンドルとインストールの統計
情報: Channel settings listed below, plus progressive rollout and Test Update API.
このチャンネルのプログレッシブロールアウトとテストアップデート: Forced mappings created from the console or Public API only. It does not list every device currently on the channel, and it does not list devices that used setChannel()コンソールまたはパブリックから作成された強制マッピングのみを表示します。 Console and API overrides expire.
履歴このチャンネルの設定とバンドルの変更
プレビュー: Webブラウザとネイティブのプレビューアプリ情報最初に

情報設定

このタブに残す情報タブ

最初に デフォルトダウンロードチャネル ステータスバッジであり、スイッチではありません アクティブ このチャンネルはデフォルトで新しいデバイスに使用されます。クリック アプリ設定で変更 をクリックしてデフォルトを変更アプリ情報をクリックしてください。

プラットフォーム固有のデフォルト (iOS、Android、Electron のそれぞれ) を確認するには、同じセクションを参照してください。 IOS の設定を確認してください。

この値がfalseの場合、iOSデバイスはこのチャンネルからアップデートをダウンロードできません。 Android の設定を確認してください。

この値がfalseの場合、Androidデバイスはこのチャンネルからアップデートをダウンロードできません。 Electron の設定を確認してください。

この値がfalseの場合、Electronアプリはこのチャンネルからアップデートをダウンロードできません。 Disable auto downgrade under native 設定が有効の場合、ネイティブ版からバージョンを下げることは不可能になります。このことは、アップロードしたアプリをアプリストアまたはプレイストアに公開し、チャネルバージョンをに設定した場合に発生します。すると、更新(下げ)は失敗します。 1.2.0 アップロードしたアプリのバージョンをアプリストアまたはプレイストアに公開した場合、チャネルバージョンをに設定すると、更新(下げ)が失敗します。 1.1.0 第六は

設定は複雑ですが、詳しくはここで学習できます。 Disable auto update第七は設定です。デバイスがフルZIP、変更されたファイルのデルタ、または両方をダウンロードするかどうかを選択します。詳細は

アップデートパッケージ Update package 第八は設定です。開発用ビルドがこのチャネルからアップデートをダウンロードできるようにするかどうかを選択します。そうでない場合は、falseに設定されているアップデート要求は拒否されます。これは主にテスト用途で役立ちます。.

__CAPGO_KEEP_0__ Allow development build__CAPGO_KEEP_0__ prod __CAPGO_KEEP_0__

9 番目の Allow production buildこの値が false の場合、このチャネルからアップデートを受け取ることはできません。実ユーザーを対象とするチャネルでは、この値をオンにします。

10 番目の Allow EmulatorsCapgo がエミュレータからアップデート要求を受け入れないようにするには、この値を false に設定します。主にテスト用途で使用します。

11 番目の Allow physical devicesCapgo が実機からアップデート要求を受け入れないようにするには、この値を false に設定します。実用チャネルでは、この値をオンにします。

12 番目の Allow devices to self dissociate/associateこの値が true の場合、setChannel メソッドが利用可能になります。この値が false に設定されている場合、setChannel メソッドを呼び出しても失敗します。 setChannel setChannel setChannel setChannel

テストアップデート API

下部にある情報タブを展開 テストアップデート API. Capgo は、このチャンネルでサンプルデバイスにカールコマンドを表示します。 /updates 変更はキャッシュのため、最大 60 秒で表示される場合があります。チャンネルがテストできない場合、コンソールは警告します: このチャンネルには少なくとも iOS または Android のプラットフォーム、生産用ビルド、物理デバイス、およびデフォルトのダウンロードチャンネルまたはデバイスの自己割り当てを許可する必要があります。

Changes can take up to 60 seconds to show in the API because of caching. If the channel cannot be tested, the console warns you: the channel needs at least one platform (iOS or Android), production builds, physical devices, and either to be the default download channel or to allow device self-assignment.

セクション「アップデート通知を送信」

を求めることがあります アップデート通知を送信. これにより、チャンネルに接続されているデバイスは、現在新しいバンドルをチェックするようになります。アプリの通知タブで、まずAndroidとiOSのプッシュ認証情報を設定してください。

コンソールとAPIオーバーライドの期限切れ

強制マッピングとダッシュボード/パブリックAPIチャンネルオーバーライドは削除されます 90日 最後のオーバーライドの書き込み後90日後。最後のデバイスチェックインは時計をリセットしません。割り当てがそのクリーンアップで生き残る場合、 defaultChannel あなたのCapacitor設定（再インストールで生き残り、バイナリを変更するには新しいバイナリが必要）または setChannel() アプリから呼び出す（90日間のクリーンアップを避けるが、再インストールするとクリアされるので、アプリは再び呼び出す必要があります） setChannel() __CAPGO_KEEP_0__チャンネルデバイスタブに表示されるオーバーライドの保持ポップオーバー:コンソールオーバーライドは90日後に期限切れ

Capgo channel Devices tab showing the Override retention popover: console overrides expire after 90 days — 送信アップデート通知

この機能はデバイスのインベントリの保持とは. Inventory removes devices that have not connected to Capgo for 90 days. Override cleanup removes the mapping even if the device is still active. Full detail: Console and API overrides expire after 90 days.

コンソールとオーバーライドの__CAPGO_KEEP_0__は90日間有効です

「パッケージの更新」というセクション チャンネルを開き、情報タブに留まる 情報 「パッケージの更新」は、自動更新を無効にする設定の下にあります。 パッケージの更新のドロップダウンリストは、__CAPGO_KEEP_0__チャンネルで、ZipとDelta、Zipのみ、Deltaのみ、Zipのみからビルトイン、Deltaのみからビルトインのオプションを表示します。

Update package dropdown on a Capgo channel showing Zip and delta, Zip only, Delta only, Zip only from builtin, and Delta only from builtin — チャンネル情報タブでパッケージをアップデートします。新しいチャンネルはデフォルトでZipとdeltaです。

この設定は、デバイスがこのチャンネルでアップデートをチェックするときに、Capgoが送信するものを選択します。 __CAPGO_KEEP_0__ コンソールのラベル

__CAPGO_KEEP_0__ / __CAPGO_KEEP_1__の値	CLI / API value	Zipとdelta
両方が存在する場合、フルZIPとdeltaをダウンロードします。この設定はデフォルトです。	`all`	Zipのみ
フルZIPのみ	`zip`	deltaのみ
__CAPGO_KEEP_0__ / __CAPGO_KEEP_1__ value	`delta`	変更されたファイルのみ。アプリケーションに適用できないデリタのプラグインは、zipを取得します。
ストアビルドからzipのみ	`zip_from_builtin`	ストアビルドのデバイスがオンラインの場合にのみzipを取得します。最初のライブアップデート後、Capgoはzipとデリタを再び提供します。
ストアビルドからデリタのみ	`delta_from_builtin`	ストアビルドのデバイスがオンラインの場合にのみデリタを取得します。最初のライブアップデート後、Capgoはzipとデリタを再び提供します。

ビルトイン App StoreまたはPlay Storeビルド内に配信されたWebアセットです。Capgoのアップデート前のものです。zipのみまたはデリタのみの初回アップデートを指定し、後続のアップデートで両方を使用できるようにします。 from builtin __CAPGO_KEEP_0__はzipのみのチャンネルとデリタのみのバンドルを組み合わせたり、逆の組み合わせを組み合わせたりしないようにします。コンソール、__CAPGO_KEEP_1__、チャンネル__CAPGO_KEEP_0__は、保存を拒否し、欠落しているパッケージをアップロードするか、モードを切り替えるように指示します。

Capgo will not pair a zip-only channel with a delta-only bundle, or the reverse. The console, CLI, and コンソール、__CAPGO_KEEP_1__、チャンネルAPIは、保存を拒否し、欠落しているパッケージをアップロードするか、モードを切り替えるように指示します。 __CAPGO_KEEP_0__から同じ値を設定できます。チャンネルはすでに存在している必要があります:

CLI

npx @capgo/cli@latest channel set production com.example.app --update-package zip

有効な値: all, zip, delta, zip_from_builtin, delta_from_builtin.

進化的なロールアウト

チャンネル情報チャンネルの「情報」タブには 進化的なロールアウト セクションがあります。ターゲットバンドルを設定し、パーセンテージと決定キャッシュの期間を選択し、ロールアウトを有効にすると、同じセクションからエクスポージャーを一時停止または再開、ターゲットを安定に昇格、ロールバック、または失敗信号が閾値を超えたときに自動的に一時停止、ロールバック、または通知を構成できます。

Read 進歩的なロールアウト有効にする前に、コホートの固定、安全なパーセンテージの変更、自動停止の動作を説明するものがあります。

チャンネルから続けて

Capgoのリリースチャンネル機能を使用している場合 チャンネル チャンネルチャンネルチャンネルチャンネルチャンネルベータテストソリューションベータテストソリューション用製品ワークフローバージョンターゲットソリューションバージョンターゲットソリューション用製品ワークフロー、 Capgo 環境ベストプラクティス: ステージングに 1 つのモバイルアプリ ID Capgo 環境ベストプラクティス: ステージングに 1 つのモバイルアプリ ID の実用的なコンテキスト