Android Academy · Lezione

Configurare Firebase

Colleghi la sua app a un progetto Firebase

Configurare Firebase è una lezione Android Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Android Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Android Academy include 4 lezioni in totale.

Che cos'è Firebase?

Firebase è la piattaforma di Google per lo sviluppo di app. Fornisce alla sua app Android un backend pronto all'uso, così non deve creare e gestire personalmente i server.

In questo corso collegherà un'app a Firebase e poi utilizzerà tre dei suoi servizi più diffusi:

Authentication — accesso degli utenti tramite email o Google
Cloud Firestore — database NoSQL in tempo reale
Cloud Messaging (FCM) — notifiche push

Questa prima lezione riguarda interamente la configurazione: creare un progetto e collegarlo all'app Android.

Creare un progetto Firebase

Tutto inizia nella console Firebase, all'indirizzo console.firebase.google.com.

Faccia clic su Add project e assegni un nome al progetto.
Ogni progetto Firebase corrisponde a un progetto Google Cloud sottostante.
Un progetto Firebase può contenere più app (Android, iOS e web).

All'interno del progetto registri la sua specifica app Android usando il relativo application ID (nome del package), ad esempio com.coddykit.demo. Questo ID permette a Firebase di sapere da quale app proviene una richiesta.

Il file google-services.json

Quando registra l'app Android, Firebase genera un file di configurazione chiamato google-services.json.

Lo scarichi e lo inserisca nella cartella radice del modulo app (accanto a build.gradle.kts, all'interno della directory app/).

Questo JSON contiene l'ID del progetto, le chiavi API e i dati di registrazione dell'app. Gli strumenti di compilazione lo leggono automaticamente: quasi mai è necessario aprirlo manualmente.

// File location in your project:
// app/google-services.json

// It is generated for you and looks roughly like:
{
  "project_info": {
    "project_id": "my-demo-app",
    "storage_bucket": "my-demo-app.appspot.com"
  },
  "client": [
    { "client_info": { "mobilesdk_app_id": "1:1234567890:android:abc123" } }
  ]
}

Aggiungere il plugin Google Services

Per permettere a Gradle di leggere google-services.json, aggiunga il plugin Google Services per Gradle.

L'approccio moderno usa il blocco plugins con i cataloghi delle versioni. Dichiari il plugin nel file di build radice (con apply false) e poi lo applichi nel file di build del modulo.

// Root build.gradle.kts (project level)
plugins {
    id("com.android.application") version "8.5.0" apply false
    id("org.jetbrains.kotlin.android") version "2.0.0" apply false
    id("com.google.gms.google-services") version "4.4.2" apply false
}

Applicare il plugin nel modulo

Nel file build.gradle.kts del modulo app, applichi il plugin affinché elabori il file di configurazione durante la compilazione.

Senza questa riga, l'inizializzazione di Firebase fallirà a runtime anche se tutto il resto è corretto.

// app/build.gradle.kts (module level)
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.gms.google-services")
}

Il Firebase BoM

Firebase dispone di molte librerie (Auth, Firestore, Messaging, Analytics...). Mantenere allineate le relative versioni è semplice grazie al Bill of Materials (BoM).

Dichiari il BoM una sola volta, quindi aggiunga ogni dipendenza Firebase senza specificare una versione — il BoM selezionerà automaticamente versioni compatibili.

// app/build.gradle.kts -> dependencies { }
dependencies {
    // One BoM controls all Firebase versions
    implementation(platform("com.google.firebase:firebase-bom:33.1.0"))

    // No version numbers here - the BoM decides
    implementation("com.google.firebase:firebase-auth")
    implementation("com.google.firebase:firebase-firestore")
    implementation("com.google.firebase:firebase-messaging")
}

Inizializzazione automatica

Potrebbe aspettarsi di dover chiamare qualcosa come Firebase.initialize() nella classe Application. Con l'SDK moderno, di solito non è necessario.

