Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Erste Schritte mit Firebase Remote Config

Sie können Firebase Remote Config verwenden, um Parameter in Ihrer App zu definieren und ihre Werte in der Cloud zu aktualisieren, sodass Sie das Aussehen und Verhalten Ihrer App ändern können, ohne ein App-Update zu verteilen. Dieser Leitfaden führt Sie durch die einzelnen Schritte , um loszulegen und bietet einige Beispiel - Code, die alle zu klonen oder Download von der zur Verfügung Firebase / quickstart-js GitHub - Repository.

Füge Remote Config zu deiner App hinzu

  1. Installieren Sie die Firebase SDK für Web.

  2. Erstellen Sie das Singleton Remote Config-Objekt:

    Webversion 9

    import { getRemoteConfig } from "firebase/remote-config";
    
    const remoteConfig = getRemoteConfig();

    Webversion 8

    const remoteConfig = firebase.remoteConfig();

    Dieses Objekt wird verwendet, um In-App-Standardparameterwerte zu speichern, aktualisierte Parameterwerte aus dem Remote Config-Back-End abzurufen und zu steuern, wann abgerufene Werte für Ihre App verfügbar gemacht werden.

  3. Legen Sie ein minimales Abrufintervall fest:

    Webversion 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Webversion 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Während der Entwicklung wird empfohlen, ein relativ niedriges Mindestabrufintervall festzulegen. Siehe Throttling für weitere Informationen.

In-App-Standardparameterwerte festlegen

Sie können In-App-Standardparameterwerte im Remote Config-Objekt festlegen, damit sich Ihre App wie beabsichtigt verhält, bevor sie eine Verbindung mit dem Remote Config-Back-End herstellt, und damit Standardwerte verfügbar sind, wenn keine im Back-End festgelegt sind.

Webversion 9

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

Webversion 8

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

Abrufen von Parameterwerten zur Verwendung in Ihrer App

Jetzt können Sie Parameterwerte aus dem Remote Config-Objekt abrufen. Wenn Sie später im Back-End Werte festlegen, diese abrufen und dann aktivieren, stehen diese Werte für Ihre App zur Verfügung. Um diese Werte zu erhalten, rufen Sie die getValue() Methode, um den Parameter Schlüssel als Argument bereitgestellt wird .

Webversion 9

import { getValue } from "firebase/remote-config";

const val = getValue(remoteConfig, "welcome_messsage");

Webversion 8

const val = remoteConfig.getValue("welcome_messsage");

Parameterwerte einstellen

Mit Hilfe der Konsole Firebase oder die Remote - Back - End - Config - APIs können Sie neue serverseitige Standardwerte erstellen , die überschreiben die In-App - Werte nach Ihrer gewünschten Bedingungslogik oder Benutzer - Targeting. In diesem Abschnitt werden Sie durch die Schritte der Firebase-Konsole zum Erstellen dieser Werte geführt.

  1. In der Firebase Konsole , öffnen Sie Ihr Projekt.
  2. Wählen Sie Remote Config aus dem Menü die Remote Config - Dashboard anzuzeigen.
  3. 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 festlegen (der schließlich den Standardwert in der App überschreibt) und Sie können auch bedingte Werte festlegen. Um mehr zu erfahren, siehe Remote - Config - Parameter und Bedingungen .

Werte abrufen und aktivieren

  1. Um Parameterwerte aus dem Remote - Config - Backend, rufen Sie das Fetch fetchConfig() Methode. Alle Werte, die Sie im Back-End festlegen, werden abgerufen und im Remote Config-Objekt zwischengespeichert.
  2. Um abgerufenen Parameterwerte in Ihrer App zur Verfügung, rufen Sie die activate() Methode.

Für Fälle , in denen Sie holen wollen und aktivieren Werte in einem Aufruf, verwendet fetchAndActivate() , wie in diesem Beispiel gezeigt:

Webversion 9

import { fetchAndActivate } from "firebase/remote-config";

fetchAndActivate(remoteConfig)
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

Webversion 8

remoteConfig.fetchAndActivate()
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

Da sich diese aktualisierten Parameterwerte auf das Verhalten und die Darstellung Ihrer App auswirken, sollten Sie die abgerufenen Werte zu einem Zeitpunkt aktivieren, der eine reibungslose Erfahrung für Ihren Benutzer gewährleistet, z. B. beim nächsten Öffnen der App durch den Benutzer. Siehe Remote - Config Ladestrategien für weitere Informationen und Beispiele.

Drosselung

Wenn eine App in einem kurzen Zeitraum zu oft abgerufen wird, werden Abrufaufrufe möglicherweise gedrosselt. In solchen Fällen führt das SDK einen FETCH_THROTTLE Fehler. Es wird empfohlen, diesen Fehler abzufangen und es im exponentiellen Backoff-Modus erneut zu versuchen, indem Sie längere Intervalle zwischen nachfolgenden Abrufanforderungen warten.

Während der App-Entwicklung möchten Sie den Cache möglicherweise sehr häufig (viele Male pro Stunde) aktualisieren, damit Sie beim Entwickeln und Testen Ihrer App schnell iterieren können. Zur Aufnahme von schnellen Iteration an einem Projekt mit zahlreichen Entwicklern, können Sie vorübergehend eine Eigenschaft mit einem niedrigen Mindestabrufintervall (add Settings.minimumFetchIntervalMillis ) in Ihrer Anwendung.

Das standardmäßige und empfohlene Produktionsabrufintervall für Remote Config beträgt 12 Stunden, was bedeutet, dass Konfigurationen innerhalb eines 12-Stunden-Fensters nicht mehr als einmal vom Back-End abgerufen werden, unabhängig davon, wie viele Abrufaufrufe tatsächlich getätigt werden. Insbesondere wird das minimale Abrufintervall in der folgenden Reihenfolge bestimmt:

  1. Der Parameter in Settings.minimumFetchIntervalMillis .
  2. Der Standardwert von 12 Stunden.

Nächste Schritte

Wenn Sie nicht bereits haben, erkunden Sie die Remote - Config Use Cases , und werfen Sie einen Blick auf einige der wichtigsten Konzepte und fortgeschrittene Strategien Dokumentation, einschließlich: