Wprowadzenie do Zdalnej konfiguracji w C++

Za pomocą Firebase Remote Config możesz definiować parametry w aplikacji i aktualizować ich wartości w chmurze. Dzięki temu możesz modyfikować wygląd i zachowanie aplikacji bez konieczności dystrybuowania aktualizacji aplikacji.

Biblioteka Remote Config służy do przechowywania domyślnych wartości parametrów w aplikacji, pobierania zaktualizowanych wartości parametrów z backendu Remote Config oraz kontrolowania, kiedy pobrane wartości mają być dostępne dla aplikacji. Więcej informacji znajdziesz w artykuleStrategie ładowania Zdalnej konfiguracji.

Krok 1. Dodaj Firebase do aplikacji

Zanim zaczniesz korzystać z Remote Config, musisz:

• zarejestrować projekt C++ i skonfigurować go do korzystania z Firebase.

  Jeśli Twój projekt C++ korzysta już z Firebase, jest on już zarejestrowany i skonfigurowany do używania Firebase.

• dodać pakiet Firebase C++ SDK do projektu C++.

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

Krok 2. Dodaj Remote Config do aplikacji

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

Możesz ustawić domyślne wartości parametrów w aplikacji w obiekcie Remote Config , aby aplikacja zachowywała się zgodnie z oczekiwaniami, zanim połączy się z backendem Remote Config, oraz aby wartości domyślne były dostępne, jeśli nie są ustawione w backendzie.

1. Zdefiniuj zestaw nazw parametrów i domyślnych wartości parametrów za pomocą obiektu ConfigKeyValue* lub obiektu ConfigKeyValueVariant* o rozmiarze tablicy.

   Jeśli masz już skonfigurowane Remote Config wartości parametrów backendu, możesz pobrać plik zawierający te pary klucz-wartość i użyć go do utworzenia obiektu map. Więcej informacji znajdziesz w artykule Pobieranie Remote Config domyślnych wartości szablonu.

2. Dodaj te wartości do obiektu Remote Config za pomocą SetDefaults().

Krok 4. Uzyskaj wartości parametrów, które będą używane w Twojej aplikacji

Teraz możesz pobierać wartości parametrów z obiektu Remote Config. Jeśli ustawisz wartości w backendzie Remote Config, pobierzesz je, a następnie aktywujesz, będą one dostępne dla Twojej aplikacji. W przeciwnym razie uzyskasz wartości parametrów w aplikacji skonfigurowane za pomocą SetDefaults().

Aby uzyskać te wartości, wywołaj dowolną z tych metod, które odpowiadają typowi danych oczekiwanemu przez Twoją aplikację, podając klucz parametru jako argument:

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

Krok 5. Ustaw wartości parametrów

1. W konsoli FirebaseFirebase otwórz swój projekt.
2. W menu wybierz Remote Config , aby wyświetlić panel 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) i wartości warunkowe. Więcej informacji znajdziesz w artykule Remote Config parametry i warunki.

Krok 6. Pobierz i aktywuj wartości

1. Aby pobrać wartości parametrów z backendu Remote Config, wywołaj metodę Fetch(). Wszystkie wartości ustawione w backendzie 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ę ActivateFetched()

Krok 7. Nasłuchuj aktualizacji w czasie rzeczywistym

Po pobraniu wartości parametrów możesz użyć Zdalnej konfiguracji w czasie rzeczywistym, aby nasłuchiwać aktualizacji z backendu Zdalnej konfiguracji.Remote ConfigRemote Config Zdalna konfiguracja w czasie rzeczywistym Remote Config informuje połączone urządzenia o dostępności aktualizacji i automatycznie pobiera zmiany po opublikowaniu nowej Remote Config wersji.

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

1. W aplikacji wywołaj funkcję AddOnConfigUpdateListener, aby rozpocząć nasłuchiwanie aktualizacji i automatycznie pobierać nowe lub zaktualizowane wartości parametrów. Poniższy przykład nasłuchuje aktualizacji i, gdy wywoływana jest funkcja Activate, używa nowo pobranych wartości do wyświetlania zaktualizowanej wiadomości powitalnej.

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ę Remote Config, urządzenia na których działa Twoja aplikacja i które nasłuchują zmian, wywołają odbiornik aktualizacji konfiguracji.