Il plugin Google Services genera automaticamente un provider di inizializzazione che viene eseguito all'avvio dell'app usando google-services.json. Quando la sua Activity viene avviata, Firebase è già pronto.

// You normally do NOT need this anymore:
// FirebaseApp.initializeApp(context)

// Firebase is initialized automatically on app launch.
// You can just start using a service:
import com.google.firebase.Firebase
import com.google.firebase.firestore.firestore

val db = Firebase.firestore   // ready to use

Lo stile Kotlin KTX

Firebase offre accessor idiomatici di Kotlin tramite l'oggetto Firebase. Invece di FirebaseFirestore.getInstance(), può scrivere Firebase.firestore.

Queste estensioni risultano più naturali da leggere e rappresentano lo stile consigliato nel moderno codice Android.

import com.google.firebase.Firebase
import com.google.firebase.auth.auth
import com.google.firebase.firestore.firestore
import com.google.firebase.messaging.messaging

val auth = Firebase.auth          // FirebaseAuth
val db = Firebase.firestore       // FirebaseFirestore
val fcm = Firebase.messaging      // FirebaseMessaging

// Equivalent old style:
// val auth = FirebaseAuth.getInstance()

Aggiungere l'autorizzazione Internet

Firebase comunica con i server di Google, quindi l'app necessita dell'accesso alla rete. Dichiari l'autorizzazione INTERNET nel manifest.

Si tratta di un'autorizzazione normale, concessa automaticamente al momento dell'installazione: non è necessaria alcuna richiesta a runtime.

<!-- AndroidManifest.xml -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission android:name="android.permission.INTERNET" />

    <application ... >
        <!-- activities, services -->
    </application>
</manifest>

Verificare la connessione

Un modo rapido per verificare che la configurazione funzioni consiste nel leggere un valore o controllare l'app Firebase corrente. Se Firebase non fosse inizializzato, l'accesso a un servizio genererebbe un'eccezione.

Molti sviluppatori aggiungono temporaneamente anche la dipendenza Analytics e cercano un evento nella console come smoke test, ma richiamare semplicemente un servizio nel codice dimostra già che il collegamento è configurato correttamente.

import android.util.Log
import com.google.firebase.Firebase
import com.google.firebase.firestore.firestore

fun verifyFirebase() {
    val app = Firebase.firestore.app
    Log.d("Firebase", "Connected to project: ${app.options.projectId}")
}

Errori comuni di configurazione

Se Firebase non funziona, controlli innanzitutto questi elementi:

Nome del package errato — l'applicationId dell'app deve corrispondere a quello registrato.
google-services.json mancante — deve trovarsi nella cartella app/.
Plugin non applicato nel file di build del modulo.
Autorizzazione INTERNET assente nel manifest.
Impronta SHA-1 non aggiunta — sarà necessaria in seguito per l'accesso con Google.

Verifica rapida

Qual è lo scopo del file google-services.json?

Riepilogo: configurazione completata

Ha collegato un'app Android a Firebase. Passaggi principali:

Crei un progetto nella console Firebase e registri l'app usando il nome del package.
Aggiunga google-services.json alla cartella app/.
Applichi il plugin Google Services e aggiunga il Firebase BoM e le librerie necessarie.
Firebase si inizializza automaticamente — acceda ai servizi tramite Firebase.auth, Firebase.firestore e così via.
Non dimentichi l'autorizzazione INTERNET.

Prossimo argomento: far accedere gli utenti con Firebase Authentication.

Domande Frequenti

La lezione «Configurare Firebase» è gratuita?

Sì — il testo completo di «Configurare Firebase» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Android Academy, passa a CoddyKit PRO. Il corso Android Academy include 4 lezioni in totale.

Cosa imparerò in «Configurare Firebase»?

Colleghi la sua app a un progetto Firebase Eserciti Android Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Android Academy?

Non è richiesta alcuna esperienza precedente. Android Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.

Quanto tempo richiede la lezione «Configurare Firebase»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Android Academy?

Sì. Ogni lezione Android Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Android Academy