Skip to content
Capgo - Live Updates for Capacitor Apps Capgo

App Page

アプリページは何を表示しますか?

「アプリページは何を表示しますか?」と題されたセクション

まず、アプリのメインページを見てみましょう:

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

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

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

  1. 上部ナビゲーションバー: メインアプリ管理ビューへのアクセスを提供します。スクリーンショットはイラストレーションです。現在のコンソールには以下が含まれます:

    • ダッシュボード: アプリのメトリクスとサマリーを表示します。
    • Observe (beta): Native launch, WebView, issue, and release-health signals.
    • 情報: Core app settings and details (see App Information).
    • バンドル: バージョンとリリース。
    • チャンネル: アップデートチャンネルと進歩的なロールアウトのコントロール。
    • デバイス: 登録済みデバイスとオーバーライド。
    • ログ: ログインサイト とロギングデータ。
    • ビルド: ネイティブビルド管理。

  2. 統計表示: 重要なメトリクスを視覚化します。 最近の請求期間 (請求日からではなく、月初から) のデータを反映します:

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

  3. 概要カード: 重要な数値の概要を簡単に表示します。

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

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

    • Daily (15): 毎日 (15)の統計を確認する。
    • Cumulative (16): 累積 (16)統計を確認する。
    • Billing Period (17): 現在の請求期間の統計を確認する。
    • Date Range (18): 任意の日付範囲 (例：過去 30 日間) を選択する。

App Information

アプリケーション情報

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

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

スクリーンショットは現在のコンソールよりも古く、すべての現在の設定を表示していません。以下のフィールドの説明を真実の元として使用してください。

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

  • アプリケーションアイコン (2): アプリケーションのアイコンを表示します。 "変更" ボタンをクリックして新しいアイコンをアップロードできます。
  • アプリケーションID (3): Capgo 内のアプリケーションの一意の識別子です。この ID は編集できません。
  • アプリケーション名 (4): アプリケーションの表示名です。この名を必要に応じて変更できます。
  • デフォルトアップロードチャネル (5): 新しいバンドルがアップロードされるデフォルトのチャネルを指定します。編集アイコンをクリックして別のデフォルトのチャネルを選択できます。
  • デフォルトダウンロードチャネル (6): デフォルトのチャネルを指定します。デバイスはこのチャネルからアップデートをダウンロードします。エディットアイコンをクリックして、別のデフォルトチャネルを選択できます。チャネルページでは、チャネルがデフォルトかどうかは表示されますが、ここで変更します。チャネルを開いてクリック アプリ内設定を管理 このフィールドにジャンプするには、チャネルを開いてクリック 詳細情報については、以下の デフォルトチャネル設定
  • セクションを参照してください。 使用されていないバンドルを自動削除 (秒数) (7): 0 この設定では、指定された時間 (秒数) 以上使用されていない古いバンドルを自動的に削除できます。
  • を設定すると、自動削除を無効にします。この設定は、ストレージを管理し、バンドルリストを綺麗に保つのに役立ちます。 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.
  • 有効にすると、バンドルリンクとコメントフィールドが__CAPGO_KEEP_0__のアップデートプラグインに送信されます。この機能は、プラグインバージョン 7.35.0 以上が必要です。 ブロックプロバイダーのインフラストラクチャリクエスト:」、」Capgoは、GoogleとAppleのデータセンターIP範囲から知られているアップデート、統計、チャネル自体のリクエストを拒否します。通常の生産トラフィックの場合に有効にすると良いでしょう。プロバイダーのインフラストラクチャから意図的にテストする場合にのみ、有効を無効にします。新しいアプリでは、この保護をデフォルトで有効にします。既存のアプリでは、変更するまで、前の無効の設定を保持します。
  • アプリの所有権を移転 (9): このセクションでは、アプリを別の組織に移転するオプションを提供します。
  • アプリ削除ボタン: Capgo からアプリを永久に削除します。このアクションは不可逆であり、すべての関連データ、バンドル、チャネル、デバイスを削除します。
  • 更新ボタン: このページの編集可能フィールド (例: アプリ名、デフォルトアップロードチャネル、自動削除バンドル設定) に変更した内容を保存します。

デフォルトチャネル設定

「デフォルトチャネル設定」

デフォルトダウンロードチャネル アプリの設定の重要な要素です。新しいデバイスが __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__ は Capgo の略称です。

「デフォルトチャンネルのしくみ」

Capgoからアップデートを要求された際、デバイスは以下の優先順位に基づいてどのチャンネルを使用するかを決定します。

  1. 強制デバイスマッピング: デバイスIDがチャンネル設定で明示的に強制されている場合、そのチャンネルは常に優先されます。
  2. Cloudオーバーライド: デバイスがダッシュボードまたはPublic APIから割り当てられている場合、そのオーバーライドが使用されます。
  3. プラグイン setChannel(): プラグインの現在のバージョンでは、これはローカル割り当てであり、ダッシュボードオーバーライドではありません。詳しくは 「デバイスがどのチャンネルを選択するか」.
  4. Capacitorの設定 defaultChannel: ご自身の capacitor.config.* ファイルに設定されている場合、テスト/ベータビルドのために使用されます。
  5. デフォルトのダウンロードチャネル:ここで設定された設定です。この設定は、99%のプロダクションユーザーが使用するものです。

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

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

プラットフォーム固有のデフォルトチャネルを設定できます。例えば、iOS用、Android用、Electron用のそれぞれのチャネルを作成できます。この設定は、以下の場合に便利です。

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

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

  1. 各プラットフォームごとに別々のチャネルを作成します。 production-ios, production-android各チャネルの設定で、関連するプラットフォーム (iOS、Android、またはElectron) のスイッチを有効にします。 production-electron)
  2. Create separate channels for each platform (for example iOS, Android, and Electron.)
  3. On アプリ情報、それぞれのチャネルを、そのプラットフォームのデフォルトダウンロードチャネルとして設定します。Capgoは、チャネルが異なるプラットフォームを対象としている場合に、複数のデフォルトを許可します。

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

  • iOSデバイスは、iOSを有効化したデフォルトチャネルからアップデートを受け取ります。
  • Androidデバイスは、Androidを有効化したデフォルトチャネルからアップデートを受け取ります。
セクション「1つのデフォルトチャネル (推奨:ほとんどのアプリ用)」

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

  1. 1つのチャネルを作成します (例:) production)
  2. iOS、Android、Electronのスイッチが有効になっていることを確認します。
  3. デフォルトダウンロードチャネルとして設定します。 アプリ情報

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

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

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

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

  • 新規のデバイス 新しいデフォルトから即座にアップデートを受信します。
  • 既存のデバイス 既存のデバイスは、overrideまたはforceによるチャンネル割り当てがある場合、自動的に切り替わりません。
  • 既存のデバイスを移動するには、次のいずれかを行う必要があります。
    • 使用 setChannel() (または unsetChannel()アプリから削除します。バックエンドデバイスのレコードを削除してもローカル setChannel() 割り当ては消えません。
    • ダッシュボード（コンソール/APIオーバーライド；90日間有効）で新しいチャンネルに強制します。
    • コンソール/APIオーバーライドを削除して、順序の優先度に従うようにします。Cloudflareのデフォルトのみのデバイスは、新しいデフォルトを取得します。

ヒント: 小規模なグループの強制デバイスで新しいデフォルトチャンネルをテストすることをお勧めします。すべてのユーザーにデフォルトを設定する前に。

アプリページから続ける

アプリページから続ける

アプリページを使用している場合 アプリページ ダッシュボードとAPIの操作を計画するには、APIオーバービューと接続する必要があります。 APIオーバービュー APIの実装詳細については、 概要 __CAPGO_KEEP_0__の実装詳細については概要 APIのキー APIの実装詳細についてはAPIのキー デバイス __CAPGO_KEEP_0__の実装詳細についてはデバイス、 バンドル __CAPGO_KEEP_0__の実装詳細についてはバンドル