Cette page a été traduite par l'API Cloud Translation.

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 de démarrage et fournit un exemple de code.

Étape 1 : Ajoutez Firebase et le SDK de configuration à distance à votre application

Installez et initialisez les SDK Firebase pour Flutter si vous ne l'avez pas déjà fait.
Pour Remote Config, Google Analytics est requis pour le ciblage conditionnel des instances d'application sur les propriétés et les audiences des utilisateurs. Assurez-vous d' avoir activé Google Analytics dans votre projet.
Depuis le répertoire racine de votre projet Flutter, exécutez la commande suivante pour installer le plugin Remote Config :
```
flutter pub add firebase_remote_config
```
De plus, dans le cadre de la configuration de Remote Config, vous devez ajouter le SDK Firebase pour Google Analytics à votre application :
```
flutter pub add firebase_analytics
```
Reconstruisez votre projet :
```
flutter run
```

Étape 2 : Obtenir l'objet singleton Remote Config

Obtenez une instance d'objet Remote Config et définissez l'intervalle de récupération minimal pour permettre des actualisations fréquentes :

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(hours: 1),
));

L'objet singleton est utilisé pour stocker les valeurs de paramètre par défaut de l'application, récupérer les valeurs de paramètre mises à jour à partir du backend et contrôler le moment où les valeurs récupérées sont mises à la disposition de votre application.

Au cours du développement, il est recommandé de définir un intervalle d'extraction minimal relativement faible. Voir Limitation pour plus d'informations.

Étape 3 : 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 pour que les valeurs par défaut soient disponibles si aucune n'est définie dans le backend.

await remoteConfig.setDefaults(const {
    "example_param_1": 42,
    "example_param_2": 3.14159,
    "example_param_3": true,
    "example_param_4": "Hello, world!",
});

Étape 4 : Obtenir les valeurs des paramètres à utiliser dans votre application

Vous pouvez maintenant obtenir des valeurs de paramètre à partir de l'objet Remote Config. Si vous définissez des valeurs dans le backend, les récupérez, puis les activez, ces valeurs sont disponibles pour votre application. Sinon, vous obtenez les valeurs des paramètres intégrés à l'application configurées à 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 :

getBool()
getDouble()
getInt()
getString()

Étape 5 : Définissez les valeurs des paramètres dans le backend Remote Config

À l'aide de la console Firebase ou des API backend de Remote Config , vous pouvez créer de nouvelles valeurs par défaut côté serveur qui remplacent les valeurs de l'application en fonction de la logique conditionnelle ou du ciblage utilisateur que vous souhaitez. Cette section décrit les étapes de la console Firebase pour créer ces valeurs.

Dans la console Firebase , ouvrez votre projet.
Sélectionnez Remote Config dans le menu pour afficher le tableau de bord Remote Config.
Définissez des paramètres avec 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 finira par remplacer la valeur par défaut correspondante dans l'application), et vous pouvez également définir des valeurs conditionnelles. Pour en savoir plus, consultez Paramètres et conditions de configuration à distance .

Étape 6 : Récupérer et activer les valeurs

Pour récupérer les valeurs des paramètres à partir du backend Remote Config, appelez la méthode fetch() . Toutes les valeurs que vous définissez dans le backend sont extraites et stockées dans l'objet Remote Config.
Pour rendre les valeurs de paramètre récupérées disponibles pour votre application, appelez la méthode activate() .
Dans les cas où vous souhaitez récupérer et activer des valeurs en un seul appel, vous pouvez utiliser une requête fetchAndActivate() pour récupérer les valeurs du backend Remote Config et les rendre disponibles pour l'application :
```
await remoteConfig.fetchAndActivate();
```

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

Étranglement

Si une application récupère trop de fois sur une courte période, les appels de récupération seront limités et la valeur de la propriété lastFetchStatus de FirebaseRemoteConfig sera RemoteConfigFetchStatus.throttle .

L'intervalle de récupération minimum par défaut pour Remote Config est de 12 heures, ce qui signifie que les configurations ne seront pas récupérées plus d'une fois depuis le backend dans une fenêtre de 12 heures, quel que soit le nombre d'appels de récupération réellement effectués.

Pendant le développement de l'application, vous souhaiterez peut-être récupérer et activer les configurations 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 permettre une itération rapide sur un projet avec jusqu'à 10 développeurs, vous pouvez temporairement définir un intervalle d'extraction minimum faible avec setConfigSettings() .

final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(minutes: 1),
    minimumFetchInterval: const Duration(minutes: 5),
));

Prochaines étapes

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: