mcpField
F
firebase-remote-config-basics

firebase-remote-config-basics

github.com/firebaseクラウド・DevOps491122.5k 回インストール1 日前に更新
リポジトリ

firebase-remote-config-basics について

Android と iOS アプリで Firebase Remote Config を設定するためのスキルガイドです。SDK の設定や値の取得方法、CLI によるテンプレート管理を扱い、デプロイ前のユーザー確認を含みます。

主な機能

  1. 01Android と iOS の設定ガイド
  2. 02取得と有効化の方法
  3. 03リアルタイム設定更新
  4. 04CLI によるテンプレート編集とデプロイ
  5. 05バージョン履歴の確認

活用シーン

  1. 01アプリへの Remote Config 導入
  2. 02値を取得・有効化するタイミングの選択
  3. 03デプロイ前のテンプレート変更確認
  4. 04デプロイ済みテンプレートのバージョン確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/firebase/agent-skills --skill firebase-remote-config-basics

インストール後、Claude Code で/firebase-remote-config-basicsを入力して読み込まれたか確認します。

同梱ファイルreferences/android_setup.mdreferences/ios_setup.md

詳細

Remote Config

このスキルでは、Android または iOS で Remote Config を始めるための完全なガイドを提供します。Remote Config を使用すると、クラウドベースの設定テンプレートを管理することで、アプリのアップデートを公開せずにアプリの動作や外観を変更できます。

前提条件

Remote Config をプロビジョニングするには、Firebase プロジェクトと、Android または iOS の Firebase アプリの両方が必要です。コマンドラインから Remote Config のテンプレートと条件を管理するには、Firebase CLI を使用します。プロジェクトの初期化については、firebase-basics スキルを参照してください。

実行時のトラブルシューティング

npx 403 Forbidden エラーへの対処

レジストリのアクセス許可が原因で npx -y firebase-tools@latest が失敗する場合（403 エラー）：

  1. ユーザーに伝える：「レジストリのエラーにより、npx 経由で最新の Firebase ツールを取得できません。」
  2. 代替手段：ユーザーがグローバルにインストール済みであること（npm install -g firebase-tools）を確認した場合は、ローカルの firebase コマンドを直接使用します。
プロジェクトコンテキストの問題への対処

「有効なプロジェクトが選択されていません」という理由でコマンドが失敗する場合：

  1. ログインを確認：npx -y firebase-tools@latest login:list を実行します。
  2. ID を尋ねる：ログイン済みでも有効なプロジェクトがない場合は、ユーザーに次のように尋ねます。 「続行するには、Firebase プロジェクト ID を指定してください。」
  3. フラグを使用：以降の各コマンドに --project <PROJECT_ID> を追加します。

SDK のセットアップ

アプリケーションコードで Remote Config を設定する方法については、プラットフォームを選択してください。

ベストプラクティスとテンプレート管理

Remote Config を効率的かつ安全に使用できるよう、以下のガイドラインに従い、関連する CLI ツールを使用してください。

取得方法

アプリのパフォーマンスとユーザーエクスペリエンスを最適化するには、以下の推奨パターンに従ってください（ 読み込み方法を参照）。

  • 次回起動時に新しい値を読み込む：最も効果的なパターンは、起動時に取得済みの値をすぐに有効化し、新しい値をバックグラウンドで取得して次回に使用することです。これにより、ユーザーの待ち時間を最小限に抑えられます。
  • リアルタイム更新：サーバー側の設定が変更されたときに、リフレッシュせずにアプリをすぐに更新するには、SDK のリアルタイムリスナーを使用します。
CLI によるテンプレート管理

次のコマンドを使用して、リモート設定テンプレートとバージョン履歴を ターミナルから管理します。

  • 現在のテンプレートを取得：監査や変更のために、リモートテンプレートをローカルの JSON ファイルに保存します。

    npx -y firebase-tools@latest remoteconfig:get -o remote_config.json

  • 自律的な編集と検出：ローカルの remote_config.json を直接変更します。適切なシグナル（例：device.country や percent）を特定し、 それに応じて「conditions」配列と「parameters」マップを更新します。

  • 必須：ユーザーによるレビューと確認：デプロイに進む前に、必ず停止して ユーザーに変更を確認してもらいます。

    • アクション：ユーザーに次のように伝えます。「remote_config.json に変更を準備しました。 正確性を確認するため、ファイルをレビューしてください。問題がなければ、 変更を反映するために「deploy」と指示してください。」

  • デプロイの調整：変更をプッシュするには、デプロイ用に環境が設定されていることを確認する必要があります。

    • 設定のマッピング：firebase.json ファイルがない場合は、ローカルの JSON を Remote Config サービスにマッピングするために作成します。
      { "remoteconfig": { "template": "remote_config.json" } }

    • デプロイ：部分デプロイコマンドを実行します。

      npx -y firebase-tools@latest deploy --only remoteconfig

  • 確認：デプロイ後、バージョン履歴を一覧表示して更新を確認します。

    npx -y firebase-tools@latest remoteconfig:versions:list

SDK には、アプリケーションを動的にし、ユーザーセグメントに応じて 柔軟に対応させるための機能が多数用意されています。

  • アプリ内のデフォルト値を設定：オフライン時や初回取得前でもアプリが動作するよう、基準値を定義します。
  • 取得して有効化：Firebase バックエンドから値を取得し、ローカルの UI／ロジックに適用します。
  • テンプレート管理：Firebase CLI を使用して、設定 JSON ファイルのバージョン管理、取得、デプロイを行います。

コメント

Markdown 対応