Associer votre application à Firebase

Si ce n'est pas encore fait, ajoutez Firebase à votre projet Android.

Créer une base de données

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

2. Sélectionnez un mode de démarrage pour votre Firebase Security Rules:

   Mode test

   Bon pour démarrer avec les bibliothèques clientes mobiles et Web, mais permet à n’importe qui de lire et d’écraser vos données. Après les tests, faites consultez Comprendre les règles Firebase Realtime Database .

   Pour commencer à utiliser le SDK Web, Apple ou Android, sélectionnez "testmode".

   Mode verrouillé

   Interdit toute lecture et écriture à partir de clients mobiles et Web. Vos serveurs d'applications authentifiés peuvent toujours accéder à votre base de données.

3. Choisissez un emplacement pour la base de données.

   En fonction du emplacement de la base de données, le L'URL de la nouvelle base de données se présentera sous l'une des formes suivantes:

   • DATABASE_NAME.firebaseio.com (pour bases de données dans us-central1)

   • DATABASE_NAME.REGION.firebasedatabase.app (pour les bases de données de tous les autres emplacements)

4. Cliquez sur OK.

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

Ajouter le SDK Realtime Database à votre application

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.2.0"))

    // Add the dependency for the Realtime Database library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-database")
}

En utilisant Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.

dependencies {
    // Add the dependency for the Realtime Database library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-database:21.0.0")
}

Configurer Realtime Database Security Rules

Realtime Database fournit un langage de règles déclaratives qui permet de définir la façon dont vos données doivent être structurées, et quand il est possible de lire et d'écrire des données.

Écrire dans votre base de données

Récupérez une instance de votre base de données à l'aide de getInstance() et référencer l'emplacement où vous voulez écrire.

// Write a message to the database
val database = Firebase.database
val myRef = database.getReference("message")

myRef.setValue("Hello, World!")
MainActivity.kt

// Write a message to the database
FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference myRef = database.getReference("message");

myRef.setValue("Hello, World!");
MainActivity.java

Vous pouvez enregistrer une gamme de types de données dans la base de données de cette manière, y compris des objets Java. Lorsque vous enregistrez un objet, les réponses de tous les getters sont enregistrées en tant qu'enfants de cet emplacement.

Lire à partir de votre base de données

Pour mettre à jour les données de votre application en temps réel, vous devez ajouter un ValueEventListener à la référence que vous venez de créer.

La méthode onDataChange() de cette classe est déclenchée une fois lorsque l'écouteur est et à chaque fois que les données changent, y compris les enfants.

// Read from the database
myRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(dataSnapshot: DataSnapshot) {
        // This method is called once with the initial value and again
        // whenever data at this location is updated.
        val value = dataSnapshot.getValue<String>()
        Log.d(TAG, "Value is: $value")
    }

    override fun onCancelled(error: DatabaseError) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException())
    }
})
MainActivity.kt

// Read from the database
myRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot dataSnapshot) {
        // This method is called once with the initial value and again
        // whenever data at this location is updated.
        String value = dataSnapshot.getValue(String.class);
        Log.d(TAG, "Value is: " + value);
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        // Failed to read value
        Log.w(TAG, "Failed to read value.", error.toException());
    }
});
MainActivity.java

Facultatif : Configurer ProGuard

Lorsque vous utilisez Firebase Realtime Database dans votre application avec ProGuard, vous devez réfléchir à la façon dont vos objets de modèle seront sérialisés et désérialisés après l'obscurcissement. Si vous utilisez DataSnapshot.getValue(Class) ou DatabaseReference.setValue(Object) pour lire et écrire des données, vous devrez Ajoutez des règles au fichier proguard-rules.pro:

    # Add this global rule
    -keepattributes Signature

    # This rule will properly ProGuard all the model classes in
    # the package com.yourcompany.models.
    # Modify this rule to fit the structure of your app.
    -keepclassmembers class com.yourcompany.models.** {
      *;
    }

Pour obtenir de l'aide concernant des questions ou des problèmes liés à ProGuard, consultez le Forums de la communauté Guardsquare pour obtenir l'aide d'un expert.

Préparer le lancement

Avant de lancer votre application, nous vous recommandons de consulter notre checklist avant lancement pour vous assurer que votre application c'est parti !

N'oubliez pas d'activer App Check pour vous assurer que seules vos applications peuvent accéder à vos bases de données.

Étapes suivantes

• Découvrez comment structurer les données pour Realtime Database
• Faites évoluer vos données sur plusieurs instances de base de données.
• Lire et écrire des données :
• Affichez votre base de données dans la console Firebase.