Catch up on everthing we announced at this year's Firebase Summit. Learn more

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.

La bibliothèque Remote Config est utilisée 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 à la disposition de votre application. Pour en savoir plus, voir les stratégies de chargement à distance Config .

Ajouter Firebase à votre application

Avant de pouvoir utiliser Config à distance , vous devez:

  • Enregistrez votre projet C++ et configurez-le pour utiliser Firebase.

    Si votre projet C++ utilise déjà Firebase, il est déjà enregistré et configuré pour Firebase.

  • Ajouter le Firebase C ++ SDK à votre projet C de.

Notez que l' ajout Firebase à votre projet C ++ implique des tâches à la fois dans la console Firebase et dans votre projet open C ++ (par exemple, vous téléchargez des fichiers de configuration Firebase de la console, puis les déplacer dans votre projet C ++).

Ajouter la configuration à distance à votre application

Android

Après avoir ajouté Firebase à votre application :

  1. Créer une application Firebase, en passant dans l'environnement JNI et activité:

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

  2. Initialiser la bibliothèque Config à distance, comme le montre:

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

iOS+

Après avoir ajouté Firebase à votre application :

  1. Créer un Firebase App:

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

  2. Initialiser la bibliothèque Config à distance, comme le montre:

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

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 afin que les valeurs par défaut soient disponibles si aucune n'est définie sur le backend.

  1. Définir un ensemble de noms de paramètres et les valeurs des paramètres par défaut en utilisant un std::map<const char*, const char*> objet ou un std::map<const char*, firebase::Variant> objet.
  2. Ajouter ces valeurs à l'objet Config à distance à l' aide SetDefaults() .

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 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 la méthode répertoriée ci-dessous qui correspond au type de données attendu par votre application, en fournissant la clé de paramètre comme argument :

Connectez votre application dans la console Firebase

Dans la console Firebase , ajoutez votre application à votre projet Firebase.

Définir les valeurs des paramètres

  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 des valeurs conditionnelles. Pour en savoir plus, voir les paramètres Config à distance et les conditions .

Récupérer et activer les valeurs

  1. Pour extraire les valeurs des paramètres du back - end Config à distance, appelez le Fetch() 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 ActivateFetched()

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: