メインコンテンツへスキップ
Capgo - Capacitor アプリのビルド、リリース、アップデート Capgo

アプリページ

アプリページには何が表示されますか？

「アプリページに何が表示されるか」セクション

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

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

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

詳しく見ていきましょう。メインアプリページは、いくつかの主要なエリアに分かれています。

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

    • ダッシュボード: アプリのメトリクスとサマリー。
    • Observe (beta): ネイティブ起動、WebView、イシュー、リリースヘルスに関するシグナル。
    • 情報: アプリのコア設定と詳細（以下を参照 アプリ情報).
    • Bundle: バージョンとリリース
    • チャンネル: アップデートチャネルと段階的ロールアウト制御
    • デバイス: 登録済みデバイスとオーバーライド
    • ログ: ログ分析 およびrawログ
    • ビルド: Native Buildの管理

  2. 統計表示: 直近の請求期間の重要なメトリクスを可視化します（データは請求日から集計され、月の初日ではありません）：

    • 月間アクティブユーザー（8）： 時間経過に伴うユニークアクティブユーザー数を追跡します。
    • ストレージ（9）： 現在のストレージ使用量を表示します。
    • 帯域幅（10）： 帯域幅の使用量を表示します。
    • アクティブなBundle（11）： 異なるアプリBundle間のアクティブデバイスの分布を表示します。

  3. サマリーカード： 主要な数値の概要をすばやく確認できます:

    • Bundle アップロード (12): アップロードされたアプリの Bundle 総数。
    • 更新統計 (13): リクエスト、インストール、失敗を含む、実行された更新の総数。
    • デプロイ統計 (14): デプロイの総数。

  4. 表示オプション (15-18): 統計のフィルタリングと表示を制御します:

    • 日別 (15): 統計を日単位で表示します。
    • 累積 (16): 累積統計を時系列で表示します。
    • 請求期間 (17): 現在の請求期間の統計を表示します。
    • 日付範囲 (18): カスタムの日付範囲を選択します（例: 過去30日間）。

アプリ情報

セクション「App Information」

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

App Information ページ
App Information ページ

スクリーンショットは現在のコンソールより古く、最新の設定がすべて表示されているわけではありません。以下のフィールド説明を正としてください。

利用可能なフィールドとアクションの内訳は次のとおりです:

  • アプリアイコン (2): アプリのアイコンを表示します。「変更」ボタンをクリックすると、新しいアイコンをアップロードできます。
  • App ID (3): Capgo 内でアプリケーションを一意に識別する ID です。この ID は編集できません。
  • アプリ名 (4): アプリケーションの表示名です。必要に応じて変更できます。
  • デフォルトのアップロードチャネル (5): 新しい bundle がアップロードされるデフォルトのチャネルを指定します。編集アイコンをクリックして、別のデフォルトチャネルを選択できます。
  • デフォルトのダウンロードチャネル (6): デバイスがアップデートをダウンロードするデフォルトのチャネルを指定します。編集アイコンをクリックして、別のデフォルトチャネルを選択できます。チャネルページでは、そのチャネルがデフォルトかどうかを確認できますが、変更はここで行います。チャネル上のトグルでは変更できません。チャネルを開いて App設定で管理するには をクリックすると、このフィールドにジャンプします。次を参照してください: デフォルトチャネルの設定 詳細な情報は以下のセクションを参照してください。
  • 未使用バンドルの自動削除（x秒後）（7）: この設定により、指定された時間（秒）使用されなかった古いバンドルを自動的に削除できます。 0 に設定すると自動削除を無効にします。これによりストレージを管理し、バンドルリストを整理整頓できます。
  • プラグインへのバンドルメタデータ公開（8）: 有効にすると、バンドルリンクとコメントフィールドが Capacitor Updater プラグインに送信されます。この機能にはプラグインバージョン 7.35.0 以上が必要です。
  • プロバイダーインフラからのリクエストをブロック: 有効にすると、Capgo は既知の Google および Apple データセンター IP 範囲からの更新、統計、チャネル自己リクエストを拒否します。通常の本番トラフィックでは有効のままにしてください。プロバイダーインフラから意図的にテストする場合にのみ、一時的に無効にしてください。新規アプリではこの保護がデフォルトで有効ですが、既存アプリは設定を変更するまで以前の無効設定が維持されます。
  • アプリ所有権の移管（9）: このセクションでは、アプリを自分が所属する別の組織に移管するオプションを提供します。
  • アプリ削除ボタン: Capgo からアプリケーションを完全に削除します。この操作は元に戻せません。関連するすべてのデータ、バンドル、チャネル、デバイスが削除されます。
  • Update ボタン: このページの編集可能なフィールド（例: App Name、Default Upload Channel、Auto Delete Bundles 設定）に行った変更を保存します。

