Ajoutez Firebase à votre application Flutter
Conditions préalables
Installez votre éditeur ou IDE préféré.
Installez Flutter pour votre système d'exploitation spécifique, notamment les éléments suivants :
- SDK Flutter
- Bibliothèques de support
- Logiciels et SDK spécifiques à la plate-forme
Connectez-vous à Firebase à l'aide de votre compte Google.
Si vous ne disposez pas déjà d'une application Flutter, vous pouvez terminer la procédure de démarrage : essai routier pour créer une nouvelle application Flutter à l'aide de votre éditeur ou IDE préféré.
Étape 1 : Installez les outils de ligne de commande requis
Si vous ne l'avez pas déjà fait, installez la CLI Firebase .
Connectez-vous à Firebase à l'aide de votre compte Google en exécutant la commande suivante :
firebase login
Installez la CLI FlutterFire en exécutant la commande suivante à partir de n'importe quel répertoire :
dart pub global activate flutterfire_cli
Étape 2 : Configurez vos applications pour utiliser Firebase
Utilisez la CLI FlutterFire pour configurer vos applications Flutter pour qu'elles se connectent à Firebase.
Depuis le répertoire de votre projet Flutter, exécutez la commande suivante pour démarrer le workflow de configuration de l'application :
flutterfire configure
Le workflow
flutterfire configure
effectue les opérations suivantes :
Vous demande de sélectionner les plateformes (iOS, Android, Web) prises en charge dans votre application Flutter. Pour chaque plate-forme sélectionnée, la CLI FlutterFire crée une nouvelle application Firebase dans votre projet Firebase.
Vous pouvez choisir d'utiliser un projet Firebase existant ou de créer un nouveau projet Firebase. Si vous avez déjà des applications enregistrées dans un projet Firebase existant, la CLI FlutterFire tentera de les faire correspondre en fonction de la configuration actuelle de votre projet Flutter.
Crée un fichier de configuration Firebase (
firebase_options.dart
) et l'ajoute à votre répertoirelib/
.(pour Crashlytics ou Performance Monitoring sur Android) Ajoute les plugins Gradle spécifiques au produit requis à votre application Flutter.
Étape 3 : Initialisez Firebase dans votre application
Depuis le répertoire de votre projet Flutter, exécutez la commande suivante pour installer le plugin principal :
flutter pub add firebase_core
Depuis le répertoire de votre projet Flutter, exécutez la commande suivante pour vous assurer que la configuration Firebase de votre application Flutter est à jour :
flutterfire configure
Dans votre fichier
lib/main.dart
, importez le plugin principal Firebase et le fichier de configuration que vous avez généré précédemment :import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
Également dans votre fichier
lib/main.dart
, initialisez Firebase à l'aide de l'objetDefaultFirebaseOptions
exporté par le fichier de configuration :await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Reconstruisez votre application Flutter :
flutter run
Étape 4 : Ajouter les plugins Firebase
Vous accédez à Firebase dans votre application Flutter via les différents plugins Firebase Flutter , un pour chaque produit Firebase (par exemple : Cloud Firestore, Authentication, Analytics, etc.).
Étant donné que Flutter est un framework multiplateforme, chaque plugin Firebase est applicable aux plateformes Apple, Android et Web. Ainsi, si vous ajoutez un plugin Firebase à votre application Flutter, il sera utilisé par les versions Apple, Android et Web de votre application.
Voici comment ajouter un plugin Firebase Flutter :
Depuis le répertoire de votre projet Flutter, exécutez la commande suivante :
flutter pub add PLUGIN_NAME
Depuis le répertoire de votre projet Flutter, exécutez la commande suivante :
flutterfire configure
L'exécution de cette commande garantit que la configuration Firebase de votre application Flutter est à jour et, pour Crashlytics et Performance Monitoring sur Android, ajoute les plugins Gradle requis à votre application.
Une fois terminé, reconstruisez votre projet Flutter :
flutter run
Vous êtes prêt ! Vos applications Flutter sont enregistrées et configurées pour utiliser Firebase.
Plugins disponibles
Produit | Nom du plugin | IOS | Android | la toile | Autre pomme (macOS, etc.) | les fenêtres |
---|---|---|---|---|---|---|
Analytique | firebase_analytics | bêta | ||||
Vérification de l'application | firebase_app_check | bêta | ||||
Authentification | firebase_auth | bêta | bêta | |||
Cloud Firestore | cloud_firestore | bêta | bêta | |||
Fonctions cloud | cloud_functions | bêta | ||||
Messagerie cloud | firebase_messaging | bêta | ||||
Stockage en ligne | firebase_storage | bêta | bêta | |||
Crashlytiques | firebase_crashlytics | bêta | ||||
Liens dynamiques | firebase_dynamic_links | |||||
Messagerie intégrée à l'application | firebase_in_app_messaging | |||||
Installations Firebase | firebase_app_installations | bêta | ||||
Téléchargeur de modèles ML | firebase_ml_model_downloader | bêta | ||||
Suivi de la performance | firebase_performance | |||||
Base de données en temps réel | firebase_database | bêta | ||||
Configuration à distance | firebase_remote_config | bêta |
Essayez un exemple d'application avec Analytics
Comme tous les packages, le plugin firebase_analytics
est livré avec un exemple de programme .
Ouvrez une application Flutter que vous avez déjà configurée pour utiliser Firebase (voir les instructions sur cette page).
Accédez au répertoire
lib
de l'application, puis supprimez le fichiermain.dart
existant.À partir du dépôt d'exemple de programme Google Analytics, copiez-collez les deux fichiers suivants dans le répertoire
lib
de votre application :-
main.dart
-
tabs_page.dart
-
Exécutez votre application Flutter.
Accédez au projet Firebase de votre application dans la console Firebase , puis cliquez sur Analytics dans le menu de navigation de gauche.
Cliquez sur Tableau de bord . Si Analytics fonctionne correctement, le tableau de bord affiche un utilisateur actif dans le panneau « Utilisateurs actifs au cours des 30 dernières minutes » (cela peut prendre du temps pour remplir ce panneau).
Cliquez sur DebugView . Activez la fonctionnalité pour voir tous les événements générés par l'exemple de programme.
Pour plus d'informations sur la configuration d'Analytics, consultez les guides de démarrage pour iOS+ , Android et Web .
Prochaines étapes
Bénéficiez d'une expérience pratique avec le Firebase Flutter Codelab .
Préparez-vous à lancer votre application :
- Configurez des alertes budgétaires pour votre projet dans la console Google Cloud.
- Surveillez le tableau de bord d'utilisation et de facturation dans la console Firebase pour obtenir une image globale de l'utilisation de votre projet sur plusieurs services Firebase.
- Consultez la liste de contrôle de lancement de Firebase .