Collega la tua app a Firebase

Se non lo hai già fatto, aggiungi Firebase al tuo progetto Android.

Creare un database

  1. Vai alla sezione Realtime Database della console Firebase. Ti verrà chiesto di selezionare un progetto Firebase esistente. Segui il flusso di lavoro per la creazione del database.

  2. Seleziona una modalità di avvio per il tuo Firebase Security Rules:

    Modalità di test

    Ottimo per iniziare a utilizzare le librerie client mobile e web, ma consente a chiunque di leggere e sovrascrivere i tuoi dati. Dopo il test, assicurati di leggere la sezione Informazioni sulle regole di Firebase Realtime Database.

    Per iniziare a utilizzare l'SDK web, Apple o Android, seleziona testmode.

    Modalità di blocco

    Rifiuta tutte le operazioni di lettura e scrittura da client web e mobile. I tuoi server di applicazioni autenticati possono comunque accedere al tuo database.

  3. Scegli una posizione per il database.

    A seconda della posizione del database, l' URL del nuovo database avrà una delle seguenti forme:

    • DATABASE_NAME.firebaseio.com (per i database in us-central1)

    • DATABASE_NAME.REGION.firebasedatabase.app (per i database in tutte le altre località)

  4. Fai clic su Fine.

Se attivi Realtime Database, viene attivata anche l'API in Cloud API Manager.

Aggiungere l'SDK Realtime Database all'app

Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria Realtime Database per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare la versione della libreria. 

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.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")
}

Utilizzando Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase per Android.

(Alternativa)  Aggiungi le dipendenze della libreria Firebase senza utilizzare il file BoM

Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella relativa riga di dipendenza.

Tieni presente che se nella tua app utilizzi più librerie Firebase, ti consigliamo vivamente di utilizzare BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni. 

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")
}
Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin sia quelli Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le Domande frequenti su questa iniziativa).

Configura Realtime Database Security Rules

Realtime Database fornisce un linguaggio di regole dichiarative che consente di definire la struttura e l'indicizzazione dei dati, nonché quando è possibile leggerli e scriverli.

Scrivere nel database

Recupera un'istanza del database utilizzando getInstance() e fai riferimento alla posizione in cui vuoi scrivere.

Kotlin+KTX 

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

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

Java 

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

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

In questo modo puoi salvare nel database una serie di tipi di dati, inclusi gli oggetti Java. Quando salvi un oggetto, le risposte di eventuali getter verranno salvate come figli di questa posizione.

Leggere dal database

Per aggiornare i dati dell'app in tempo reale, devi aggiungere un ValueEventListener al riferimento che hai appena creato.

Il metodo onDataChange() in questa classe viene attivato una volta quando l'ascoltatore è collegato e di nuovo ogni volta che i dati cambiano, inclusi i figli.

Kotlin+KTX 

// 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

Java 

// 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

(Facoltativo) Configura ProGuard

Quando utilizzi Firebase Realtime Database nella tua app insieme a ProGuard, devi considerare come gli oggetti del modello verranno serializzati e deserializzati dopo l'oscuramento. Se utilizzi DataSnapshot.getValue(Class) o DatabaseReference.setValue(Object) per leggere e scrivere dati, dovrai aggiungere regole al file 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.** {
      *;
    }

Per ricevere assistenza per domande o problemi relativi a ProGuard, visita i forum della community di Guardsquare per ricevere assistenza da un esperto.

Prepararsi al lancio

Prima di lanciare l'app, ti consigliamo di consultare il nostro elenco di controllo per il lancio per assicurarti che sia pronta per essere lanciata.

Assicurati di attivare App Check per assicurarti che solo le tue app possano accedere ai tuoi database.

Passaggi successivi