Erste Schritte mit Remote Config in C++

Plattform auswählen:

iOS+ Android Web Flutter Unity C++

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 Verhalten Ihrer App ändern, ohne ein App-Update veröffentlichen zu müssen.

Die Remote Config-Bibliothek wird verwendet, um In-App-Standardparameterwerte zu speichern, aktualisierte Parameterwerte aus dem Remote Config-Backend abzurufen und zu steuern, wann abgerufene Werte für Ihre App verfügbar gemacht werden. Weitere Informationen finden Sie unter Remote Config-Ladestrategien.

Schritt 1: Firebase zur 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 Ihr C++-Projekt bereits Firebase verwendet, ist es bereits für Firebase registriert und konfiguriert.

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

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

Wenn Sie Firebase zu Ihrem C++-Projekt hinzufügen, müssen Sie sowohl in der Firebase Console als auch in Ihrem offenen C++-Projekt Aufgaben ausführen. 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 zu Ihrer App 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 hier gezeigt:

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

iOS+

Nachdem Sie Firebase zu Ihrer App hinzugefügt haben:

1. Firebase-App erstellen:

   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 gewünscht verhält, bevor sie eine Verbindung zum Remote Config-Backend herstellt, und damit Standardwerte verfügbar sind, wenn im Backend keine festgelegt sind.

Wichtig: Speichern Sie keine vertraulichen Daten in Remote Config-Parameterschlüsseln oder -werten. Remote Config-Daten werden bei 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-Backend-Parameterwerte 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 mit SetDefaults() zum Remote Config-Objekt hinzu.

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 erhalten Sie die In-App-Parameterwerte, die mit SetDefaults() konfiguriert wurden.

Wenn Sie diese Werte abrufen möchten, rufen Sie eine der folgenden Methoden auf, die dem von Ihrer App erwarteten Datentyp entsprechen, und geben Sie den Parameterschlüssel als Argument an:

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

Schritt 5: Parameterwerte festlegen

1. Rufen Sie in der Firebase-Konsole DevOps & Engagement > Remote Config auf.

2. Definieren Sie Parameter mit denselben Namen wie die Parameter, die Sie in Ihrer App definiert haben. Für jeden Parameter können Sie einen Standardwert (der schließlich den Standardwert in der App überschreibt) und bedingte Werte festlegen. Weitere Informationen finden Sie unter Remote Config-Parameter und -Bedingungen.

Schritt 6: Werte abrufen und aktivieren

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

Schritt 7: Echtzeit-Updates erhalten

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

Echtzeitupdates werden vom Firebase C++ SDK ab Version 11.0.0 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 aktiviert sein sollte. Öffnen Sie zur Überprüfung die Google Cloud-Konsole, 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 und 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 automatisch neue oder aktualisierte Parameterwerte abzurufen. Im folgenden Beispiel wird auf Aktualisierungen gewartet. Wenn Activate aufgerufen wird, werden die neu abgerufenen Werte verwendet, um eine aktualisierte Willkommensnachricht 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 von Remote Config veröffentlichen, rufen Geräte, auf denen Ihre App ausgeführt wird und die auf Änderungen warten, den Listener für Konfigurationsupdates auf.