Skip to content
Capgo - Live Updates for Capacitor Apps Capgo

アプリ画面

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

「アプリのページに表示されるものは何ですか?」というセクション

まず、アプリのメインページをご覧ください。__CAPGO_KEEP_0__のアプリは、__CAPGO_KEEP_1__のライブアップデートシステムと統合されたモバイルアプリケーションを表します。__CAPGO_KEEP_1__のライブアップデートシステムと統合されたモバイルアプリケーションを表します。アップデート、チャンネル、デバイスを管理することができます。

In Capgo, an app represents your mobile application integrated with Capgo’s live update system. It allows you to manage updates, channels, and devices seamlessly.

__CAPGO_KEEP_0__

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

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

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

  2. 統計表示: 重要なメトリクスを視覚化します (データは請求日からではなく、1 月 1 日から反映されます):

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

  3. 概要カード: 主な数値の簡単な概要を提供します。

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

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

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

アプリ情報

__CAPGO_KEEP_0__

このセクションは、上部のナビゲーションバーの「情報」タブ (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): この機能を有効にすると、Capacitor Updater プラグインにバンドルリンクとコメントのフィールドが送信されます。この機能は、プラグインバージョン 7.35.0 以上が必要です。
  • Transfer App Ownership (9): このセクションでは、別の組織にアプリケーションの所有権を移行するオプションが提供されます。
  • Delete App Button: このアプリケーションをCapgoから永久に削除します。このアクションは不可逆であり、すべての関連データ、バンドル、チャネル、デバイスを削除します。
  • 更新ボタン: このページの編集可能フィールド（例：アプリ名、デフォルトアップロードチャネル、自動削除バンドル設定）にしたがって保存します。

デフォルトチャネル設定

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

The デフォルトダウンロードチャネル は、アプリの重要な設定の1つです。新しいデバイスがCapgoに初めて接続したときに、どのチャネルからアップデートを受け取るかを決定します。

デフォルトチャネルについて

セクション「デフォルトチャネルについて」

デバイスがCapgoからアップデートを要求したとき、システムは次の順序に従ってどのチャネルを使用するかを決定します。

  1. 強制デバイスマッピング: __CAPGO_KEEP_0__ が明示的にチャンネル設定で強制されている場合、そのチャンネルは常に勝つ。
  2. Cloud override: __CAPGO_KEEP_0__ がチャンネルを通じて割り当てられた場合、またはダッシュボードで手動で割り当てられた場合、そのオーバーライドが使用されます。 setChannel() __CAPGO_KEEP_0__ config
  3. : Capacitor があなたの defaultChannelファイルに設定されている場合、この値はテスト/ベータビルド用に使用されます。 capacitor.config.* Default Download Channel
  4. : この設定がここで構成されている場合—この設定はあなたの ~99% のプロダクションユーザーが使用するものです。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:

例えば、iOS用、Android用、Electron用のデフォルトチャンネルをそれぞれ設定できます。この設定は、以下のようなシナリオで便利です。

  • 1つのプラットフォームよりも他のプラットフォームでアップデートを展開したい
  • 各プラットフォームごとに異なるアップデート戦略が必要
  • 1つのプラットフォームで新しいバージョンをテストしている間、他のプラットフォームは安定している

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

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

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

  • iOS デバイスは、iOS を有効にしたデフォルト チャンネルからアップデートを受信します
  • Android デバイスは、Android を有効にしたデフォルト チャンネルからアップデートを受信します
「デフォルトのシングルチャネル（ほとんどのアプリケーション向けに推奨）」

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

  1. Create one channel (e.g., production)
  2. __CAPGO_KEEP_0__
  3. iOS、Android、および Electron のタグが有効になっていることを確認する

デフォルトのチャネルとしてマークする

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

デフォルトのチャネルを変更する

デフォルトのチャネルを変更すると:

  • 新しいデバイス 新しいデフォルトから即座に更新を受け始める
  • 既存のデバイス __CAPGO_KEEP_0__ ( __CAPGO_KEEP_0__ で既にチャネル割り当てが設定されている場合は自動的に切り替わらないことに注意してください)
  • 既存のデバイスを移動するには、以下のいずれかを行う必要があります:
    • Use setChannel() プログラムでオーバーライドする
    • Force them to the new channel in the dashboard
    • デバイスのエントリを削除する (新しいデフォルトで再登録する)

Tip: 小規模なデバイスグループで新しいデフォルトチャネルをテストすることをお勧めします。