Check out what’s new from Firebase at Google I/O 2022. Learn more

Начните работу с Firebase Remote Config

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

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

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

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

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

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

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

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

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

Андроид

После того, как вы добавили Firebase в свое приложение:

  1. Создайте приложение Firebase, передав среду JNI и действие:

    app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);
    .

  2. Инициализируйте библиотеку Remote Config, как показано ниже:

    ::firebase::remote_config::Initialize(app);
    .

iOS+

После того, как вы добавили Firebase в свое приложение:

  1. Создайте приложение Firebase:

    app = ::firebase::App::Create(::firebase::AppOptions());

  2. Инициализируйте библиотеку Remote Config, как показано ниже:

    ::firebase::remote_config::Initialize(app);
    .

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

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

  1. Определите набор имен параметров и значений параметров по умолчанию, используя объект std::map<const char*, const char*> или объект std::map<const char*, firebase::Variant> .

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

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

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

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

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

Подключите свое приложение в консоли Firebase

В консоли Firebase добавьте свое приложение в проект Firebase.

Установить значения параметров

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

Получить и активировать значения

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

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

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