Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Premiers pas avec Firebase Remote Config

Vous pouvez utiliser Firebase Remote Config pour définir des paramètres dans votre application et mettre à jour leurs valeurs dans le cloud, ce qui vous permet de modifier l'apparence et le comportement de votre application sans distribuer de mise à jour d'application. Ce guide vous guide à travers les étapes pour commencer et fournit quelques exemples de code, tous qui est disponible pour clone ou téléchargement à partir du firebase / QuickStart-ios dépôt GitHub.

Ajouter la configuration à distance à votre application

  1. Installez le SDK Firebase pour iOS.

  2. Créez l'objet Singleton Remote Config, comme illustré dans l'exemple suivant :

    Rapide

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

    Objectif c

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

Cet objet est utilisé pour stocker les valeurs de paramètres par défaut dans l'application, récupérer les valeurs de paramètres mises à jour à partir du backend Remote Config et contrôler quand les valeurs récupérées sont mises à disposition de votre application.

Pendant le développement, il est recommandé de définir un intervalle d'extraction minimum relativement faible. Voir Throttling pour plus d' informations.

Définir les valeurs des paramètres par défaut dans l'application

Vous pouvez définir des valeurs de paramètre par défaut dans l'application dans l'objet Remote Config, afin que votre application se comporte comme prévu avant de se connecter au backend Remote Config et que les valeurs par défaut soient disponibles si aucune n'est définie dans le backend.

  1. Définir un ensemble de noms de paramètres et les valeurs des paramètres par défaut en utilisant un NSDictionary objet ou d' un fichier plist .
  2. Ajouter ces valeurs à l'objet Config à distance à l' aide setDefaults: . L'exemple suivant définit les valeurs par défaut de l'application à partir d'un fichier plist :

Rapide

remoteConfig.setDefaults(fromPlist: "RemoteConfigDefaults")

Objectif c

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

Obtenez les valeurs des paramètres à utiliser dans votre application

Vous pouvez maintenant obtenir les valeurs des paramètres à partir de l'objet Remote Config. Si vous définissez ultérieurement des valeurs dans le backend Remote Config, les récupérez, puis les activez, ces valeurs sont disponibles pour votre application. Dans le cas contraire, vous obtenez les valeurs des paramètres en application configurés à l' aide setDefaults: . Pour obtenir ces valeurs, appelez le configValueForKey: méthode, fournissant la clé de paramètre comme argument.

Définir les valeurs des paramètres

Utilisation de la console Firebase ou les API back - end Config à distance , vous pouvez créer de nouvelles valeurs par défaut de back - end qui remplacent les valeurs en application en fonction de votre logique conditionnelle ou de l' utilisateur cible souhaité. Cette section vous guide à travers les étapes de la console Firebase pour créer ces valeurs.

  1. Dans la console Firebase , ouvrez votre projet.
  2. Sélectionnez Config à distance dans le menu pour afficher le tableau de bord Config à distance.
  3. Définissez des paramètres portant les mêmes noms que les paramètres que vous avez définis dans votre application. Pour chaque paramètre, vous pouvez définir une valeur par défaut (qui remplacera éventuellement la valeur par défaut de l'application) et vous pouvez également définir des valeurs conditionnelles. Pour en savoir plus, reportez - vous à distance Config Paramètres et Conditions .

Récupérer et activer les valeurs

Pour extraire les valeurs des paramètres de configuration à distance, appelez le fetchWithCompletionHandler: ou fetchWithExpirationDuration:completionHandler: méthode. Toutes les valeurs que vous définissez sur le backend sont récupérées et mises en cache dans l'objet Remote Config.

Pour le cas où vous souhaitez chercher et activer des valeurs dans un appel, utilisez fetchAndActivateWithCompletionHandler: .

Cet exemple va chercher les valeurs de la configuration à distance back - end (non mis en cache des valeurs) et appelle activateWithCompletionHandler: pour les mettre à la disposition de l'application:

Rapide

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

Objectif 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];
}];

Étant donné que ces valeurs de paramètres mises à jour affectent le comportement et l'apparence de votre application, vous devez activer les valeurs récupérées à un moment qui garantit une expérience fluide pour votre utilisateur, comme la prochaine fois que l'utilisateur ouvre votre application. Voir les stratégies de chargement à distance Config pour plus d' informations et des exemples.

Étranglement

Si une application va chercher trop de fois dans un court laps de temps, les appels sont étranglées chercher et le retour du SDK FIRRemoteConfigFetchStatusThrottled . Avant la version 6.3.0 du SDK, la limite était de 5 requêtes d'extraction dans une fenêtre de 60 minutes (les versions plus récentes ont des limites plus permissives).

Pendant le développement de l'application, vous souhaiterez peut-être actualiser le cache très fréquemment (plusieurs fois par heure) pour vous permettre d'itérer rapidement au fur et à mesure que vous développez et testez votre application. Pour répondre à l' itération rapide sur un projet avec de nombreux développeurs, vous pouvez temporairement ajouter une FIRRemoteConfigSettings propriété avec un intervalle minimum faible récupération ( MinimumFetchInterval ) dans votre application.

L'intervalle d'extraction de production par défaut et recommandé pour la configuration à distance est de 12 heures, ce qui signifie que les configurations ne seront pas extraites du backend plus d'une fois dans une fenêtre de 12 heures, quel que soit le nombre d'appels d'extraction réellement effectués. Plus précisément, l'intervalle d'extraction minimum est déterminé dans l'ordre suivant :

  1. Le paramètre d' fetch(long)
  2. Le paramètre FIRRemoteConfigSettings.MinimumFetchInterval
  3. La valeur par défaut de 12 heures

Prochaines étapes

Si vous n'avez pas déjà, explorer les Config à distance des cas d'utilisation , et jeter un oeil à quelques - uns des concepts et des stratégies avancées clés de la documentation, y compris: