Aggiungere Firebase al progetto Android

Prerequisiti

  • Installa o aggiorna Android Studio all'ultima versione.

  • Assicurati che il tuo progetto soddisfi questi requisiti (tieni presente che alcuni prodotti potrebbero avere requisiti più rigorosi):

    • Ha come target il livello API 21 (Lollipop) o versioni successive
    • Utilizza Android 5.0 o versioni successive
    • Utilizza Jetpack (AndroidX), che include il rispetto dei seguenti requisiti di versione:
      • com.android.tools.build:gradle v7.3.0 o versioni successive
      • compileSdkVersion 28 o versioni successive

  • Configura un dispositivo fisico o utilizza un emulatore per eseguire la tua app.
    Tieni presente che gli SDK Firebase con una dipendenza da Google Play Services richiedono che sul dispositivo o sull'emulatore sia installato Google Play Services.

  • Accedi a Firebase utilizzando il tuo Account Google.

Se non hai ancora un progetto Android e vuoi solo provare un prodotto Firebase, puoi scaricare uno dei nostri esempi di avvio rapido.


Puoi connettere la tua app Android a Firebase utilizzando una delle seguenti opzioni:

  • Opzione 1: (consigliata) utilizza il flusso di lavoro di configurazione della console Firebase.
  • Opzione 2: utilizza l'assistente Firebase di Android Studio (potrebbe richiedere una configurazione aggiuntiva).


Opzione 1: aggiungi Firebase utilizzando la console Firebase

L'aggiunta di Firebase alla tua app comporta attività sia nella console Firebase sia nel progetto Android aperto (ad esempio, scarichi i file di configurazione di Firebase dalla console, poi li sposti nel progetto Android).

Passaggio 1: crea un progetto Firebase

Prima di poter aggiungere Firebase alla tua app per Android, devi creare un progetto Firebase per connetterti all'app. Visita la pagina Informazioni sui progetti Firebase per scoprire di più sui progetti Firebase.

Passaggio 2: registra la tua app con Firebase

Per utilizzare Firebase nella tua app per Android, devi registrare l'app con il tuo progetto Firebase. La registrazione dell'app viene spesso chiamata "aggiunta" dell'app al progetto.

  1. Vai alla console Firebase.

  2. Al centro della pagina di riepilogo del progetto, fai clic sull'icona Android () o su Aggiungi app per avviare il flusso di lavoro della configurazione.

  3. Inserisci il nome del pacchetto della tua app nel campo Nome del pacchetto Android.

  4. (Facoltativo) Inserisci altre informazioni sull'app: Nickname dell'app e Certificato SHA-1 per la firma di debug.

  5. Fai clic su Registra app.

Passaggio 3: aggiungi un file di configurazione di Firebase

  1. Scarica e poi aggiungi il file di configurazione Firebase della tua app (google-services.json) al tuo codebase:

    1. Fai clic su Scarica google-services.json per ottenere il file di configurazione Firebase della tua app.

    2. Sposta il file di configurazione nella directory root del modulo (a livello di app) della tua app.

  2. Per rendere accessibili agli SDK Firebase i valori nel file di configurazione google-services.json, è necessario il plug-in Gradle dei servizi Google (google-services).

    1. Nel file Gradle a livello di directory principale (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), aggiungi il plug-in dei servizi Google come dipendenza:

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.3" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.3' apply false
}

    2. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi il plug-in dei servizi Google:

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

Passaggio 4: aggiungi gli SDK Firebase alla tua app

  1. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi le dipendenze per i prodotti Firebase che vuoi utilizzare nella tua app. Ti consigliamo di utilizzare la Firebase Android BoM per controllare il controllo delle versioni delle librerie.

    Analytics abilitato 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

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

    Analytics non abilitato 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

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

  2. Dopo aver aggiunto le dipendenze per i prodotti che vuoi utilizzare, sincronizza il tuo progetto Android con i file Gradle.

Ecco fatto. Puoi andare avanti per consultare i passaggi successivi consigliati.

Se hai difficoltà con la configurazione, visita la pagina Risoluzione dei problemi e domande frequenti su Android.


Opzione 2: aggiungi Firebase utilizzando Firebase Assistant

