Вы можете использовать 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 в свое приложение
андроид
После добавления Firebase в ваше приложение:
Создайте приложение Firebase, передав среду JNI и Activity:
app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
Инициализируйте библиотеку Remote Config , как показано:
::firebase::remote_config::Initialize(app);
iOS+
После добавления Firebase в ваше приложение:
Создайте приложение Firebase:
app = ::firebase::App::Create(::firebase::AppOptions());
Инициализируйте библиотеку Remote Config , как показано:
::firebase::remote_config::Initialize(app);
Шаг 3: Установите значения параметров приложения по умолчанию
Вы можете задать значения параметров приложения по умолчанию в объекте Remote Config , чтобы ваше приложение вело себя так, как задумано, до того, как оно подключится к бэкэнду Remote Config , и чтобы были доступны значения по умолчанию, если на бэкэнде ничего не установлено.
Определите набор имен параметров и значений параметров по умолчанию, используя объект
ConfigKeyValue*
или объектConfigKeyValueVariant*
с размером массива.Если вы уже настроили значения параметров бэкэнда Remote Config , вы можете загрузить файл, содержащий эти пары ключ/значение, и использовать его для построения объекта
map
. Для получения дополнительной информации см. Загрузка шаблонов Remote Config по умолчанию .Добавьте эти значения в объект Remote Config с помощью
SetDefaults()
.
Шаг 4: Получите значения параметров для использования в вашем приложении.
Теперь вы можете получить значения параметров из объекта Remote Config . Если вы задали значения в бэкэнде Remote Config , извлекли их и затем активировали, эти значения доступны вашему приложению. В противном случае вы получите значения параметров в приложении, настроенные с помощью SetDefaults()
.
Чтобы получить эти значения, вызовите указанный ниже метод, который сопоставляется с типом данных, ожидаемым вашим приложением, указав ключ параметра в качестве аргумента:
Шаг 5: Установите значения параметров
- В консоли Firebase откройте свой проект.
- Выберите Remote Config в меню, чтобы просмотреть панель управления Remote Config .
- Определите параметры с теми же именами, что и параметры, которые вы определили в своем приложении. Для каждого параметра можно задать значение по умолчанию (которое в конечном итоге переопределит значение по умолчанию в приложении) и условные значения. Чтобы узнать больше, см. Параметры и условия Remote Config .
Шаг 6: Извлечение и активация значений
- Чтобы получить значения параметров из бэкэнда Remote Config , вызовите метод
Fetch()
. Любые значения, которые вы устанавливаете на бэкэнде, извлекаются и кэшируются в объекте Remote Config . - Чтобы сделать извлеченные значения параметров доступными для вашего приложения, вызовите
ActivateFetched()
Шаг 7: Следите за обновлениями в режиме реального времени
После того, как вы получите значения параметров, вы можете использовать Remote Config в реальном времени для прослушивания обновлений из Remote Config . Remote Config в реальном времени на подключенные устройства, когда доступны обновления, и автоматически получает изменения после публикации новой версии Remote Config .
Обновления в реальном времени поддерживаются Firebase C++ SDK V11.0.0+ и выше для платформ Android и Apple.
- В вашем приложении вызовите
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 и посмотрите на некоторые из ключевых концепций и документации «Расширенные стратегии», в том числе: