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

Ajouter Firebase à votre application Flutter

Suivez ce guide pour ajouter des produits Firebase à une application Flutter.

Conditions préalables

  • Installez votre préféré éditeur ou IDE .

  • Assurez-vous que votre application Flutter cible les versions de plate-forme suivantes ou ultérieures :

    • iOS 10
    • macOS 10.12
  • Configurez un appareil Apple physique ou un simulateur pour exécuter votre application.

    • Pour Cloud Messaging, effectuez les tâches suivantes :

      • Configurez un appareil Apple physique.
      • Obtenir un Apple Push Notification clé d' authentification pour votre compte Apple Developer .
      • Activer les notifications Push dans XCode sous App> Capacités.
    • Pour tous les autres produits Firebase, vous pouvez utiliser un appareil iOS physique ou le simulateur iOS.

  • Installer Flutter pour votre système d'exploitation spécifique, y compris les éléments suivants:

    • SDK Flutter
    • Bibliothèques de soutien
    • Logiciels et SDK spécifiques à la plate-forme
  • Connectez - vous à Firebase en utilisant votre compte Google.

Si vous ne l' avez pas déjà une application Flutter, vous pouvez compléter le commencer: Test Drive pour créer une nouvelle application Flutter utilisant votre éditeur favori ou IDE.

Étape 1: Créer un projet Firebase

Avant de pouvoir ajouter Firebase à votre application Flutter, vous devez créer un projet Firebase pour vous connecter à votre application. Visitez Comprendre Firebase projets pour en savoir plus sur les projets Firebase.

Étape 2: Enregistrez votre application avec Firebase

  1. Au centre de la page d'aperçu du projet de la console Firebase , cliquez sur l'icône iOS + ( ) pour lancer le flux de travail de configuration.

    Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter application pour afficher les options de plate - forme.

  2. Entrez votre application ID paquet dans le paquet iOS champ ID.

    Trouvez cet ID de bundle à partir de votre projet ouvert dans XCode. Sélectionnez l'application de niveau supérieur dans le navigateur de projet, puis accéder à l'onglet Général. La valeur Identifiant Bundle est l'ID de paquet iOS (par exemple, com.yourcompany.ios-app-name ).

  3. (Facultatif) Entrez les autres informations de l' application que vous y êtes invité par le flux de travail de configuration.

  4. Cliquez sur l' application de vous inscrire.

Étape 3: Ajouter un fichier de configuration Firebase

  1. Cliquez sur Télécharger GoogleService-Info.plist pour obtenir votre fichier de plates - formes d' Apple Firebase ( GoogleService-Info.plist ).

  2. En utilisant Xcode, déplacer le fichier dans le Runner/Runner répertoire de votre application Flutter.

  3. Retour dans le flux de travail de configuration de la console Firebase, cliquez sur Suivant pour sauter les étapes restantes.

  4. Continuer à ajouter des plugins FlutterFire .

Étape 4: Ajouter des plugins FlutterFire

Flutter utilisations plugins pour fournir un accès à un large éventail de services spécifiques à la plateforme, tels que les API Firebase. Les plugins incluent un code spécifique à la plate-forme pour accéder aux services et aux API sur chaque plate-forme.

Firebase est accessible via un certain nombre de bibliothèques différentes, une pour chaque produit Firebase (par exemple : base de données en temps réel, authentification, analyse ou stockage cloud). Flutter fournit un ensemble de plug - ins, Firebase qui sont appelés collectivement FlutterFire.

Étant donné que Flutter est un SDK multiplateforme, chaque plug-in FlutterFire est applicable aux plates-formes Apple et Android. Ainsi, si vous ajoutez un plug-in FlutterFire à votre application Flutter, il sera utilisé à la fois par les versions Apple et Android de votre application Firebase.

Assurez - vous de vérifier les FlutterFire docs pour la liste la plus à jour des plug - ins FlutterFire.

  1. Assurez-vous que votre application n'est pas en cours d'exécution dans votre émulateur ou sur votre appareil.

  2. A partir du répertoire racine de votre application Flutter, ouvrez votre pubspec.yaml fichier.

  3. Ajouter le plugin FlutterFire pour le Firebase de base SDK Flutter .

    dependencies:
      flutter:
        sdk: flutter
      # Add the dependency for the Firebase Core Flutter SDK
      firebase_core: ^0.4.0+9
    
  4. Ajouter les plugins FlutterFire pour les produits que vous Firebase souhaitez utiliser dans votre application.

    Analytics activé

    dependencies:
      flutter:
        sdk: flutter
      # Check that you have this dependency (added in the previous step)
      firebase_core: ^0.4.0+9
    # Add the dependency for the FlutterFire plugin for Google Analytics firebase_analytics: ^5.0.2
    # Add the dependencies for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore firebase_auth: ^0.14.0+5 cloud_firestore: ^0.12.9+5

    Analytics non activé

    dependencies:
      flutter:
        sdk: flutter
      # Check that you have this dependency (added in the previous step)
      firebase_core: ^0.4.0+9
    # Add the dependencies for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore firebase_auth: ^0.14.0+5 cloud_firestore: ^0.12.9+5
  5. Exécuter des flutter packages get .
    Pour plus d' informations sur la gestion des packages et des plug - ins, reportez - vous à l' aide de packages .

  6. Si vous avez ajouté Analytics, exécutez votre application pour envoyer la vérification à Firebase que vous avez bien intégré Firebase. Sinon, vous pouvez ignorer l'étape de vérification.

Vous êtes prêt ! Votre application Flutter est enregistrée et configurée pour utiliser Firebase.

Essayez un exemple d'application avec Analytics

Comme tous les paquets, les firebase_analytics du plugin est livré avec un exemple de programme .

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

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

  3. Dans l' application Google Analytics dépôt de programme par lib exemple , copier-coller les deux fichiers suivants dans votre application lib répertoire:

    • main.dart
    • tabs_page.dart
  4. Exécutez votre application Flutter.

  5. Accédez à votre projet d'application Firebase dans la console Firebase , puis cliquez sur Analytics dans la 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 Analytics, consultez les guides de démarrage pour iOS + et pour Android .

Prochaines étapes