Premiers pas avec Realtime Database

Prérequis

  1. Installez firebase_core et ajoutez le code d'initialisation à votre application si ce n'est pas déjà fait.
  2. Ajoutez votre application à votre projet Firebase dans la console Firebase.

Créer une base de données

  1. Accédez à la section Realtime Database de la console Firebase. Vous serez invité à sélectionner un projet Firebase existant. Suivez le processus de création de la base de données.

  2. Sélectionnez un mode de démarrage pour vos règles de sécurité :

    Mode test

    Convient pour se familiariser avec les bibliothèques clientes mobiles et Web, mais permet à tout le monde de lire et d'écraser les données. Lorsque vous aurez terminé les tests, assurez-vous de passer en revue la section Comprendre les règles Firebase Realtime Database.

    Pour commencer, sélectionnez testmode.

    Mode verrouillé

    Refuse toutes les lectures et écritures des clients mobiles et Web. Vos serveurs d'application authentifiés peuvent toujours accéder à votre base de données.

  3. Choisissez une région pour la base de données. Selon la région choisie, l'espace de noms de la base de données sera au format <databaseName>.firebaseio.com ou <databaseName>.<region>.firebasedatabase.app. Pour en savoir plus, consultez la section Sélectionner des emplacements pour votre projet.

  4. Cliquez sur OK.

Lorsque vous activez Realtime Database, cela active également l'API dans le Cloud API Manager.

Ajouter Firebase Realtime Database à votre application

  1. À la racine de votre projet Flutter, exécutez la commande suivante pour installer le plug-in :

    flutter pub add firebase_database

  2. Une fois l'opération terminée, recréez votre application Flutter :

    flutter run

Configurer les règles de la base de données

Realtime Database fournit un langage de règles déclaratif qui vous permet de définir la structure de vos données, leur indexation et le moment où elles peuvent être lues et écrites.

Initialiser le package Firebase Realtime Database

Pour commencer à utiliser le package Realtime Database dans votre projet, importez-le en haut de vos fichiers de projet :

import 'package:firebase_database/firebase_database.dart';

Pour utiliser l'instance de base de données par défaut, appelez le getter instance sur FirebaseDatabase :

FirebaseDatabase database = FirebaseDatabase.instance;

Si vous souhaitez l'utiliser avec une application Firebase secondaire, utilisez la méthode statique instanceFor :

FirebaseApp secondaryApp = Firebase.app('SecondaryApp');
FirebaseDatabase database = FirebaseDatabase.instanceFor(app: secondaryApp);

Si vous souhaitez utiliser une autre instance RTDB sur le même projet, vous pouvez transmettre un databaseUrl à l'aide de la méthode statique instanceFor :

final firebaseApp = Firebase.app();
final rtdb = FirebaseDatabase.instanceFor(app: firebaseApp, databaseURL: 'https://your-realtime-database-url.firebaseio.com/');

Étapes suivantes