デフォルトチャネルの設定

「Default Channel Configuration」セクション

この デフォルトのダウンロードチャネル はアプリにとって最も重要な設定の一つです。デバイスが初めて Capgo に接続した際に、どのチャネルから更新を受信するかを決定します。

デフォルトチャネルの仕組み

「Default Channels の仕組み」セクション

デバイスが Capgo に更新をリクエストすると、システムは以下の優先順位（優先度が高い順）に基づいて使用するチャネルを決定します:

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

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

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

プラットフォーム固有のデフォルトチャネルを設定できます。例えば、iOS用、Android用、Electron用をそれぞれ1つずつ設定できます。これは以下のような場合に役立ちます。

  • あるプラットフォームにのみ、他のプラットフォームより先にアップデートをロールアウトしたい場合
  • プラットフォームごとに異なるアップデート戦略が必要な場合
  • あるプラットフォームで新しいバージョンをテストしながら、もう一方のプラットフォームを安定した状態に保ちたい場合

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

  1. 各プラットフォーム用に個別のチャネルを作成します（例えば production-ios, production-androidや production-electron)
  2. 各チャネルの設定で、該当するプラットフォーム（iOS、Android、またはElectronのトグル）のみを有効にします
  3. オンラインに アプリ情報、そしてそれらのチャネルを各プラットフォームのデフォルトダウンロードチャネルとして設定します。Capgo は、チャネルが異なるプラットフォームを対象としている場合、複数のデフォルトを許可します。

デバイスが更新をリクエストしたとき:

  • iOS デバイスは、iOS 対応のデフォルトチャネルから更新を受信します
  • Android デバイスは、Android 対応のデフォルトチャネルから更新を受信します
セクション「単一のデフォルトチャネル（ほとんどのアプリに推奨）」

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

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

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

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

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

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

  • 新しいデバイス は、新しいデフォルトチャネルからすぐに更新を受け取り始めます
  • 既存のデバイス すでにチャネルが割り当てられているもの（override または force 経由）は、自動的に切り替わりません
  • 既存のデバイスを移動するには、次のいずれかが必要です：
    • 使用する setChannel() (または unsetChannel()) アプリから削除します。バックエンドのデバイスレコードを削除しても、ローカルの setChannel() 割り当てはクリアされません。
    • ダッシュボードで新しいチャネルに強制移動します（console/API override、90日後に失効）
    • コンソール/API のオーバーライドを削除して、優先順位に従ってフォールバックさせます。クラウドのデフォルトだけを持つデバイスは、その後新しいデフォルトを取得します。

ヒント: 全ユーザーにデフォルト設定する前に、少数のデバイスを強制的に新デフォルトチャネルへ切り替えて必ずテストしてください。

App Pageから続ける

「App Pageから続ける」というセクション

使用している場合 アプリページ ダッシュボードと API の運用を計画するには、これを次と連携させます API の概要 「API の概要」の実装の詳細については、 はじめに 「はじめに」における実装の詳細については、 API キー API Keys の実装の詳細については、 デバイス Devices の実装詳細については、および Bundle Bundlesの実装詳細については