Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Beginnen Sie mit Firebase Remote Config im Web

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

Diese Anleitung führt Sie durch die ersten Schritte und enthält Beispielcode, der zum Klonen oder Herunterladen aus dem GitHub-Repository von firebase / quickstart-js verfügbar ist.

Fügen Sie Ihrer App Remote Config hinzu

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

  2. Erstellen Sie das Singleton Remote Config-Objekt:

    const remoteConfig = firebase.remoteConfig();

    Dieses Objekt wird verwendet, um In-App-Standardparameterwerte zu speichern, aktualisierte Parameterwerte aus dem Remote Config-Backend abzurufen und zu steuern, wann abgerufene Werte Ihrer App zur Verfügung gestellt werden.

  3. Legen Sie ein Mindestabrufintervall fest:

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Während der Entwicklung wird empfohlen, ein relativ niedriges Mindestabrufintervall festzulegen. Weitere Informationen finden Sie unter Drosselung .

Legen Sie die In-App-Standardparameterwerte fest

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

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

Holen Sie sich Parameterwerte zur Verwendung in Ihrer App

Jetzt können Sie Parameterwerte vom Remote Config-Objekt abrufen. Wenn Sie später Werte im Backend festlegen, abrufen und dann aktivieren, stehen diese Werte Ihrer App zur Verfügung. Um diese Werte getValue() , rufen Sie die Methode getValue() und geben Sie den Parameterschlüssel als Argument an.

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

Parameterwerte einstellen

Mithilfe der Firebase-Konsole oder der Remote Config-Backend-APIs können Sie neue serverseitige Standardwerte erstellen, die die In-App-Werte gemäß Ihrer gewünschten bedingten Logik oder Benutzerausrichtung überschreiben. Dieser Abschnitt führt Sie durch die Schritte der Firebase-Konsole, um diese Werte zu erstellen.

  1. Öffnen Sie in der Firebase-Konsole Ihr Projekt.
  2. Wählen Sie Remote Config aus dem Menü, um das 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 eventuell den In-App-Standardwert überschreibt) und Sie können auch bedingte Werte festlegen. Weitere Informationen finden Sie unter Parameter und Bedingungen für die Remote-Konfiguration .

Werte abrufen und aktivieren

  1. Rufen Sie die Methode fetch() auf, um Parameterwerte aus dem Remote Config-Backend fetch() . Alle Werte, die Sie im Backend festlegen, werden im Remote Config-Objekt abgerufen und zwischengespeichert.
  2. Rufen Sie die Methode activate() auf, um abgerufene Parameterwerte für Ihre App verfügbar zu machen.

Verwenden Sie in Fällen, in denen Sie Werte in einem Aufruf fetchAndActivate() und aktivieren möchten, fetchAndActivate() wie in diesem Beispiel gezeigt:

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

Da diese aktualisierten Parameterwerte das Verhalten und das Erscheinungsbild Ihrer App beeinflussen, sollten Sie die abgerufenen Werte zu einem Zeitpunkt aktivieren, der eine reibungslose Benutzererfahrung gewährleistet, z. B. beim nächsten Öffnen der App durch den Benutzer. Weitere Informationen und Beispiele finden Sie unter Ladestrategien für die Remote-Konfiguration .

Drosselung

Wenn eine App in kurzer Zeit zu oft abruft, werden Abrufe möglicherweise gedrosselt. In solchen Fällen gibt das SDK einen FETCH_THROTTLE Fehler aus. Es wird empfohlen, diesen Fehler abzufangen und im exponentiellen Backoff-Modus erneut zu versuchen und längere Intervalle zwischen nachfolgenden Abrufanforderungen zu warten.

Während der App-Entwicklung möchten Sie den Cache möglicherweise sehr häufig (mehrmals pro Stunde) aktualisieren, damit Sie beim Entwickeln und Testen Ihrer App schnell iterieren können. Um eine schnelle Iteration eines Projekts mit zahlreichen Entwicklern zu ermöglichen, können Sie Ihrer App vorübergehend eine Eigenschaft mit einem geringen Mindestabrufintervall ( Settings.minimumFetchIntervalMillis ) hinzufügen.

Das standardmäßige und empfohlene Produktionsabrufintervall für Remote Config beträgt 12 Stunden. Dies bedeutet, dass Konfigurationen in einem 12-Stunden-Fenster nicht mehr als einmal vom Backend 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 dies noch nicht getan haben , lesen Sie die Anwendungsfälle für die Remote-Konfiguration und sehen Sie sich einige der wichtigsten Konzepte und Dokumentationen zu erweiterten Strategien an, darunter: