アプリ画面

アプリのページに表示される内容は何ですか?

まず、アプリのメインページを確認してみましょう。

Capgoで、アプリはCapgoのライブアップデートシステムと統合されたモバイルアプリケーションを表します。アップデート、チャンネル、デバイスを管理することができます。

この画面を詳しく見てみましょう。アプリのメイン画面は、以下の重要な領域に分かれています。

1. 上部ナビゲーションバー: アプリ管理の異なるセクションにアクセスするための機能を提供します。

   • ダッシュボード (1): 重要なメトリクスと概要を表示する現在のビューです。
   • 情報 (2): アプリの基本設定と詳細を表示します (「アプリ情報」セクションを参照)。
   • バンドル (3): アプリのバージョンとリリースを管理します。
   • チャンネル (4): 異なるアップデートチャンネル (例: 生産、ベータ) を構成および管理します。
   • デバイス (5): 登録済みデバイスを表示および管理し、特定のオーバーライドを設定します。
   • ログ (6): アプリの詳細ログとエラー報告にアクセスします。
   • ビルド (7): アプリのビルドを表示および管理します。

2. 統計表示: 重要なメトリクスをビルティング期間末に視覚化します (データは請求日からではなく、月初日から反映されます):

   • 月間有効ユーザー数 (8): ユーザーの数を時間の経過とともに追跡します。
   • ストレージ (9): 現在のストレージ消費量を表示します。
   • 帯域幅 (10): __CAPGO_KEEP_0__
   • アクティブなバンドル (11): __CAPGO_KEEP_1__

3. 概要カード: __CAPGO_KEEP_2__

   • バンドルアップロード (12): __CAPGO_KEEP_3__
   • アップデート統計 (13): __CAPGO_KEEP_4__
   • デプロイ統計 (14): __CAPGO_KEEP_5__

4. 表示設定 (15-18): 統計情報のフィルタリングと表示に使用するコントロール:

   • 毎日 (15): 毎日を対象にした統計情報を表示します。
   • 累積 (16): 過去の累積統計情報を表示します。
   • 請求期間 (17): 現在の請求期間を対象にした統計情報を表示します。
   • 日付範囲 (18): カスタムの日付範囲を選択します (例: 最近の 30 日間).

アプリ情報

このセクションは、上部ナビゲーションバーの「情報」タブ (1) に対応しています。ここでは、重要な詳細と設定を表示および管理できます。

アプリケーション情報ページ

利用可能なフィールドとアクションの詳細は以下のとおりです。

• アプリケーションアイコン (2): アプリケーションのアイコンを表示します。 "変更" ボタンをクリックすると、新しいアイコンをアップロードできます。
• アプリケーションID (3): 一意の識別子です。Capgo 内のアプリケーションに割り当てられます。この ID は編集できません。
• アプリケーション名 (4): アプリケーションの表示名です。必要に応じて変更できます。
• デフォルトアップロードチャネル (5): 新しいバンドルがアップロードされるデフォルトのチャネルを指定します。編集アイコンをクリックして、別のデフォルトチャネルを選択できます。
• Default Download Channel (6): デフォルトのダウンロードチャネルを指定します。デバイスはこのチャネルからアップデートをダウンロードします。編集アイコンをクリックして、別のデフォルトチャネルを選択できます。詳しくは、 Default Channel Configuration 下のセクションを参照してください。
• Auto Delete Bundles Not Used (after x seconds) (7): この設定では、指定された時間 (秒) 以内に使用されていない古いバンドルを自動的に削除できます。 0 を設定すると、自動削除が無効になります。この設定は、ストレージを管理し、バンドルリストを綺麗に保つのに役立ちます。
• Expose Bundle Metadata to Plugin (8): When enabled, bundle link and comment fields will be sent to the Capacitor Updater plugin. This feature requires plugin version 7.35.0 or higher.
• Updater プラグインにバンドルリンクとコメントのフィールドが送信されます。この機能は、プラグインバージョン 7.35.0 以上が必要です。 Transfer App Ownership (9):
• このセクションでは、別の組織に属している場合にアプリケーションの所有権を移行するオプションが提供されます。 このアプリケーションをCapgoから永久に削除します。このアクションは不可逆であり、すべての関連データ、バンドル、チャネル、デバイスを削除します。
• 更新ボタン: このページの編集可能フィールド（例：アプリ名、デフォルトアップロードチャネル、自動削除バンドル設定）に作成した変更を保存します。

