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-js dépôt GitHub.

Ajouter la configuration à distance à votre application

  1. Installez le SDK Firebase pour le Web.

  2. Créez l'objet de configuration distante singleton :

    Web version 9

    import { getRemoteConfig } from "firebase/remote-config";
    
    const remoteConfig = getRemoteConfig();

    Web version 8

    const remoteConfig = firebase.remoteConfig();

    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.

  3. Définissez un intervalle d'extraction minimal :

    Web version 9

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    Web version 8

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

    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 sur le backend.

Web version 9

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

Web version 8

remoteConfig.defaultConfig = {
  "welcome_message": "Welcome"
};

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, les récupérez, puis les activez, ces valeurs sont disponibles pour votre application. Pour obtenir ces valeurs, appelez le getValue() méthode, fournissant la clé de paramètre comme argument.

Web version 9

import { getValue } from "firebase/remote-config";

const val = getValue(remoteConfig, "welcome_messsage");

Web version 8

const val = remoteConfig.getValue("welcome_messsage");

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 du côté du serveur 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

  1. Pour extraire les valeurs des paramètres du back - end Config à distance, appelez le fetchConfig() 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.
  2. Pour les valeurs des paramètres disponibles à votre extraites application, appelez le activate() méthode.

Pour le cas où vous souhaitez chercher et activer des valeurs dans un appel, utilisez fetchAndActivate() comme indiqué dans cet exemple:

Web version 9

import { fetchAndActivate } from "firebase/remote-config";

fetchAndActivate(remoteConfig)
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

Web version 8

remoteConfig.fetchAndActivate()
  .then(() => {
    // ...
  })
  .catch((err) => {
    // ...
  });

É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 est récupérée trop de fois sur une courte période, les appels de récupération peuvent être limités. Dans de tels cas, le SDK lance une FETCH_THROTTLE erreur. Il est recommandé de détecter cette erreur et de réessayer en mode d'interruption exponentielle, en attendant des intervalles plus longs entre les demandes d'extraction suivantes.

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 ajouter temporairement une propriété avec un intervalle minimum (chercher faible Settings.minimumFetchIntervalMillis ) 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 Settings.minimumFetchIntervalMillis .
  2. 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: