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ù severi):

    • Target: livello API 24 (Nougat) o superiore
    • Utilizza Android 7.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.

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


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

  • Opzione 1: (consigliata) utilizza il workflow di configurazione della consoleFirebase.
  • 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 prevede attività sia nella console Firebase sia nel tuo progetto Android aperto (ad esempio, scarichi i file di configurazione di Firebase dalla console e poi li sposti nel tuo progetto Android).

Passaggio 1: crea un progetto Firebase

Prima di poter aggiungere Firebase alla tua app per Android, devi creare un progetto Firebase da connettere all'app. Consulta 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 registrarla nel 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 workflow di configurazione.

  3. Inserisci il nome del pacchetto dell'app nel campo Nome pacchetto Android.

  4. (Facoltativo) Inserisci un Nickname app, ovvero un identificatore interno di convenienza visibile solo a te nella console Firebase.

  5. Fai clic su Registra app.

Passaggio 3: aggiungi un file di configurazione Firebase

  1. Scarica e aggiungi il file di configurazione Firebase della tua app (google-services.json) al 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 i valori nel file di configurazione google-services.json accessibili agli SDK Firebase, è 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 Gradle per i 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.6.0" 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.6.0' apply false
      }
    2. Nel file Gradle del modulo (a livello di app) (solitamente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi il plug-in Gradle per i 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 della libreria.

    Analytics abilitato

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

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

    Analytics non abilitata

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

    Con 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 direttamente ai passaggi successivi consigliati.

Se hai problemi con la configurazione, consulta la pagina Risoluzione dei problemi e domande frequenti relative ad Android.



Opzione 2: aggiungi Firebase utilizzando l'Assistente Firebase

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, il tutto da Android Studio.

  1. Apri il progetto Android in Android Studio, quindi assicurati di utilizzare le versioni più recenti di Android Studio e di Firebase Assistant:

    • Windows/Linux: Guida > Verifica la presenza di aggiornamenti
    • macOS: Android Studio > Controlla aggiornamenti
  2. Apri l'assistente Firebase: Strumenti > Firebase.

  3. Nel riquadro Assistente, scegli un prodotto Firebase da aggiungere alla tua app. Espandi la sezione, poi fai clic sul link del 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 (ad esempio, Aggiungi Analytics alla tua app).

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

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

  6. Aggiungi tutti gli altri prodotti Firebase che vuoi tramite l'Assistente Firebase.

Ecco fatto. Assicurati di consultare i passaggi successivi consigliati.

Se hai problemi con la configurazione, consulta la pagina Risoluzione dei problemi e domande frequenti relative ad Android.



Librerie disponibili

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

Tieni presente che quando utilizzi la Firebase Android BoM, non specifichi le singole versioni della libreria quando dichiari le dipendenze della libreria Firebase nel file di configurazione di compilazione 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 ultime versioni 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 della versione di BoM.

35.2.0
Plug-in Gradle per i servizi Google com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
App Check provider personalizzato com.google.firebase:firebase-appcheck 20.1.0
Provider di debug App Check com.google.firebase:firebase-appcheck-debug 20.1.0
App Check Provider Play Integrity com.google.firebase:firebase-appcheck-playintegrity 20.1.0
Fornitore di reCAPTCHA App Check com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
Plug-in App Distribution com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
NDK Crashlytics com.google.firebase:firebase-crashlytics-ndk 21.1.0
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.8
Supporto dei moduli delle funzionalità dinamiche com.google.firebase:firebase-dynamic-module-support 16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(required)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 23.0.0
(required)
Firebase installazioni com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
Plug-in Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
LIBRERIE DEPRECATE O NON SUPPORTATE
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Moduli Firebase KTX - Non più supportati

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

Librerie Firebase ML e Firebase ML Kit

API dei modelli personalizzati Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
API Model Downloader di Firebase ML com.google.firebase:firebase-ml-modeldownloader 26.1.1
API Vision Firebase ML 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 di oggetti e monitoraggio com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: modello di riconoscimento facciale com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: modello di scansione dei codici 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: modello di traduzione 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 era precedentemente denominata "Vertex AI in Firebase" con il pacchetto com.google.firebase:firebase-vertexai.

2 Firebase SQL Connect era precedentemente chiamato "Firebase Data Connect".



Passaggi successivi

Aggiungi i servizi Firebase alla tua app:

Scopri di più su Firebase: