Начало работы с Firebase Remote Config на прошивке

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

Это руководство проведет вас через шаги , чтобы начать работу и предоставляет некоторые примеры кода, все из которых доступно для клона или загрузить с firebase / QuickStart-ИСНОМ GitHub хранилища.

Добавить Удаленная настройка для вашего приложения

Установите Firebase SDK для IOS.
Примечание: При установке IOS SDK, у вас есть возможность добавить зависимость для Analytics. Аналитика требуется для удаленного Config в условном нацеливания экземпляров приложения для пользовательских свойств, аудиторий и Firebase Предсказания.

Создание одноэлементного Удаленный объект Config, как показано в следующем примере:

стриж

remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 0
remoteConfig.configSettings = settings ViewController.swift

Objective-C

self.remoteConfig = [FIRRemoteConfig remoteConfig];
FIRRemoteConfigSettings *remoteConfigSettings = [[FIRRemoteConfigSettings alloc] init];
remoteConfigSettings.minimumFetchInterval = 0;
self.remoteConfig.configSettings = remoteConfigSettings; ViewController.m

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

Во время разработки, рекомендуется установить относительно низкий минимальный интервал выборки. См дросселирования для получения дополнительной информации.

Значения параметров по умолчанию указано в приложениях

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

Определить набор имен параметров и значений параметров по умолчанию , используя NSDictionary объект или файл Plist .
Добавьте эти значения к удаленному объекту Config , используя SetDefaults: . Следующий пример устанавливает значения по умолчанию в приложении из plist файла:

стриж

remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults") ViewController.swift

Objective-C

[self.remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"]; ViewController.m

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

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

Заданные значения параметров

Использование Firebase консоли или удаленного API - интерфейсы бэкэнд Config , вы можете создавать новые значения бэкенд по умолчанию , которые переопределяют значения в приложении в соответствии с нужной условной логики или пользовательский таргетинг. Этот раздел проведет вас через Firebase шагов консоли, чтобы создать эти значения.

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

Fetch и активировать значение

Для извлечения значения параметров из удаленного Config, вызовите fetchWithCompletionHandler: или fetchWithExpirationDuration: completionHandler: метод. Любые значения, установленные на внутреннем интерфейсе извлекаются и кэшируются в удаленном объекте Config.

В тех случаях , когда вы хотите , чтобы принести и активизируют значения в одном вызове, используйте fetchAndActivateWithCompletionHandler: .

Этот пример извлекает значения из удаленного внутреннего интерфейса Config (не кэшируются значения) и вызывает activateWithCompletionHandler: чтобы сделать их доступными для приложения:

стриж

remoteConfig.fetch() { (status, error) -> Void in
  if status == .success {
    print("Config fetched!")
    self.remoteConfig.activate() { (changed, error) in
      // ...
    }
  } else {
    print("Config not fetched")
    print("Error: \(error?.localizedDescription ?? "No error available.")")
  }
  self.displayWelcome()
} ViewController.swift

Objective-C

[self.remoteConfig fetchWithCompletionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
    if (status == FIRRemoteConfigFetchStatusSuccess) {
        NSLog(@"Config fetched!");
      [self.remoteConfig activateWithCompletion:^(BOOL changed, NSError * _Nullable error) {
        // ...
      }];
    } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
    }
    [self displayWelcome];
}]; ViewController.m

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

Дроссельный

Если приложение получает слишком много раз в течение короткого периода времени, получать вызовы задушили и возвращает SDK FIRRemoteConfigFetchStatusThrottled . До SDK версии 6.3.0, лимит был 5 выборки запросов в 60 минут окно (более новые версии имеют более разрешительные ограничения).

Во время разработки приложения, вы можете обновить кэш очень часто (несколько раз в час), чтобы позволить вам быстро итерацию по мере разработки и тестирования приложений. Для размещения быстрой итерации проекта с многочисленными разработчиками, вы можете временно добавить FIRRemoteConfigSettings свойства с низким минимумом выборкой интервала ( MinimumFetchInterval ) в вашем приложении.

По умолчанию и рекомендуемым производство выборки интервала для удаленного Config 12 часов, что означает, что конфиги не будет извлекаться из внутреннего интерфейса более чем один раз в 12 часа окне, независимо от того, сколько выборки звонков на самом деле сделаны. В частности, минимальный интервал выборки определяется в этом следующем порядке:

Параметр fetch(long)
Параметр FIRRemoteConfigSettings.MinimumFetchInterval
Значение по умолчанию 12 часов

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

Если вы уже не имеете, изучить Удаленная настройка вариантов использования , и взглянуть на некоторые из ключевых концепций и передовых стратегий документации, в том числе:

Шаблоны и управления версиями
Стратегии загрузки Config