Pierwsze kroki ze Zdalnej konfiguracji Firebase

Za pomocą Zdalnej konfiguracji Firebase możesz definiować parametry w swojej aplikacji oraz ich wartości w chmurze, co pozwala na modyfikowanie wyglądu zachowanie aplikacji bez jej rozpowszechniania.

Biblioteka Zdalnej konfiguracji służy do przechowywania domyślnych wartości parametrów w aplikacji, pobierz zaktualizowane wartości parametrów z backendu Zdalnej konfiguracji oraz kontrolować, kiedy pobrane wartości mają być udostępniane aplikacji. Aby dowiedzieć się więcej, zobacz Strategie wczytywania Zdalnej konfiguracji.

Krok 1. Dodaj Firebase do swojej aplikacji

Zanim będzie można użyć Zdalna konfiguracja, musisz:

• Zarejestruj swój projekt C++ i skonfiguruj go pod kątem korzystania z Firebase.

  Jeśli Twój projekt w C++ korzysta już z Firebase, to jest już zarejestrowany skonfigurowane na potrzeby Firebase.

• Dodaj pakiet SDK Firebase C++ do projektu w C++.

.

Pamiętaj, że dodanie Firebase do projektu C++ wymaga wykonania zadań zarówno w w konsoli Firebase i w otwartym projekcie C++ (np. pobranym pliki konfiguracyjne Firebase z poziomu konsoli, a następnie przenieś je do projektu C++).

Krok 2. Dodaj Zdalną konfigurację do swojej aplikacji

Krok 3. Ustaw domyślne wartości parametrów w aplikacji

Wartości domyślne parametrów w aplikacji możesz ustawić w Zdalnej konfiguracji. dzięki czemu aplikacja działa zgodnie z oczekiwaniami jeszcze przed nawiązaniem połączenia backend Zdalnej konfiguracji, dzięki czemu dostępne są wartości domyślne, jeśli nie są dla serwera zaplecza.

1. Zdefiniuj zbiór nazw parametrów i domyślne wartości parametrów za pomocą std::map<const char*, const char*> obiekt lub std::map<const char*, firebase::Variant> obiekt.

   • Dowiedz się więcej o firebase::Variant.

   Jeśli masz już skonfigurowany parametr backendu Zdalnej konfiguracji możesz pobrać plik zawierający te pary klucz/wartość i użyć go, aby utworzyć obiekt map. Więcej informacji: Pobierz Domyślne ustawienia szablonu Zdalnej konfiguracji.

2. Dodaj te wartości do obiektu Zdalnej konfiguracji za pomocą SetDefaults().

Krok 4. Pobierz wartości parametrów do wykorzystania w aplikacji

Teraz możesz pobierać wartości parametrów z obiektu Zdalnej konfiguracji. Jeśli ustawisz w backendzie Zdalnej konfiguracji, pobrały je, a następnie aktywowały, wartości są dostępne dla aplikacji. W przeciwnym razie otrzymasz parametr in-app wartości skonfigurowane za pomocą SetDefaults().

Aby uzyskać te wartości, wywołaj podaną poniżej metodę, która jest mapowana na typ danych oczekiwanych przez aplikację, podając klucz parametru jako argument:

• GetBoolean()
• GetData()
• GetDouble()
• GetLong()
• GetString()

Krok 5. Ustaw wartości parametrów

1. W konsoli Firebase otwórz projekt.
2. Aby wyświetlić panel Zdalnej konfiguracji, wybierz z menu Zdalna konfiguracja.
3. Zdefiniuj parametry o takich samych nazwach jak parametry zdefiniowane w sekcji do aplikacji. Dla każdego parametru możesz ustawić wartość domyślną (która będzie zastąpią domyślną wartość w aplikacji) i wartości warunkowe. Więcej informacji: Parametry i warunki Zdalnej konfiguracji.

Krok 6. Pobierz i aktywuj wartości

1. Aby pobrać wartości parametrów z backendu Zdalnej konfiguracji, wywołaj funkcję Fetch() . Wszystkie wartości ustawione w backendzie są pobierane i w pamięci podręcznej obiektu Zdalnej konfiguracji.
2. Aby udostępnić aplikacji pobrane wartości parametrów, wywołaj metodę ActivateFetched()

Krok 7. Nasłuchuj aktualizacji w czasie rzeczywistym

Po pobraniu wartości parametrów możesz używać Zdalnej konfiguracji w czasie rzeczywistym, aby: nasłuchuj aktualizacji z backendu Zdalnej konfiguracji. Wydarzenia w czasie rzeczywistym Zdalna konfiguracja wysyła sygnały do połączonych urządzeń, gdy dostępne są aktualizacje. automatycznie pobiera zmiany po opublikowaniu nowej Zdalnej konfiguracji. wersji.

Aktualizacje w czasie rzeczywistym są obsługiwane przez pakiet SDK Firebase C++ wersji 11.0.0 lub nowszej na platformy Android i Apple.

1. W aplikacji zadzwoń pod numer AddOnConfigUpdateListener, by zacząć nasłuchiwać powiadomień oraz automatycznie pobierać nowe lub zaktualizowane wartości parametrów. Poniżej nasłuchuje aktualizacji, a po wywołaniu funkcji Activate używa nowo pobrane wartości, by wyświetlić zaktualizowaną wiadomość powitalną.

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);
      }
    });

Gdy następnym razem opublikujesz nową wersję Zdalnej konfiguracji, urządzenia które używają Twojej aplikacji i nasłuchują zmian, wywołają konfigurację aktualizacji detektora.

Dalsze kroki

Zapoznaj się ze Zdalną konfiguracją, jeśli jeszcze jej nie znasz. przypadkach użycia i przyjrzyj się niektórym dokumentację kluczowych koncepcji i zaawansowanych strategii, w tym:

• Zarządzanie wersjami szablonów Zdalnej konfiguracji
• Strategie wczytywania konfiguracji