L'assistente Firebase registra la tua app con un progetto Firebase e aggiunge i file, i plug-in e le dipendenze Firebase necessari al tuo progetto Android, tutto da Android Studio.

  1. Apri il progetto Android in Android Studio, poi assicurati di utilizzare le versioni più recenti di Android Studio e dell'assistente Firebase:

    • Windows / Linux: Guida > Controlla aggiornamenti
    • macOS: Android Studio > Verifica aggiornamenti

  2. Apri Firebase Assistant: Strumenti > Firebase.

  3. Nel riquadro Assistente, scegli un prodotto Firebase da aggiungere alla tua app. Espandi la sezione e fai clic sul link al tutorial (ad esempio, Analytics > Registra un evento Analytics).

    1. Fai clic su Connetti a Firebase per connettere il tuo progetto Android a Firebase.

    2. Fai clic sul pulsante per aggiungere un prodotto Firebase che ti interessa (ad esempio, Aggiungi Analytics alla tua app).

  4. Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.

  5. Nel riquadro Assistente, segui le istruzioni di configurazione rimanenti per il prodotto Firebase selezionato.

  6. Aggiungi tutti gli altri prodotti Firebase che vuoi tramite Firebase Assistant.

Ecco fatto. Assicurati di consultare i passaggi successivi consigliati.

Se hai difficoltà con la configurazione, visita la pagina Risoluzione dei problemi e domande frequenti su Android.


Librerie disponibili

Questa sezione elenca i prodotti Firebase supportati per Android e le relative dipendenze Gradle. Scopri di più su queste librerie Firebase per Android:

Tieni presente che quando utilizzi Firebase Android BoM, non devi specificare le singole versioni della libreria quando dichiari le dipendenze della libreria Firebase nel file di configurazione della build Gradle.

Servizio o prodotto Dipendenza Gradle Ultima versione
 Aggiungere Analytics?
Firebase Android BoM
(Bill of Materials)		 com.google.firebase:firebase-bom

L'ultima versione di Firebase BoM contiene le versioni più recenti di ogni libreria Firebase per Android. Per scoprire quali versioni della libreria sono mappate a una versione specifica di BoM, consulta le note di rilascio per quella versione di BoM.

 34.0.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.0.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check fornitore personalizzato com.google.firebase:firebase-appcheck 19.0.0
Fornitore di debug App Check com.google.firebase:firebase-appcheck-debug 19.0.0
App Check Fornitore di Play Integrity com.google.firebase:firebase-appcheck-playintegrity 19.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta16
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta16
Plug-in App Distribution com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.0
Cloud Firestore com.google.firebase:firebase-firestore 26.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.0
Cloud Storage com.google.firebase:firebase-storage 22.0.0
Crashlytics com.google.firebase:firebase-crashlytics 20.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.0
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.5
Data Connect com.google.firebase:firebase-dataconnect 17.0.0
Supporto dei moduli di funzionalità dinamiche com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.0
(obbligatorio)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 22.0.0
(obbligatorio)
Firebase installazioni com.google.firebase:firebase-installations 19.0.0
Firebase ML API Model Downloader com.google.firebase:firebase-ml-modeldownloader 26.0.0
Performance Monitoring com.google.firebase:firebase-perf 22.0.0
Plug-in Performance Monitoring com.google.firebase:perf-plugin 2.0.0
Realtime Database com.google.firebase:firebase-database 22.0.0
Remote Config com.google.firebase:firebase-config 23.0.0
Plug-in Google Play Services com.google.gms:google-services 4.4.3
LIBRERIE DEPRECATE
App Check Fornitore di SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Moduli Firebase KTX

Analytics com.google.firebase:firebase-analytics-ktx 22.5.0
App Check fornitore personalizzato com.google.firebase:firebase-appcheck-ktx 18.0.0
API App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(obbligatorio)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(obbligatorio)
Firebase installazioni com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML API Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Librerie Firebase ML Kit

Firebase ML API Custom Model com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML API Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Modello di etichettatura delle immagini com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: modello di rilevamento e monitoraggio degli oggetti com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: Face Detection Model com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Modello di scansione del codice a barre com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: API AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: API Natural Language com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: Modello di identificazione della lingua com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Traduci modello com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Modello di risposta rapida com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8

1 Firebase AI Logic in precedenza era chiamato "Vertex AI in Firebase" con il pacchetto com.google.firebase:firebase-vertexai.


Passaggi successivi

Aggiungi i servizi Firebase alla tua app:

Scopri di più su Firebase: