Catch up on everthing we announced at this year's Firebase Summit. Learn more

Zacznij korzystać ze zdalnej konfiguracji Firebase

Za pomocą zdalnej konfiguracji Firebase możesz definiować parametry w swojej aplikacji i aktualizować ich wartości w chmurze, co pozwala modyfikować wygląd i zachowanie aplikacji bez rozpowszechniania aktualizacji aplikacji. Ten poradnik przeprowadzi Cię przez kolejne etapy zacząć i zapewnia pewne przykładowy kod, z których wszystkie są dostępne dla klonu lub pobrać z Firebase / szybkiego startu-js GitHub repozytorium.

Dodaj zdalną konfigurację do swojej aplikacji

  1. Zainstalować Firebase SDK for Web.

  2. Utwórz pojedynczy obiekt Remote Config:

    Wersja internetowa 9

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

const remoteConfig = getRemoteConfig();
    rc_get_instance.js

    Wersja internetowa 8

    const remoteConfig = firebase.remoteConfig();
    index.js

    Ten obiekt służy do przechowywania domyślnych wartości parametrów w aplikacji, pobierania zaktualizowanych wartości parametrów z zaplecza Zdalnej konfiguracji i kontrolowania, kiedy pobrane wartości są udostępniane Twojej aplikacji.

  3. Ustaw minimalny interwał pobierania:

    Wersja internetowa 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;
    rc_set_minimum_fetch_time.js

    Wersja internetowa 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;
    index.js

    Podczas programowania zaleca się ustawienie stosunkowo niskiego minimalnego interwału pobierania. Zobacz dławienia , aby uzyskać więcej informacji.

Ustaw domyślne wartości parametrów w aplikacji

Możesz ustawić domyślne wartości parametrów w aplikacji w obiekcie Zdalna konfiguracja, aby aplikacja zachowywała się zgodnie z przeznaczeniem, zanim nawiąże połączenie z zapleczem zdalnej konfiguracji, i aby wartości domyślne były dostępne, jeśli nie są ustawione w zapleczu.

Wersja internetowa 9

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

Wersja internetowa 8

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

Pobierz wartości parametrów do użycia w swojej aplikacji

Teraz możesz pobrać wartości parametrów z obiektu Remote Config. Jeśli później ustawisz wartości w backendzie, pobierzesz je, a następnie aktywujesz, te wartości będą dostępne dla Twojej aplikacji. Aby uzyskać te wartości, zadzwoń getValue() metodę, zapewniając Kluczowym parametrem jako argument.

Wersja internetowa 9

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

const val = getValue(remoteConfig, "welcome_messsage");
rc_get_values.js

Wersja internetowa 8

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

Ustaw wartości parametrów

Korzystanie z konsoli Firebase lub do zdalnego API backend Config , można tworzyć nowe wartości domyślnych po stronie serwera, które zastępują wartości w aplikacji według żądanego logika lub użytkownik warunkowy kierowania. W tej sekcji przedstawiono kroki konsoli Firebase umożliwiające tworzenie tych wartości.

  1. W konsoli Firebase otwórz projekt.
  2. Wybierz Remote Config z menu, aby zobaczyć pulpit zdalnego Config.
  3. Zdefiniuj parametry o takich samych nazwach, jak parametry zdefiniowane w Twojej aplikacji. Dla każdego parametru możesz ustawić wartość domyślną (która ostatecznie zastąpi domyślną wartość w aplikacji), a także możesz ustawić wartości warunkowe. Aby dowiedzieć się więcej, zobacz Remote Config parametrów i warunków .

Pobierz i aktywuj wartości

  1. Aby sprowadzić wartości parametrów ze zdalnego konf backend wywołać fetchConfig() sposobu. Wszelkie wartości ustawione w zapleczu są pobierane i buforowane w obiekcie Remote Config.
  2. Aby sprowadzone wartości parametrów dostępnych aplikacji, należy wywołać activate() metody.

W przypadkach, w których chcemy się pobrać i aktywować wartości w jednej rozmowy, użyj fetchAndActivate() , jak pokazano w poniższym przykładzie:

Wersja internetowa 9

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

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

Wersja internetowa 8

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

Ponieważ te zaktualizowane wartości parametrów wpływają na zachowanie i wygląd aplikacji, należy aktywować pobrane wartości w czasie, który zapewnia płynne działanie użytkownika, na przykład przy następnym otwarciu aplikacji przez użytkownika. Zobacz Remote Config strategie ładowania Więcej informacji i przykładów.

dławienie

Jeśli aplikacja jest pobierana zbyt wiele razy w krótkim czasie, wywołania pobierania mogą zostać ograniczone. W takich przypadkach SDK rzuca FETCH_THROTTLE błąd. Zaleca się przechwycenie tego błędu i ponowną próbę w trybie wykładniczego wycofywania, czekając dłuższe odstępy między kolejnymi żądaniami pobrania.

Podczas tworzenia aplikacji możesz chcieć bardzo często odświeżać pamięć podręczną (wiele razy na godzinę), aby umożliwić szybkie iteracje podczas tworzenia i testowania aplikacji. Aby pomieścić szybki iteracji nad projektem z wieloma deweloperami, można tymczasowo dodać obiekt z niskim minimum sprowadzić przedziale ( Settings.minimumFetchIntervalMillis ) w swojej aplikacji.

Domyślny i zalecany interwał pobierania danych produkcyjnych dla Zdalnej konfiguracji to 12 godzin, co oznacza, że ​​konfiguracje nie będą pobierane z zaplecza więcej niż raz w 12-godzinnym oknie, niezależnie od liczby faktycznie wykonanych wywołań pobierania. W szczególności minimalny interwał pobierania jest określany w następującej kolejności:

  1. Parametr w Settings.minimumFetchIntervalMillis .
  2. Domyślna wartość 12 godzin.

Następne kroki

Jeśli nie masz już, odkrywania Remote Config przypadków użycia , i spojrzeć na niektóre z kluczowych pojęć i zaawansowanej dokumentacji strategii, w tym: