Skip to content
Capgo - Capacitor アプリのリアルタイム更新 Capgo

App Page

アプリ画面は何を表示する?

「アプリ画面は何を表示する?」と題されたセクション

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

Capgoで、Capgoのライブアップデートシステムと統合されたアプリケーションを表します。Capgoのライブアップデートシステムと統合されたアプリケーションを表します。

メインページのスクリーンショット

ここで、もう少し詳しく見てみましょう。アプリのメインページは、以下の重要な領域に分かれています。

  1. 上部ナビゲーションバー: アプリ管理のさまざまなセクションにアクセスします。

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

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

    • 月間有効ユーザー (8): 時系列でユニークな有効ユーザーの数を追跡します。
    • ストレージ (9): 現在のストレージ消費量を表示します。
    • バンド幅 (10): バンド幅使用量を表示します。
    • アクティブ バンドル (11): アプリケーション バンドルの異なるバンドルの間でアクティブ デバイスの分布を表示します。

  3. 概要カード: 主な数値のクイック オーバーを提供します。

    • バンドル アップロード (12): アップロードされたアプリケーション バンドルの総数を表示します。
    • アップデート統計 (13): アップデートの総数、リクエスト、インストール、失敗を含む。
    • デプロイ統計 (14): デプロイの総数。

  4. 表示オプション (15-18): 統計をフィルタリングおよび表示するための制御:

    • 毎日 (15): 毎日基準で統計を表示する。
    • 累積 (16): 時間経過とともに累積統計を表示する。
    • 請求期間 (17): 現在の請求期間の統計を表示する。
    • Date Range (18): Select a custom date range (e.g., last 30 days).

アプリ情報

アプリ情報セクション

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

アプリ情報ページ
アプリ情報ページ

利用可能なフィールドとアクションの詳細

  • アプリアイコン (2): アプリケーションのアイコンを表示します。アイコンを変更するには、「変更」ボタンをクリックしてください。
  • アプリID (3): Capgo 内のアプリケーションに固有の識別子です。この ID は編集できません。
  • App Name (4): アプリケーションの表示名です。この名前に必要な場合に変更できます。
  • Default Upload Channel (5): 新しいバンドルをアップロードするデフォルトのチャンネルを指定します。編集アイコンをクリックして、別のデフォルトのチャンネルを選択できます。
  • Default Download Channel (6): デバイスがアップデートをダウンロードするデフォルトのチャンネルを指定します。編集アイコンをクリックして、別のデフォルトのチャンネルを選択できます。詳しくは、 Default Channel Configuration セクションを参照してください。
  • Auto Delete Bundles Not Used (after x seconds) (7): この設定により、指定された時間 (秒) 以内に使用されていない古いバンドルを自動的に削除できます。 0 を設定すると、自動削除を無効にします。この設定により、ストレージを管理し、バンドルのリストを綺麗に保つことができます。
  • Expose Bundle Metadata to Plugin (8): 有効にすると、bundle link と comment field は Capacitor の Updater プラグインに送信されます。この機能は、プラグインバージョン 7.35.0 以上が必要です。
  • アプリケーション所有権の移転 (9): このセクションでは、アプリケーションを異なる組織に移転するオプションを提供します。
  • アプリケーション削除ボタン: Capgo からアプリケーションを永久に削除します。このアクションは不可逆であり、すべての関連データ、バンドル、チャネル、デバイスも削除されます。
  • 更新ボタン: このページの編集可能フィールド（例：アプリ名、デフォルトアップロードチャネル、自動削除バンドル設定）に変更した内容を保存します。

デフォルトチャネル設定

デフォルトチャネル設定

The デフォルトダウンロードチャネル Capgo への新しいデバイスの初回接続時に、どのチャネルからアップデートを受信するかを決定します。

デフォルトチャンネルの動作

「デフォルトチャンネルの動作」セクション

Capgo からアップデートを要求された際のデバイスの動作

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

プラットフォーム固有のデフォルト チャネル

「プラットフォーム固有のデフォルト チャネル」のセクション

プラットフォーム固有のデフォルト チャネルを構成できます。例えば、iOS、Android、Electron それぞれに異なるチャネルを作成できます。この機能は、以下のシナリオで便利です。

  • 1 つのプラットフォームにアップデートをロールアウトする前に他のプラットフォームをアップデートしたい場合
  • 各プラットフォームごとに異なるアップデート戦略が必要な場合
  • 1 つのプラットフォームで新しいバージョンをテストしたいが、他のプラットフォームは安定したい場合

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

  1. 各プラットフォームごとに別々のチャネルを作成します (例えば production-ios, production-android各チャネルの設定で、関連するプラットフォーム (iOS、Android、または Electron) のみを有効にします。 production-electron)
  2. 両方のチャネルを「デフォルト」にマークします - __CAPGO_KEEP_0__ は、チャネルが異なるプラットフォームを対象としている場合にのみこれを行うことができます。
  3. Mark both channels as “Default” - Capgo allows this when channels target different platforms

__CAPGO_KEEP_0__:

  • __CAPGO_KEEP_0__:
  • __CAPGO_KEEP_0__:
「ほとんどのアプリケーション向けに推奨されるシングルデフォルトチャネル」

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

  1. 1つのチャネルを作成します (例えば、 production)
  2. iOS、Android、および Electron の切り替えが有効になっていることを確認します。
  3. デフォルトチャネルとしてマークします。

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

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

「デフォルトチャネルの変更」

デフォルトのチャネルを変更した場合:

  • 新しいデバイス 新しいデフォルトから即座に更新を受け取るようになります。
  • 既存のデバイス 既存のデバイスは、overrideまたはforceを介してチャネル割り当てが設定されている場合、自動的に切り替わることはありません。
  • 既存のデバイスを移動するには、次のいずれかを行う必要があります:
    • overrideを使用してプログラムでオーバーライドする setChannel() 新しいチャネルに強制的にダッシュボードで強制する
    • デバイスのエントリを削除する (新しいデフォルトに再登録する)
    • ヒント

: 新しいデフォルトチャネルをすべてのユーザーに適用する前に、強制されたデバイスの小さなグループでテストすることをお勧めします。__CAPGO_KEEP_0__

App Page から続けてください

App Page から続けてください

あなたが「App Page」を使用している場合 App Page App Page を使用してダッシュボードと API の操作を計画する場合、API を接続してください API オーバービュー API オーバービューの実装詳細については、API オーバービューを参照してください Introduction Introduction の実装詳細については、Introduction を参照してください API キー API キーの実装詳細については、API キーを参照してください デバイス __CAPGO_KEEP_0__の実装詳細については、デバイスのページを参照してください。 __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ページ