デフォルトチャネル設定

デフォルトダウンロードチャネル アプリの重要な設定の1つです。新しいデバイスが__CAPGO_KEEP_0__に初めて接続したときに、どのチャネルからアップデートを受け取るかを決定します。 is one of the most important settings for your app. It determines which channel new devices will receive updates from when they first connect to Capgo.

デバイスが__CAPGO_KEEP_0__からアップデートを要求したとき、システムは次の順序（優先度が高い順）に基づいてどのチャネルを使用するかを決定します:

When a device requests an update from Capgo, the system determines which channel to use based on the following precedence (highest priority first):

1. 強制デバイスマッピング: __CAPGO_KEEP_0__ IDが明示的にチャンネル設定に強制されると、そのチャンネルが常に優先されます。
2. Cloud override: __CAPGO_KEEP_0__ がチャンネルを通じて割り当てられた場合、またはダッシュボードで手動で割り当てられた場合、そのオーバーライドが使用されます。 setChannel() __CAPGO_KEEP_0__ config
3. : Capacitor ファイルに設定されている場合、テスト/ベータビルド用に使用されます。 defaultChannelDefault Download Channel capacitor.config.* : この設定がここで構成されている場合—これは、99%のプロダクションユーザーが使用するものです。
4. Platform-Specific Default Channelsプラットフォーム固有のデフォルトチャンネル

You can configure platform-specific default channels—for example one for iOS, one for Android, and one for Electron. This is useful when:

Section titled “Platform-Specific Default Channels”

• 別のプラットフォームよりも先にアップデートを展開したい
• 各プラットフォームごとに異なるアップデート戦略が必要
• 一方のプラットフォームで新しいバージョンをテストしながら、もう一方のプラットフォームを安定させる

プラットフォーム固有のデフォルト値を設定するには:

1. 各プラットフォーム (例えば iOS、Android、Electron) に対して別々のチャンネルを作成する production-ios, production-android, production-electron)
2. 各チャンネルの設定で、関連するプラットフォーム (iOS、Android、または Electron) のみを有効にする
3. 両方のチャンネルを「デフォルト」にマークする - Capgo は、チャンネルが異なるプラットフォームをターゲットしている場合にこれを可能にする

デバイスがアップデートを要求した場合:

• iOS デバイスは、iOS を有効にしたデフォルトのチャンネルからアップデートを受け取る
• Android デバイスは、Android を有効にしたデフォルトのチャンネルからアップデートを受け取る

単一のデフォルトチャンネル (推奨されるのはほとんどのアプリ用)

ほとんどのアプリケーションでは、すべての3つのコアプラットフォームをサポートする単一のデフォルトチャネルが最も簡単なアプローチです。

1. 1つのチャネルを作成します（例えば、 production)
2. __CAPGO_KEEP_0__
3. iOS、Android、および Electron のスイッチが有効になっていることを確認します。

デフォルトチャネルとしてマークします。

これにより、すべてのプラットフォームで一貫した動作が保証され、リリースワークフローが簡素化されます。

デフォルトチャネルの変更時

• 新規デバイス 新しいデフォルトから即座にアップデートを受信します。
• 既存のデバイス __CAPGO_KEEP_0__が事前にチャネル割り当て (override または force を使用) が設定されている場合、自動的に切り替わることはありません。
• 既存のデバイスを移動するには、次のいずれかを行う必要があります:
  • Use setChannel() プログラムでオーバーライドする
  • Force them to the new channel in the dashboard
  • デバイスのエントリを削除する (新しいデフォルトで再登録する)

Tip: 小規模の強制デバイスグループで新しいデフォルトチャネルをテストすることを常に忘れないでください。