チャネル

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

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

1. Forced device mapping: If the device ID is explicitly forced to a channel (see the Forced devices list inside the channel settings), that channel always wins.
2. Cloud override (created by setChannel() or Webapp action): Calling setChannel (or changing a device’s channel in the dashboard) writes a persistent override in the cloud tied to that device ID. That override is consulted after forced mapping but before any defaults. Re‑installing the app does not clear it; deleting the device entry does.
3. Capacitor config defaultChannel (test build default): 内部 / ベータ / テスト ビルドの場合、__CAPGO_KEEP_0__ を設定できます。 defaultChannel (レガシーキー channel) capacitor.config.* で、テスト デバイスはプレリリース チャネル (例えば、 beta, pr-123) に開始します。__CAPGO_KEEP_0__ が存在しない場合、デバイスはクラウドのデフォルトに進みます。生産ビルドでは通常、この値を未設定にします。
4. クラウド デフォルト チャネル (99% のユーザーの主な戦略): 実際のユーザーがほとんどが利用する主な生産チャネルです。強制、オーバーライド、または構成なしの新しいデバイスは、このチャネルを使用します。変更すると、秒単位で全員に展開 (またはロールバック) されます—新しいバイナリなし。 defaultChannel なぜクラウド デフォルトが主なパスなのか:

インスタント ロールアウトまたはロールバックが可能なのは、バイナリを再構築または再公開する必要がないためです。 なぜクラウド デフォルトが主なパスなのか: インスタント ロールアウトまたはロールバックが可能なのは、バイナリを再構築または再公開する必要がないためです。

• : なぜクラウド デフォルトが主なパスなのか: インスタント ロールアウトまたはロールバックが可能なのは、バイナリを再構築または再公開する必要がないためです。
• iOS、Android、Electronの動作を1つの場所で管理します。
• 安全性が高まります: バンドルが存在し、設定が正しいことを確認することができます。デフォルトを切り替える前に。
• 変更履歴は確認できます (チームメンバーはUIとログで変更した内容を確認できます)。 レイヤー上の(強制/上書き/設定)は 例外

(デバッグのためのシングルユーザー、QAの切り替え、テストビルドのデフォルト)。通常のユーザーフローはクラウドのデフォルトに流れます。 クラウドのデフォルトを変更すると 新しい 通常のデバイスが影響を受けます: 強制されていない

• クラウドのオーバーライドが既に存在しない
• デバイス
• アプリレベル defaultChannel 定義されていません

テストビルドが defaultChannel: 'beta' クラウドのデフォルトを productionデバイスが beta クラウド設定を通じて setChannel()(a) 上書きする

(b) 強制する

• (c) デバイスエントリを削除する
• デバイスは現在のチャネルで動作し続けます。 setChannel() 強制的に別のチャネルに切り替える
• (クラウドオーバーライドを作成または置き換える) またはダッシュボードで手動で変更する。

プラットフォーム (iOS / Android / Electron のスイッチ) で有効になっていないチャネルが選択されていた場合、選択はそのチャネルをスキップし、次のルールにフォールバックします。

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

Capacitor 設定の例

capacitor.config.ts

// 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;

後でデフォルトのダッシュボードを変更した場合、 productionデバイスはすでに別のチャネル (config、override、または force を介して) にある場合、自動的に移動しません; ただし、最新のデバイス (またはオーバーライド/強制を解除したデバイス) は、変更を取得します。

---

チャネル管理

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

チャンネルを作成

画像の下部右隅にプラスボタンが存在します。 (1 クリックすると、チャンネルを作成するモーダルが開きます。

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

__CAPGO_KEEP_0__は何を意味しますか？

時々、チャンネルの設定が有効ではありません。そうすると、警告が大きく表示され、 Misconfigured 列は Yes 一つ以上のチャンネルに対して表示されます。 詳しくは ここで

チャンネルを削除する

チャンネルを削除することは簡単です。ゴミ箱のアイコンをクリックし、削除を確認してください（2 イメージ内）

チャンネルの管理

チャンネル名をクリックすると、チャンネル設定を管理するモーダルが開きます。 (3 image内に記載されているもの)

チャンネル設定ページには、チャンネルに関するすべての設定オプションが含まれます。各設定について説明していきます。

---

まずは Default channel スイッチです。有効にすると、このチャンネルは新しいデバイスのデフォルトチャンネルになります。デフォルトチャンネルの詳細について、プラットフォームごとのデフォルト設定の設定方法 (iOS、Android、Electron それぞれ) を含めて、 Default Channel Configuration セクションで確認してください。

---

次に IOS 設定です。これは比較的簡単です。この設定がfalseの場合、iOSデバイスはこのチャンネルからアップデートをダウンロードできません。

最後には Android 設定です。これは前と似ています。 IOS. この値が false の場合、このチャンネルから Android デバイスはアップデートをダウンロードできません。

第四は Electron 設定です。この設定は IOS と Android. この値が false の場合、Electron アプリはこのチャンネルからアップデートをダウンロードできません。

第五は Disable auto downgrade under native 設定です。この値が true の場合、ネイティブ版からダウングレードすることはできません。この場合、ネイティブ版のアップデートをアプリストアやプレイストアにアップロードし、チャンネルバージョンを 1.2.0 に設定しようとすると、ダウングレードアップデートは失敗します。 1.1.0 第六は

です。この設定は複雑で、詳細は Disable auto updateで確認できます。 __CAPGO_KEEP_0__

この設定が有効の場合、開発用ビルドはこのチャンネルからアップデートをダウンロードすることを許可します。そうでない場合、__CAPGO_KEEP_0__ が「false」に設定されているアップデート要求はすべて拒否されます。これは、主にテスト用途で使用されます。 Allow development buildこの設定が有効の場合、開発用ビルドはこのチャンネルからアップデートをダウンロードすることを許可します。そうでない場合、__CAPGO_KEEP_0__ が「false」に設定されているアップデート要求はすべて拒否されます。これは、主にテスト用途で使用されます。 prod 7つめは

この設定が有効の場合、__CAPGO_KEEP_0__ はエミュレータからアップデート要求を受け入れないようになります。これは、主にテスト用途で使用されます。 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.

この設定が有効の場合、setChannel メソッドが利用可能になります。そうでない場合、このチャンネルで setChannel メソッドを呼び出そうとすると、呼び出しは失敗します。 Allow devices to self associateチャンネルから続けてください この設定が有効の場合、setChannel メソッドが利用可能になります。そうでない場合、このチャンネルで setChannel メソッドを呼び出そうとすると、呼び出しは失敗します。 チャンネルから続けてください この設定が有効の場合、setChannel メソッドが利用可能になります。そうでない場合、このチャンネルで setChannel メソッドを呼び出そうとすると、呼び出しは失敗します。 チャンネルから続けてください

この設定が有効の場合、setChannel メソッドが利用可能になります。そうでない場合、このチャンネルで setChannel メソッドを呼び出そうとすると、呼び出しは失敗します。

__CAPGO_KEEP_0__が使用されている場合 __CAPGO_KEEP_0__ __CAPGO_KEEP_0__と連携する __CAPGO_KEEP_0__の実装詳細 __CAPGO_KEEP_0__の実装詳細 ベータテスト ソリューション ベータテスト ソリューションで製品ワークフロー バージョン ターゲット ソリューション バージョン ターゲット ソリューションで製品ワークフロー ベータテスト ソリューション バージョン ターゲット ソリューション Capgo 環境ベストプラクティス: ステージング用に 1 つのモバイル アプリ ID Capgo 環境ベストプラクティス: ステージング用に 1 つのモバイル アプリ ID の実用的な文脈に