チャンネル
このプラグインのインストール手順とフルマークダウンガイドまでの手順を含むセットアップ用の質問をコピーする。
How Capgo がチャンネルを選択する方法(優先順位)
「Capgo がチャンネルを選択する方法(優先順位)」のセクションデバイスが Capgo からアップデートを要求する場合、使用するチャンネルは、次の順序(優先順位が高い順)で決定されます:
- 強制デバイスマッピング: デバイスIDが明示的に強制的にチャンネルにマッピングされている場合(チャンネル設定の内部のリストを参照)、そのチャンネルは常に勝ちます。 Cloudフラグオーバー(またはWebアプリアクションで) : Cloudflare または Webapp アクションを呼び出す(またはデバイスのチャンネルをダッシュボードで変更する)と、デバイスIDに関連付けられた永続的なオーバーライドがクラウドに書き込まれます。このオーバーライドは、強制マッピング後にデフォルト値よりも前に参照されます。アプリを再インストールすると、
- 強制デバイス
setChannel(): 強制的にデバイスにチャンネルを割り当てたリストCloudフラグオーバーsetChannel: Cloudflare または Webapp アクションを呼び出す デバイスのチャンネル設定 デバイスを削除する; デバイスエントリを削除する。 - Capacitor 設定
defaultChannel(テストビルドのデフォルト): 内部 / ベータ / テストビルドの場合、次の設定をしてくださいdefaultChannel(レガシーキーchannel) incapacitor.config.*したがって、テストデバイスはプレリリースチャネル (例えば、beta,pr-123). これが欠如すると、デバイスはクラウドのデフォルトに進みます。 ほとんどのユーザーが使用する主な生産チャンネルです。 強制、オーバーライド、または設定なしの新しいデバイスは、このチャンネルを使用します。 この設定を変更すると、秒単位で全員に展開 (またはロールバック) されます—新しいバイナリなし。 - なぜ: The main production channel virtually all real users land on. Any new device without a force, without an override, and without a config
defaultChanneluses this. Changing it rolls out (or rolls back) for everyone in seconds—no new binary.
Why the クラウドデフォルト は、主なパスです:
- リビルドや再公開の必要のない即時ロールアウトまたはロールバック。
- iOS、Android、および Electron の動作を 1 つの場所で管理。
- 安全: バンドルが存在し、設定が正しいことを確認することができます。デフォルトを切り替える前に。
- 変更履歴 (チームメンバーは UI / ログで変更したことを確認できます)。 設計原則: 上位レイヤー (強制 / オーバーライド / 設定) は 例外
(デバッグのシングルユーザー、QA スイッチング、テストビルドのデフォルト)。通常のユーザーフローはクラウドデフォルトに流れます。 クラウドデフォルトの チャネルを変更すると 新規 通常のデバイスが:
- 強制されていない
- クラウドオーバーライドが既に設定されていない
- アプリレベルで定義されていない
defaultChannelテストビルドがクラウドデフォルトを変更した場合に
デバイスがクラウドデフォルトを変更した後も defaultChannel: 'beta' デバイスがクラウドデフォルトに変更された productionデバイスがクラウドデフォルトに変更された beta デバイスがクラウドデフォルトに変更された setChannel()デバイスがクラウドデフォルトに変更された
デバイスがクラウドデフォルトに変更された
- デバイスがクラウドデフォルトに変更された
- Call
setChannel()(creating/replacing the cloud override) or change it manually in the dashboard. - Remove / archive the channel they are on (then they will fall back through the precedence again at next check).
If a channel is disabled for a platform (see iOS / Android / Electron toggles) and would otherwise have been selected, the selection skips it and falls back to the next rule.
Note: Setting
defaultChannelNote:
Capacitor config example
Capacitor config example// Example: a TestFlight or internal QA build defaults to the beta channel.const config = { plugins: { Capgo: { defaultChannel: 'beta', // Test build default. Omit in production so users attach to cloud default. // legacy key: channel }, },};export default config;If you later change the dashboard default to production, devices already on another channel (via config, override, or force) will NOT move automatically; only fresh devices (or those whose override/force you clear) pick it up.
チャンネルを管理する
チャンネルの管理まず、チャンネルページを見てみましょう。 アプリをクリック そして チャンネルタブをクリック.

チャンネルを作成する
チャンネルを作成するチャンネルを作成する1 チャンネルを作成する

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

「不正設定」とは何ですか?
「不正設定とは何か?」というセクションチャンネルの設定が不正な場合があります。その場合、警告が大きく表示され、 Misconfigured 列は Yes 1 つ以上のチャンネルで不正です。 詳しくは
ここで
チャンネルを削除する「チャンネルを削除する」セクション チャンネル アプリのタブで、チャンネル行を探してください。アクションの列に、ゴミ箱のアイコンをクリックし、確認ダイアログで「削除」をクリックしてください。 アクション ゴミ箱のアイコンが表示されない場合は、アプリに対して削除権限が付与されていない可能性があります。組織またはアプリ管理者に権限を付与するよう依頼し、削除できるキーを持つチャンネルを削除してください。 チャンネル行のアクション列に表示されているゴミ箱のアイコン アプリに対して削除権限が付与されていない場合は、ゴミ箱のアイコンが表示されません。

クリップボードにコピー 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>チャンネル行のアクション列に表示されているゴミ箱のアイコン
チャンネルの管理チャンネル名をクリックすると、チャンネル設定を管理するモーダルが開きます。 (3 画像に示されているように

チャンネル設定ページには、チャンネルのすべての構成オプションが含まれます。各設定について説明していきます。
最初は Default channel スイッチです。有効にすると、このチャンネルは新しいデバイスのデフォルトチャンネルになります。デフォルトチャンネルの詳細について、プラットフォームごとのデフォルト設定の設定方法 (iOS、Android、Electron それぞれ) を含む、 デフォルトチャンネル構成 セクションを参照してください。
2番目は IOS 設定です。これは比較的簡単です。この値がfalseの場合、iOSデバイスはこのチャンネルからアップデートをダウンロードできません。
3番目は Android 設定。 この設定は IOSに似ています。 この値がfalseの場合、このチャンネルからAndroidデバイスはアップデートをダウンロードできなくなります。
第四は Electron 設定。 この設定は IOS に似ています。 この値がfalseの場合、このチャンネルからElectronアプリはアップデートをダウンロードできなくなります。 Android第五は
設定。 この値がtrueの場合、ネイティブバージョンからダウングレードすることは不可能になります。 つまり、アップロードした Disable auto downgrade under native バージョンをアプリストアまたはプレイストアにアップロードした後、チャンネルバージョンを 1.2.0 に設定しようとすると、更新(ダウングレード)は失敗します。 1.1.0 第六は
設定です。 この設定は非常に複雑であり、詳しくは Disable auto updateを参照してください。 ここ
この場合 Allow development build. このチャネルからアップデートをダウンロードすることを開発用ビルドに許可する場合は、真になります。そうでない場合は、 prod false
に設定されているアップデート要求は拒否されます。これは、主にテスト用途で便利です。 Allow Emulators. If this is false then Capgo will disallow any update request that comes from an emulator. This is mostly useful for testing purposes.
. エミュレータからアップデート要求が来る場合は、 Allow devices to self associatefalse に設定されている場合は、__CAPGO_KEEP_0__がアップデート要求を拒否します。これは、主にテスト用途で便利です。 第8は . この場合、 setChannel
__CAPGO_KEEP_0__から続けて
__CAPGO_KEEP_0__のセクション__CAPGO_KEEP_1__で __CAPGO_KEEP_2__ __CAPGO_KEEP_2__と連携して __CAPGO_KEEP_2__の実装詳細 __CAPGO_KEEP_2__の実装詳細 __CAPGO_KEEP_3__ __CAPGO_KEEP_3__の製品ワークフロー __CAPGO_KEEP_4__ __CAPGO_KEEP_5__ __CAPGO_KEEP_6__ 製品ワークフローについてのバージョン対象ソリューション、そして Capgo 環境ベストプラクティス:1つのモバイルアプリIDでステージング 製品ワークフローについての実用的な背景は、Capgo 環境ベストプラクティス:1つのモバイルアプリIDでステージング