Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Zacznij korzystać ze zdalnej konfiguracji Firebase w sieci Web

Możesz użyć Firebase Remote Config, aby zdefiniować parametry w swojej aplikacji i zaktualizować ich wartości w chmurze, umożliwiając modyfikowanie wyglądu i zachowania aplikacji bez dystrybuowania aktualizacji aplikacji.

Ten przewodnik przeprowadzi Cię przez wszystkie kroki, aby rozpocząć, i zawiera przykładowy kod, który można sklonować lub pobrać z repozytorium GitHub firebase / quickstart-js .

Dodaj zdalną konfigurację do swojej aplikacji

  1. Zainstaluj pakiet SDK Firebase dla sieci Web.

  2. Utwórz pojedynczy obiekt Remote Config i ustaw minimalny interwał pobierania, jak pokazano w poniższym przykładzie:

    const remoteConfig = firebase.remoteConfig();
    remoteConfig.settings = {
      minimumFetchIntervalMillis: 3600000,
    };     

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 aplikacji.

Podczas programowania zaleca się ustawienie stosunkowo niskiego minimalnego interwału pobierania. Aby uzyskać więcej informacji, zobacz Ograniczanie .

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

W obiekcie Remote Config można ustawić domyślne wartości parametrów w aplikacji, aby aplikacja zachowywała się zgodnie z przeznaczeniem przed nawiązaniem połączenia z zapleczem Remote Config i aby wartości domyślne były dostępne, jeśli żadna z nich nie została ustawiona w zapleczu.

remoteConfig.defaultConfig = ({
  'welcome_message': 'Welcome',
});

Uzyskaj 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 zapleczu, pobierzesz je, a następnie aktywujesz, te wartości będą dostępne dla Twojej aplikacji. Aby uzyskać te wartości, wywołaj metodę getValue() , podając klucz parametru jako argument.

Ustaw wartości parametrów

Korzystając z konsoli Firebase lub interfejsów API zaplecza Remote Config , możesz tworzyć nowe wartości domyślne po stronie serwera, które zastępują wartości w aplikacji zgodnie z wymaganą logiką warunkową lub kierowaniem na użytkowników. Ta sekcja przeprowadzi Cię przez procedurę konsoli Firebase, aby utworzyć te wartości.

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

Pobierz i aktywuj wartości

  1. Aby pobrać wartości parametrów z zaplecza Zdalnej konfiguracji, wywołaj metodę fetch() . Wszelkie wartości ustawione w zapleczu są pobierane i zapisywane w pamięci podręcznej w obiekcie Remote Config.
  2. Aby udostępnić pobrane wartości parametrów aplikacji, wywołaj metodę activate() .

W przypadkach, w których chcesz pobrać i aktywować wartości w jednym wywołaniu, użyj funkcji fetchAndActivate() jak pokazano w tym przykładzie:

  remoteConfig.fetchAndActivate()
  .then(() => {
    showWelcomeMessage();
  })
  .catch((err) => {
    console.error(err);
  });

Ponieważ te zaktualizowane wartości parametrów wpływają na zachowanie i wygląd aplikacji, należy aktywować pobrane wartości w momencie, który zapewni użytkownikowi płynne działanie, na przykład przy następnym otwarciu aplikacji przez użytkownika. Aby uzyskać więcej informacji i przykładów, zobacz Strategie ładowania Remote Config .

Dławienie

Jeśli aplikacja pobiera się zbyt wiele razy w krótkim okresie, może dojść do ograniczenia liczby wywołań. W takich przypadkach FETCH_THROTTLE SDK zgłasza błąd FETCH_THROTTLE . Zaleca się wychwycenie tego błędu i ponowienie próby w trybie wykładniczego wycofywania, czekając w dłuższych odstępach czasu między kolejnymi żądaniami pobierania.

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 opracowywania i testowania aplikacji. Aby umożliwić szybką iterację w projekcie z wieloma programistami, możesz tymczasowo dodać właściwość z niskim minimalnym interwałem pobierania ( 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 ciągu 12 godzin, niezależnie od liczby faktycznie wykonywanych 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. Wartość domyślna 12 godzin.

Następne kroki

Jeśli jeszcze tego nie zrobiłeś, zapoznaj się z przypadkami użycia Remote Config i zapoznaj się z niektórymi kluczowymi pojęciami i dokumentacją zaawansowanych strategii, w tym: