Интеграция Firebase Remote Config в мобильное приложение

Интеграция Firebase Remote Config в мобильное приложение

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

Как работает Remote Config под капотом

Remote Config — это Key-Value хранилище с серверной стороной в Firebase Console и клиентским SDK на iOS/Android/Flutter. При старте приложение запрашивает свежие значения, Firebase возвращает JSON-пакет, SDK кэширует его локально. Если сеть недоступна — используются последние закэшированные значения или встроенные дефолты.

Ключевой момент: fetch() и activate() — это два отдельных действия. fetch скачивает конфиг в staging-кэш, activate применяет его в рантайме. Разделение сделано намеренно — чтобы не ломать текущую сессию пользователя применением нового конфига прямо посреди работы.

// iOS, Swift
let remoteConfig = RemoteConfig.remoteConfig()

let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600 // в проде — 1 час, в дебаге можно 0
remoteConfig.configSettings = settings

// Дефолты — обязательны, иначе до первого fetch значения nil
remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")

remoteConfig.fetchAndActivate { status, error in
    if status == .successFetchedFromRemote || status == .successUsingPreFetchedData {
        let buttonColor = remoteConfig["promo_button_color"].stringValue ?? "#FF5722"
        DispatchQueue.main.async { self.applyConfig(buttonColor) }
    }
}

На Android через Kotlin:

val remoteConfig = Firebase.remoteConfig
remoteConfig.setConfigSettingsAsync(remoteConfigSettings {
    minimumFetchIntervalInSeconds = 3600
})
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

remoteConfig.fetchAndActivate().addOnCompleteListener { task ->
    if (task.isSuccessful) {
        val threshold = remoteConfig.getLong("free_delivery_threshold")
        updateCartUI(threshold)
    }
}

Где ломается на практике

Кэш и minimumFetchInterval. В продакшне Firebase жёстко ограничивает частоту запросов: 5 fetch-запросов в час на одно устройство. Превышение возвращает ThrottledException. Команды часто натыкаются на это в QA: тестировщик обновляет значение в консоли, но приложение продолжает показывать старые данные. Решение — в debug-сборках ставить minimumFetchIntervalInSeconds = 0, а в prod оставлять 3600.

Дефолты не заданы. Если до первого успешного fetch (например, при отсутствии интернета) обратиться к ключу без дефолта — получите nil или пустую строку. Приложение не крашится, но поведение непредсказуемо. Дефолты обязаны покрывать все ключи, которые использует приложение.

Состояние гонки при запуске. fetchAndActivate — асинхронный. Если UI рисуется раньше, чем завершится fetch, пользователь видит дефолтные значения. Для критичных параметров (например, флаг показа paywall) лучше загружать конфиг ещё на сплэш-экране и блокировать переход до получения ответа — с таймаутом 2–3 секунды.

Условные значения и сегментация

Настоящая сила Remote Config — conditions. Можно задавать разные значения для:

• конкретных версий приложения (app_version < 2.5.0)
• платформы (iOS vs Android)
• страны пользователя
• произвольного user_property, заданного через Firebase Analytics

Например, показывать новый onboarding только пользователям iOS 16+ в России — без отдельного релиза.

Что входит в работу

• Подключение Firebase SDK (через SPM на iOS, Gradle на Android, firebase_remote_config на Flutter)
• Настройка RemoteConfigSettings с правильными интервалами для debug/release
• Файл дефолтов, покрывающий все ключи
• Хелпер-класс с типизированным доступом к значениям (без строковых ключей в коде)
• Интеграция с точкой инициализации приложения (AppDelegate / Application)

Сроки

Базовая интеграция с типизированным хелпером: 1 день. Стоимость рассчитывается индивидуально после анализа требований.