Erste Schritte mit Firebase Remote Config

iOS+ Android Web Flutter Unity C++

Wichtig :In diesem Abschnitt wird beschrieben, wie du Remote Config mit mobilen und Webclients konfigurierst. Informationen zu Serverumgebungen finden Sie unter Remote Config in Serverumgebungen verwenden.

Mit Firebase Remote Config können Sie Parameter in Ihrer App definieren und ihre Werte in der Cloud aktualisieren. So können Sie das Erscheinungsbild und das Verhalten Ihrer App ändern, ohne ein App-Update bereitzustellen.

Mit der Remote Config-Bibliothek werden In-App-Standardparameterwerte gespeichert, aktualisierte Parameterwerte aus dem Remote Config-Backend abgerufen und gesteuert, wann abgerufene Werte für Ihre App verfügbar gemacht werden. Weitere Informationen finden Sie unter Remote Config-Ladestrategien.

Schritt 1: Firebase zu Ihrer App hinzufügen

Bevor Sie Remote Config verwenden können, müssen Sie Folgendes tun:

• Registrieren Sie Ihr C++-Projekt und konfigurieren Sie es für die Verwendung von Firebase.

  Wenn in Ihrem C++-Projekt bereits Firebase verwendet wird, ist es bereits für Firebase registriert und konfiguriert.

• Fügen Sie Ihrem C++-Projekt das Firebase C++ SDK hinzu.

Eine detaillierte Anleitung für diese ersten Einrichtungsaufgaben finden Sie unter Firebase zu einem C++-Projekt hinzufügen.

Das Hinzufügen von Firebase zu Ihrem C++-Projekt umfasst Aufgaben sowohl in der Firebase Console als auch in Ihrem geöffneten C++-Projekt. Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Console herunter und verschieben sie dann in Ihr C++-Projekt.

Schritt 2: Remote Config zur App hinzufügen

Android

Nachdem Sie Firebase Ihrer App hinzugefügt haben, gehen Sie so vor:

1. Erstellen Sie eine Firebase App und geben Sie die JNI-Umgebung und die Aktivität an:

   app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

2. Initialisieren Sie die Remote Config-Bibliothek wie hier gezeigt:

   ::firebase::remote_config::Initialize(app);

iOS+

Nachdem Sie Firebase Ihrer App hinzugefügt haben, gehen Sie so vor:

1. So erstellen Sie eine Firebase App:

   app = ::firebase::App::Create(::firebase::AppOptions());

2. Initialisieren Sie die Remote Config-Bibliothek wie hier gezeigt:

   ::firebase::remote_config::Initialize(app);

Schritt 3: In-App-Standardparameterwerte festlegen

Sie können im Remote Config-Objekt In-App-Standardparameterwerte festlegen, damit sich Ihre App wie vorgesehen verhält, bevor eine Verbindung zum Remote Config-Backend hergestellt wird. Außerdem sind dann Standardwerte verfügbar, falls im Backend keine festgelegt sind.

Wichtig: Speichern Sie keine vertraulichen Daten in Remote Config-Parameterschlüsseln oder ‑werten. Remote Config-Daten werden während der Übertragung verschlüsselt, aber Endnutzer können auf alle Standard- oder abgerufenen Remote Config-Parameter zugreifen, die für ihre Client-App-Instanz verfügbar sind.

1. Definieren Sie eine Reihe von Parameternamen und Standardparameterwerten mit einem ConfigKeyValue*-Objekt oder einem ConfigKeyValueVariant*-Objekt mit der Größe des Arrays.

   Wenn Sie bereits Remote Config-Backendparameterwerte konfiguriert haben, können Sie eine Datei mit diesen Schlüssel/Wert-Paaren herunterladen und damit Ihr map-Objekt erstellen. Weitere Informationen finden Sie unter Remote Config-Standardvorlagen herunterladen.

2. Fügen Sie diese Werte dem Remote Config-Objekt mit SetDefaults() hinzu.

Schritt 4: Parameterwerte für die Verwendung in Ihrer App abrufen

Sie können jetzt Parameterwerte aus dem Remote Config-Objekt abrufen. Wenn Sie Werte im Remote Config-Backend festgelegt, abgerufen und dann aktiviert haben, sind diese Werte für Ihre App verfügbar. Andernfalls werden die In-App-Parameterwerte verwendet, die mit SetDefaults() konfiguriert wurden.

