Skip to content

アプリページ

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

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

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

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

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

    • ダッシュボード: アプリのメトリックとサマリーを表示します。
    • 観察 (beta): Native launch, WebView, issue, and release-health signals.
    • 情報: Core app settings and details (see アプリ情報).
    • バンドル: バージョンとリリース。
    • チャンネル: アップデートチャンネルと進歩的なロールアウトのコントロール。
    • デバイス: 登録済みデバイスとオーバーライド。
    • ログ: ログインサイト ログとログの原文.
    • ビルド: ネイティブビルド管理.
  2. 統計表示: 重要なメトリクスを視覚化します。 最近の請求期間 (データは請求日からではなく、月初日から反映されます):

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

    • バンドルアップロード (12): アップロードされたアプリケーションバンドルの総数。
    • アップデート統計 (13): アップデートの総数、リクエスト、インストール、失敗を含みます。
    • デプロイ統計 (14): デプロイの総数。
  4. 表示オプション (15-18): 統計をフィルタリングおよび表示するための制御です。

    • 毎日 (15): 毎日ベースで統計を表示する。
    • 累積 (16): 過去の累積統計を表示する。
    • 請求期間 (17): 現在の請求期間の統計を表示する。
    • 日付範囲 (18): カスタムの日付範囲を選択する (例: 最近の 30 日)。

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

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

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

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

  • アプリアイコン (2): アプリのアイコンを表示します。 "変更" ボタンをクリックして新しいアイコンをアップロードできます。
  • アプリID (3): Capgo 内のアプリケーションに対する一意の識別子です。このIDは編集できません。
  • アプリ名 (4): アプリケーションの表示名です。この名を必要に応じて変更できます。
  • デフォルトアップロードチャネル (5): 新しいバンドルをアップロードするデフォルトのチャネルを指定します。編集アイコンをクリックしてデフォルトのチャネルを選択できます。
  • デフォルトダウンロードチャネル (6): デフォルトのチャネルを指定します。デバイスはこのチャネルからアップデートをダウンロードします。エディットアイコンをクリックして、別のデフォルトチャネルを選択できます。チャネルページではデフォルトチャネルかどうかが表示されますが、ここで変更します。チャネルを開いてクリックしてください。 アプリ内設定で管理 詳細情報は下記の デフォルトチャネル設定 セクションでご覧ください。
  • 使用されていないバンドルを自動的に削除 (秒数) (7): この設定では、指定された時間 (秒数) 以上使用されていない古いバンドルを自動的に削除できます。削除を無効にするには 0 を設定します。これにより、ストレージを管理し、バンドルリストを綺麗に保つことができます。
  • プラグインにバンドルメタデータを公開 (8): 有効にすると、バンドルリンクとコメントフィールドがCapacitor Updater プラグインに送信されます。この機能は、プラグインバージョン 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 からアップデートを要求された際、デバイスは以下の優先順位に基づいてどのチャンネルを使用するかを決定します (優先順位が高い順):

  1. 強制的なデバイスマッピング: デバイスIDがチャンネル設定で明示的に強制的にチャンネルに割り当てられている場合、そのチャンネルは常に勝ちます。
  2. クラウドオーバーライド: デバイスがダッシュボードまたは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. __CAPGO_KEEP_0__
  3. On アプリ情報、それぞれのプラットフォームに対して、デフォルトのダウンロードチャネルとして設定します。Capgoは、チャンネルが異なるプラットフォームを対象としている場合に、複数のデフォルトを許可します。

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

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

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

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

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

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

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

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

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

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

アプリページから続ける

アプリページから続ける

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