Ajouter Firebase à votre application Flutter


Prérequis

Si vous n'avez pas encore d'application Flutter, vous pouvez suivre la procédure Get Started: Test Drive (Premiers pas : Version d'évaluation) pour créer une application Flutter à l'aide de l'éditeur ou de l'IDE de votre choix.

Étape 1: Installez les outils de ligne de commande requis

  1. Si vous ne l'avez pas déjà fait, installez la CLI Firebase.

  2. Connectez-vous à Firebase à l'aide de votre compte Google en exécutant la commande suivante:

    firebase login
    
  3. 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.

Dans 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: Initialiser Firebase dans votre application

  1. Dans le répertoire de votre projet Flutter, exécutez la commande suivante pour installer le plug-in principal :

    flutter pub add firebase_core
    
  2. À 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
    
  3. Dans votre fichier lib/main.dart, importez le plug-in 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';
    
  4. Toujours dans votre fichier lib/main.dart, initialisez Firebase à l'aide de l'objet DefaultFirebaseOptions exporté par le fichier de configuration:

    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    runApp(const MyApp());
    
  5. Recréez 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 (qui devrait 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.).

Étant donné que Flutter est 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:

  1. Depuis le répertoire de votre projet Flutter, exécutez la commande suivante:

    flutter pub add PLUGIN_NAME
  2. 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.

  3. Une fois l'opération terminée, recompilez 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 Apple
(macOS, etc.)
Windows
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
Vertex AI in Firebase firebase_vertexai
bêta

Essayer un exemple d'application avec Analytics

Comme tous les packages, le plug-in firebase_analytics est fourni avec un exemple de programme.

  1. Ouvrez une application Flutter que vous avez déjà configurée pour utiliser Firebase (consultez les instructions sur cette page).

  2. Accédez au répertoire lib de l'application, puis supprimez le fichier main.dart existant.

  3. À 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
  4. Exécutez votre application Flutter.

  5. Accédez au projet Firebase de votre application dans la console Firebase, puis cliquez sur Analytics dans le menu de navigation de gauche.

    1. 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" (il peut s'écouler un certain temps avant que ce panneau ne soit renseigné).

    2. Cliquez sur DebugView (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 le Web.

Étapes suivantes