Rufen Sie dazu die unten aufgeführte Methode auf, die dem von Ihrer App erwarteten Datentyp zugeordnet ist, und geben Sie den Parameterschlüssel als Argument an:

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

Schritt 5: Parameterwerte festlegen

1. Öffnen Sie in der Firebase Console Ihr Projekt.
2. Wählen Sie im Menü Remote Config aus, um das Remote Config-Dashboard aufzurufen.
3. Definieren Sie Parameter mit denselben Namen wie die Parameter in Ihrer App. Sie können für jeden Parameter einen Standardwert und bedingte Werte festlegen, die den In-App-Standardwert überschreiben. Weitere Informationen finden Sie unter Remote Config-Parameter und -Bedingungen.

Schritt 6: Werte abrufen und aktivieren

1. Wenn du Parameterwerte aus dem Remote Config-Backend abrufen möchtest, rufe die Methode Fetch() auf. Alle Werte, die Sie im Backend festlegen, werden abgerufen und im Remote Config-Objekt im Cache gespeichert.
2. Wenn Sie abgerufene Parameterwerte für Ihre App verfügbar machen möchten, rufen Sie ActivateFetched() auf.

Schritt 7: In Echtzeit nach Updates suchen

Nachdem Sie Parameterwerte abgerufen haben, können Sie mit Remote Config in Echtzeit auf Aktualisierungen vom Remote Config-Backend warten. Remote Config signalisiert verbundenen Geräten in Echtzeit, wenn Updates verfügbar sind, und ruft die Änderungen automatisch ab, nachdem Sie eine neue Remote Config-Version veröffentlicht haben.

Echtzeitaktualisierungen werden vom Firebase C++ SDK Version 11.0.0 und höher für Android- und Apple-Plattformen unterstützt.

Wichtig:Für Echtzeit-Remote Config ist auch die Firebase Remote Config-Realtime API erforderlich, die bereits für Sie aktiviert sein sollte. Öffnen Sie dazu die Google Cloud Console, wählen Sie Ihr Projekt aus und öffnen Sie die Seite APIs und Dienste. Die API sollte als aktiviert angezeigt werden. Wenn sie fehlt oder nicht aktiviert ist, klicken Sie auf APIs & Dienste aktivieren, suchen Sie nach Firebase Remote Config Realtime API und aktivieren Sie sie.

1. Rufen Sie in Ihrer App AddOnConfigUpdateListener auf, um nach Updates zu suchen und neue oder aktualisierte Parameterwerte automatisch abzurufen. Im folgenden Beispiel wird auf Aktualisierungen gewartet. Wenn Activate aufgerufen wird, werden die neu abgerufenen Werte verwendet, um eine aktualisierte Begrüßungsnachricht anzuzeigen.

remote_config->AddOnConfigUpdateListener(
    [](firebase::remote_config::ConfigUpdate&& config_update,
       firebase::remote_config::RemoteConfigError remote_config_error) {
      if (remote_config_error != firebase::remote_config::kRemoteConfigErrorNone) {
        printf("Error listening for config updates: %d", remote_config_error);
      }
      // Search the `updated_keys` set for the key "welcome_message."
      // `updated_keys` represents the keys that have changed since the last
      // fetch.
      if (std::find(config_update.updated_keys.begin(),
                    config_update.updated_keys.end(),
                    "welcome_message") != config_update.updated_keys.end()) {
        remote_config->Activate().OnCompletion(
            [&](const firebase::Future& completed_future,
               void* user_data) {
              // The key "welcome_message" was found within `updated_keys` and
              // can be activated.
              if (completed_future.error() == 0) {
                DisplayWelcomeMessage();
              } else {
                printf("Error activating config: %d", completed_future.error());
              }
            },
            nullptr);
      }
    });

Wenn Sie das nächste Mal eine neue Version Ihrer Remote Config veröffentlichen, rufen Geräte, auf denen Ihre App ausgeführt wird und die auf Änderungen warten, den ConfigUpdate-Listener auf.

Nächste Schritte

Sehen Sie sich die Remote Config Anwendungsfälle an und lesen Sie die Dokumentation zu wichtigen Konzepten und erweiterten Strategien, darunter:

• Remote Config-Vorlagenversionen verwalten
• Strategien zum Laden von Konfigurationen