Ajouter Firebase à votre application Flutter
Prérequis
Installez l'éditeur ou l'IDE de votre choix.
Installez Flutter pour votre système d'exploitation, y compris les éléments suivants :
- SDK Flutter
- Bibliothèques d'assistance
- Logiciels et SDK spécifiques à la plate-forme
Connectez-vous à Firebase avec votre compte Google.
Si vous n'avez pas encore d'application Flutter, vous pouvez suivre le tutoriel de démarrage pour en créer une à l'aide de l'éditeur ou de l'IDE de votre choix.
Étape 1 : Installez les outils de ligne de commande requis
Si ce n'est pas déjà fait, installez la CLI Firebase.
Exécutez la commande suivante pour vous connecter à Firebase avec votre compte Google :
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 afin 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
Étape 3 : Initialisez Firebase dans votre application
Dans le répertoire de votre projet Flutter, exécutez la commande suivante pour installer le plug-in principal :
flutter pub add firebase_core
À partir du 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 plug-in Firebase Core 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';
Toujours dans votre fichier
lib/main.dart
, initialisez Firebase à l'aide de l'objetDefaultFirebaseOptions
exporté par le fichier de configuration :WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, ); runApp(const MyApp());
Recompilez votre application Flutter :
flutter run
Si vous préférez utiliser un projet de démonstration, vous pouvez démarrer l'émulateur Firebase et, dans votre fichier lib/main.dart
, initialiser Firebase à l'aide de demoProjectId
(il doit commencer par demo-
) :
await Firebase.initializeApp(
demoProjectId: "demo-project-id",
);
Étape 4 : Ajouter des plug-ins Firebase
Vous accédez à Firebase dans votre application Flutter via les différents plug-ins Firebase Flutter, un pour chaque produit Firebase (par exemple, Cloud Firestore, Authentication, Analytics, etc.).
Flutter étant un framework multiplate-forme, chaque plug-in Firebase s'applique aux plates-formes Apple, Android et Web. Par conséquent, si vous ajoutez un plug-in Firebase à votre application Flutter, il sera utilisé par les versions Apple, Android et Web de votre application.
Voici comment ajouter un plug-in 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 plug-ins Gradle requis à votre application.
Une fois l'opération terminée, recréez votre projet Flutter :
flutter run
C’est terminé ! Vos applications Flutter sont enregistrées et configurées pour utiliser Firebase.
Plug-ins disponibles
Produit | Nom du plug-in | iOS | Android | Web | Autre produit Apple (macOS, etc.) |
Windows |
---|---|---|---|---|---|---|
Firebase AI Logic 1 | firebase_ai |
bêta | ||||
Analytics | firebase_analytics |
bêta | ||||
App Check | firebase_app_check |
bêta | ||||
Authentication | firebase_auth |
bêta | bêta | |||
Cloud Firestore | cloud_firestore |
bêta | bêta | |||
Cloud Functions | cloud_functions |
bêta | ||||
Cloud Messaging | firebase_messaging |
bêta | ||||
Cloud Storage | firebase_storage |
bêta | bêta | |||
Crashlytics | firebase_crashlytics |
bêta | ||||
Data Connect | firebase_data_connect |
|||||
Dynamic Links | firebase_dynamic_links |
|||||
In-App Messaging | firebase_in_app_messaging |
|||||
Firebase installations | firebase_app_installations |
bêta | ||||
Téléchargeur de modèles de ML | firebase_ml_model_downloader |
bêta | ||||
Performance Monitoring | firebase_performance |
|||||
Realtime Database | firebase_database |
bêta | ||||
Remote Config | firebase_remote_config |
bêta |
1 Firebase AI Logic s'appelait auparavant
"Vertex AI in Firebase" avec le plug-in
firebase_vertexai
.
Essayer une application exemple avec Analytics
Comme tous les packages, le plug-in firebase_analytics
est fourni avec un exemple de programme.
Ouvrez une application Flutter que vous avez déjà configurée pour utiliser Firebase (consultez 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 de l'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 panneau 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" (le remplissage de ce panneau peut prendre un certain temps).
Cliquez sur DebugView. Activez la fonctionnalité pour afficher tous les événements générés par l'exemple de programme.
Pour en savoir plus sur la configuration de Analytics, consultez les guides de démarrage pour iOS+, Android et Web.
Étapes suivantes
Familiarisez-vous avec l'atelier de programmation Firebase Flutter.
Préparez-vous à lancer votre application :
- Configurez des alertes budgétaires pour votre projet dans la console Google Cloud.
- Surveillez le tableau de bord "Utilisation et facturation" de la console Firebase pour obtenir une vue d'ensemble de l'utilisation de votre projet dans plusieurs services Firebase.
- Consultez la checklist de lancement de Firebase.