Начало работы с Firebase Remote Config

Вы можете использовать Firebase Remote Config для определения параметров в своем приложении и обновления их значений в облаке, что позволяет вам изменять внешний вид и поведение вашего приложения без распространения обновления приложения.

Библиотека Remote Config используется для хранения значений параметров по умолчанию в приложении, получения обновлённых значений параметров из бэкэнда Remote Config и управления доступом к полученным значениям в вашем приложении. Подробнее см. в разделе Стратегии загрузки Remote Config .

Шаг 1: Добавьте Firebase в свое приложение

Прежде чем использовать Remote Config , вам необходимо:

• Зарегистрируйте свой проект C++ и настройте его для использования Firebase.

  Если ваш проект C++ уже использует Firebase, значит, он уже зарегистрирован и настроен для Firebase.

• Добавьте Firebase C++ SDK в свой проект C++.

Обратите внимание, что добавление Firebase в ваш проект C++ включает в себя задачи как в консоли Firebase , так и в вашем открытом проекте C++ (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в свой проект C++).

Шаг 2: Добавьте Remote Config в свое приложение

Шаг 3: Установите значения параметров приложения по умолчанию

Вы можете задать значения параметров приложения по умолчанию в объекте Remote Config , чтобы приложение вело себя так, как задумано, до того, как оно подключится к бэкэнду Remote Config , и чтобы значения по умолчанию были доступны, если на бэкэнде ничего не установлено.

1. Определите набор имен параметров и значений параметров по умолчанию, используя объект ConfigKeyValue* или объект ConfigKeyValueVariant* с размером массива.

   Если вы уже настроили значения параметров бэкэнда Remote Config , вы можете скачать файл, содержащий эти пары «ключ/значение», и использовать его для создания объекта map . Подробнее см. в разделе «Загрузка значений по умолчанию для шаблона Remote Config .

2. Добавьте эти значения в объект Remote Config с помощью SetDefaults() .

Шаг 4: Получите значения параметров для использования в вашем приложении.

Теперь вы можете получать значения параметров из объекта Remote Config . Если вы задали значения в бэкенде Remote Config , получили их и затем активировали, эти значения будут доступны вашему приложению. В противном случае вы получите значения параметров внутри приложения, настроенные с помощью SetDefaults() .

Чтобы получить эти значения, вызовите указанный ниже метод, который сопоставляется с типом данных, ожидаемым вашим приложением, указав ключ параметра в качестве аргумента:

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

Шаг 5: Установите значения параметров

1. В консоли Firebase откройте свой проект.
2. Выберите Remote Config в меню, чтобы просмотреть панель управления Remote Config .
3. Определите параметры с теми же именами, что и параметры, заданные в вашем приложении. Для каждого параметра можно задать значение по умолчанию (которое в конечном итоге переопределит значение по умолчанию в приложении) и условные значения. Подробнее см. в разделе Параметры и условия Remote Config .

Шаг 6: Извлечение и активация значений

1. Чтобы получить значения параметров из бэкенда Remote Config , вызовите метод Fetch() . Все значения, заданные в бэкенде, извлекаются и кэшируются в объекте Remote Config .
2. Чтобы сделать извлеченные значения параметров доступными для вашего приложения, вызовите метод ActivateFetched()

Шаг 7: Следите за обновлениями в режиме реального времени

После получения значений параметров вы можете использовать Remote Config в режиме реального времени для прослушивания обновлений из бэкенда Remote Config . Remote Config в режиме реального времени уведомляет подключенные устройства о наличии обновлений и автоматически извлекает изменения после публикации новой версии Remote Config .

Обновления в режиме реального времени поддерживаются Firebase C++ SDK v11.0.0+ и выше для платформ Android и Apple.

1. В вашем приложении вызовите AddOnConfigUpdateListener , чтобы начать прослушивание обновлений и автоматически приносить любые новые или обновленные значения параметров. В следующем примере прослушивает обновления и, когда Activate вызывается, использует вновь извлеченные значения для отображения обновленного приветственного сообщения.

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

В следующий раз, когда вы публикуете новую версию вашей Remote Config , устройств, которые запускают ваше приложение и прислушиваются к изменениям, вызовут обновление конфигурации.

Следующие шаги

Если вы еще этого не сделали, изучите варианты использования Remote Config и посмотрите на некоторые из ключевых концепций и документации «Расширенные стратегии», в том числе:

• Управлять версиями шаблона Remote Config
• Стратегии загрузки конфигурации