Firebase Remote Config を使用して、アプリでパラメーターを定義し、クラウドでその値を更新して、アプリの更新を配布せずにアプリの外観と動作を変更できます。
Remote Config ライブラリは、アプリ内のデフォルト パラメータ値を保存し、Remote Config バックエンドから更新されたパラメータ値を取得し、取得した値をアプリでいつ利用できるようにするかを制御するために使用されます。詳細については、 Remote Config の読み込み戦略を参照してください。
ステップ 1: アプリに Firebase を追加する
Remote Configを使用する前に、次のことを行う必要があります。
C++ プロジェクトを登録し、Firebase を使用するように構成します。
C++ プロジェクトですでに Firebase を使用している場合は、Firebase 用に登録および構成されています。
Firebase C++ SDKを C++ プロジェクトに追加します。
Firebase を C++ プロジェクトに追加するには、 Firebase コンソールと開いている C++ プロジェクトの両方でタスクが必要になることに注意してください (たとえば、コンソールから Firebase 構成ファイルをダウンロードして、それらを C++ プロジェクトに移動します)。
ステップ 2: アプリに Remote Config を追加する
アンドロイド
アプリに Firebase を追加した後:
Firebase アプリを作成し、JNI 環境とアクティビティを渡します:
app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
次のように、Remote Config ライブラリを初期化します。
::firebase::remote_config::Initialize(app);
iOS+
アプリに Firebase を追加した後:
Firebase アプリを作成します:
app = ::firebase::App::Create(::firebase::AppOptions());
次のように、Remote Config ライブラリを初期化します。
::firebase::remote_config::Initialize(app);
ステップ 3: アプリ内のデフォルト パラメータ値を設定する
Remote Config オブジェクトにアプリ内の既定のパラメーター値を設定して、Remote Config バックエンドに接続する前にアプリが意図したとおりに動作し、バックエンドに何も設定されていない場合に既定値を使用できるようにすることができます。
std::map<const char*, const char*>
オブジェクトまたはstd::map<const char*, firebase::Variant>
オブジェクトを使用して、パラメーター名のセットとデフォルトのパラメーター値を定義します。-
firebase::Variant
について学びます。
Remote Config バックエンド パラメータ値をすでに設定している場合は、これらのキーと値のペアを含むファイルをダウンロードし、それを使用して
map
オブジェクトを作成できます。詳細については、「 Remote Config テンプレートのデフォルトをダウンロードする」を参照してください。-
SetDefaults()
を使用して、これらの値を Remote Config オブジェクトに追加します。
ステップ 4: アプリで使用するパラメーター値を取得する
これで、Remote Config オブジェクトからパラメーター値を取得できます。 Remote Config バックエンドで値を設定し、フェッチしてからアクティブ化すると、それらの値をアプリで使用できます。それ以外の場合は、 SetDefaults()
を使用して構成されたアプリ内パラメーター値を取得します。
これらの値を取得するには、パラメーター キーを引数として指定して、アプリが期待するデータ型にマップする以下のメソッドを呼び出します。
ステップ 5: Firebase コンソールでアプリを接続する
Firebase コンソールで、アプリを Firebase プロジェクトに追加します。
ステップ 6: パラメータ値を設定する
- Firebase コンソールで、プロジェクトを開きます。
- メニューから [ Remote Config ] を選択して、Remote Config ダッシュボードを表示します。
- アプリで定義したパラメーターと同じ名前のパラメーターを定義します。パラメータごとに、デフォルト値 (最終的にはアプリ内デフォルト値を上書きします) と条件値を設定できます。詳しくは、 Remote Config のパラメーターと条件をご覧ください。
ステップ 7: 値を取得してアクティブ化する
- Remote Config バックエンドからパラメータ値をフェッチするには、
Fetch()
メソッドを呼び出します。バックエンドで設定した値はすべて取得され、Remote Config オブジェクトにキャッシュされます。 - 取得したパラメーター値をアプリで使用できるようにするには、
ActivateFetched()
を呼び出します。
次のステップ
If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: