Erste Schritte mit Firebase Remote Config

Mit Firebase Remote Config können Sie Parameter in Ihrer App definieren und aktualisieren ihre Werte in der Cloud, sodass Sie das Erscheinungsbild deiner App, ohne ein App-Update zu veröffentlichen.

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

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 registriert und die für Firebase konfiguriert sind.

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

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 und verschieben Sie sie dann in Ihr C++-Projekt.

Schritt 2: Remote Config zu Ihrer App hinzufügen

Schritt 3: Standardparameterwerte in der App festlegen

Du kannst In-App-Standardparameterwerte in der Remote Config festlegen -Objekt, damit sich Ihre App wie beabsichtigt verhält, bevor sie eine Verbindung zum Remote Config-Back-End, sodass Standardwerte verfügbar sind, falls keine verfügbar sind. Back-End festgelegt ist.

1. Definieren Sie eine Reihe von Parameternamen und Standardparameterwerten mit einem std::map<const char*, const char*>-Objekt oder einem std::map<const char*, firebase::Variant>-Objekt.

   • Weitere Informationen zu firebase::Variant.

   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 Herunterladen Remote Config-Standardvorlagen.

2. Fügen Sie diese Werte mithilfe vonRemote Config SetDefaults()

Schritt 4: Parameterwerte zur Verwendung in Ihrer App abrufen

Sie können jetzt Parameterwerte aus dem Remote Config-Objekt abrufen. Wenn Sie Werte im Remote Config-Back-End, abgerufen und dann aktiviert, für Ihre App verfügbar sind. Andernfalls wird der In-App-Parameter Werte konfiguriert mit SetDefaults()

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 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, 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 Backend festlegen, werden abgerufen und im Remote Config-Objekt im Cache gespeichert.
2. Um abgerufene Parameterwerte für Ihre App verfügbar zu machen, rufen Sie die Methode ActivateFetched()

Schritt 7: In Echtzeit auf 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.

1. Rufen Sie in Ihrer App AddOnConfigUpdateListener auf, um auf Updates zu warten und ruft automatisch alle neuen oder aktualisierten Parameterwerte ab. Die folgenden Das Beispiel wartet auf Updates und verwendet beim Aufruf von Activate die neue abgerufene Werte, 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 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