Erste Schritte mit Firebase Remote Config

iOS+ Android Web Flutter Unity C++

Wichtig: In diesem Abschnitt wird beschrieben, wie Sie Remote Config mit mobilen und Webclients konfigurieren. 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.

Die Bibliothek Remote Config wird zum Speichern von In-App-Standardparameterwerten verwendet. aktualisierte Parameterwerte aus dem Remote Config-Back-End abrufen und steuern, wann abgerufene Werte für Ihre App verfügbar gemacht werden. Weitere Informationen Siehe Remote Config-Ladestrategien.

Schritt 1: Firebase Ihrer App hinzufügen

Vor der Verwendung Remote Config, sind folgende Schritte erforderlich:

• 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.

Beachten Sie, dass das Hinzufügen von Firebase zu Ihrem C++-Projekt sowohl Aufgaben im Firebase-Konsole und in Ihrem offenen C++-Projekt, z. B. wenn Sie Firebase-Konfigurationsdateien aus der Console aus und verschieben Sie sie dann in Ihr C++-Projekt.

Schritt 2: Remote Config zu Ihrer App hinzufügen

Android

Nachdem Sie Ihrer App Firebase hinzugefügt haben:

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

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

2. Initialisieren Sie die Remote Config-Bibliothek wie 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: Standardparameterwerte in der App 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 mithilfe eines ConfigKeyValue* -Objekt oder ein 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 mithilfe vonRemote Config SetDefaults()

Schritt 4: Parameterwerte zur Verwendung in Ihrer App abrufen

Jetzt können Sie 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 zurückgegeben, die mit SetDefaults() konfiguriert wurden.

Um diese Werte zu erhalten, rufen Sie die unten aufgeführte Methode auf, die dem Datentyp wird von Ihrer App erwartet. Geben Sie dabei den Parameterschlüssel als Argument an:

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

Schritt 5: Parameterwerte festlegen

1. Öffnen Sie Ihr Projekt in der Firebase-Konsole.
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, die Sie in für Ihre App. Für jeden Parameter können Sie einen Standardwert festlegen, der den Standardwert in der App) und bedingte Werte überschreiben. Weitere Informationen finden Sie unter Remote Config-Parameter und ‑Bedingungen.

Schritt 6: Werte abrufen und aktivieren

1. Rufen Sie zum Abrufen von Parameterwerten aus dem Remote Config-Backend die Methode Fetch() . Alle Werte, die Sie im Back-End festlegen, werden abgerufen und im Remote Config-Objekt zwischengespeichert.
2. Um abgerufene Parameterwerte für Ihre App verfügbar zu machen, rufen Sie die Methode ActivateFetched()

Schritt 7: Auf Echtzeit-Updates warten

Nachdem Sie Parameterwerte abgerufen haben, können Sie Remote Config in Echtzeit verwenden, um Warten auf Aktualisierungen vom Remote Config-Back-End. Echtzeit Remote Config signalisiert verbundenen Geräten, wenn Updates verfügbar sind und ruft die Änderungen nach der Veröffentlichung eines neuen Remote Config automatisch ab Version.

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

Wichtig: Für Echtzeit-Remote Config ist außerdem 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 aktiviert sein. 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 auf Updates zu warten und ruft automatisch alle neuen oder aktualisierten Parameterwerte ab. 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 du das nächste Mal eine neue Version von Remote Config veröffentlichst, werden die Geräte die Ihre App ausführen und auf Änderungen warten, Update-Listener.

Nächste Schritte

Sehen Sie sich die Remote Config an, falls Sie dies noch nicht getan haben Anwendungsfälle und sehen uns einige der Schlüsselkonzepte und Dokumentation zu erweiterten Strategien, einschließlich:

• Remote Config Vorlagenversionen verwalten
• Ladestrategien für Konfigurationen