Aggiungere Firebase al progetto Android

Prerequisiti

  • Installa o aggiorna Android Studio alla versione più recente.

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

    • 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 di questi requisiti di versione:
      • com.android.tools.build:gradle v7.3.0 o 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 con 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 collegare la tua app Android a Firebase utilizzando una delle seguenti opzioni:

  • Opzione 1: (consigliata) utilizza il flusso di lavoro di configurazione della consoleFirebase.
  • Opzione 2: utilizza l'Assistente Firebase di Android Studio (potrebbe essere necessaria una configurazione aggiuntiva).



Opzione 1: aggiungi Firebase utilizzando la console Firebase

L'aggiunta di Firebase all'app comporta attività sia nella console Firebase sia nel progetto Android aperto (ad esempio, scarichi i file di configurazione di Firebase dalla console, quindi 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. Per saperne di più sui progetti Firebase, consulta Informazioni sui progetti Firebase.

  1. Nella console Firebase, fai clic su Aggiungi progetto.

    • Per aggiungere risorse Firebase a un progetto Google Cloud esistente, inserisci il nome del progetto o selezionalo dal menu a discesa.

    • Per creare un nuovo progetto, inserisci il nome desiderato. Se vuoi, puoi anche modificare l'ID progetto visualizzato sotto il nome del progetto.

  2. Se richiesto, leggi e accetta i Termini di Firebase.

  3. Fai clic su Continua.

  4. (Facoltativo) Configura Google Analytics per il tuo progetto, in modo da poter usufruire di un'esperienza ottimale con uno dei seguenti prodotti Firebase:

    Seleziona un account Google Analytics esistente o creane uno nuovo.

    Se crei un nuovo account, seleziona la Analytics località dei report, quindi accetta le impostazioni di condivisione dei dati e i termini di Google Analytics per il tuo progetto.

  5. Fai clic su Crea progetto (o Aggiungi Firebase, se utilizzi un progetto Google Cloud esistente).

Firebase esegue automaticamente il provisioning delle risorse per il tuo progetto Firebase. Al termine della procedura, nella console Firebase verrà visualizzata la pagina Panoramica del progetto 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 è 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 di configurazione.

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

    • Un nome del pacchetto identifica in modo univoco la tua app sul dispositivo e nel Google Play Store.

    • Un nome pacchetto viene spesso definito ID applicazione.

    • Trova il nome del pacchetto della tua app nel file Gradle del modulo (a livello di app), solitamente app/build.gradle (nome del pacchetto di esempio:com.yourcompany.yourproject).

    • Tieni presente che il valore del nome del pacchetto è sensibile alle maiuscole e non può essere modificato per questa app Firebase per Android dopo la registrazione al progetto Firebase.

  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 aggiungi il file di configurazione di Firebase per Android (google-services.json) alla tua app:

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

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

    • Il file di configurazione di Firebase contiene identificatori univoci, ma non segreti, per il tuo progetto. Per scoprire di più su questo file di configurazione, consulta Informazioni sui progetti Firebase.

    • Puoi scaricare di nuovo il file di configurazione di Firebase in qualsiasi momento.

    • Assicurati che al nome del file di configurazione non vengano aggiunti caratteri aggiuntivi, come (2).

  2. Per rendere accessibili ai valori nel file di configurazione google-services.json gli 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 dei servizi Google come dipendenza:

      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.2" apply false
      }
      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.2' 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:

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      plugins {
        id 'com.android.application'
      
        // Add the Google services Gradle plugin
        id 'com.google.gms.google-services'
        // ...
      }

Passaggio 4: aggiungi gli SDK Firebase all'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 Firebase Android BoM per controllare la versione della libreria.

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.7.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 Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

    Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin che Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le Domande frequenti su questa iniziativa).

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.7.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 Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

    Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin che Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le Domande frequenti su questa iniziativa).

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

    Le build di Gradle che utilizzano il plug-in Android per Gradle (AGP) 4.2 o versioni precedenti devono attivare il supporto di Java 8. In caso contrario, questi progetti Android generano un errore di compilazione quando viene aggiunto un SDK Firebase.

    Per risolvere questo errore di compilazione, puoi seguire una delle due opzioni:

    • Aggiungi il valore compileOptions elencato nel messaggio di errore al file build.gradle.kts o build.gradle a livello di app.
    • Aumenta minSdk per il tuo progetto Android a 26 o versioni successive.

    Scopri di più su questo errore di compilazione in queste domande frequenti.

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

Tuttavia, se hai difficoltà a effettuare la configurazione, consulta la sezione Domande frequenti e risoluzione dei problemi relativi ad 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, 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 dell'Assistente Firebase:

    • Windows / Linux: Guida > Cerca aggiornamenti
    • macOS: Android Studio > Cerca aggiornamenti
  2. Apri Firebase Assistant: Strumenti > Firebase.

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

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

      • Questo flusso di lavoro crea automaticamente una nuova app Firebase per Android utilizzando il nome del pacchetto della tua app. Puoi creare questa nuova app Firebase per Android in un progetto Firebase esistente o in un nuovo progetto.

        Ecco alcuni suggerimenti per configurare il tuo progetto Firebase:

        • Consulta le nostre best practice per aggiungere app a un progetto Firebase, incluso come gestire più varianti.

        • Se crei un nuovo progetto, ti consigliamo vivamente di configurare Google Analytics per il progetto, in modo da avere un'esperienza ottimale con molti prodotti Firebase.

      • Questo flusso di lavoro aggiunge anche il file di configurazione Android (google-services.json) del progetto Firebase alla directory del modulo (a livello di app) della tua app.

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

  4. Sincronizza l'app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.

  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 controllare i passaggi successivi consigliati.

Tuttavia, se hai difficoltà a effettuare la configurazione, consulta la sezione Domande frequenti e risoluzione dei problemi relativi 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 Firebase Android BoM, non devi specificare le versioni delle singole librerie quando dichiari le dipendenze delle librerie Firebase nel file di configurazione di build di Gradle.

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

La versione più recente di Firebase BoM contiene le versioni più recenti di ogni libreria Android di Firebase. Per sapere quali versioni della libreria sono mappate a una versione BoM specifica, consulta le note di rilascio per la versione BoM in questione.

33.7.0
AdMob com.google.android.gms:play-services-ads 23.6.0
Analytics com.google.firebase:firebase-analytics 22.1.2
App Check fornitore personalizzato com.google.firebase:firebase-appcheck 18.0.0
Fornitore di debug App Check com.google.firebase:firebase-appcheck-debug 18.0.0
App Check Fornitore Play Integrity com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta14
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta14
Plug-in App Distribution com.google.firebase:firebase-appdistribution-gradle 5.0.0
Authentication com.google.firebase:firebase-auth 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging 24.1.0
Cloud Storage com.google.firebase:firebase-storage 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics 19.3.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.3.0
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.2
Supporto dei moduli di funzionalità dinamiche com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.1
(obbligatorio)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 21.0.1
(obbligatorio)
Firebase installazioni com.google.firebase:firebase-installations 18.0.0
Firebase ML API Model Downloader com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.3
Plug-in Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.1
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.0.2
Componente aggiuntivo Google Play Services com.google.gms:google-services 4.4.2
BIBLIOTECHE RIMORSE
App Check Fornitore SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0
Analytics com.google.firebase:firebase-analytics-ktx 22.1.2
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-beta14
Authentication com.google.firebase:firebase-auth-ktx 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.0
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.3.0
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.1
(obbligatorio)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display-ktx 21.0.1
(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.3
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.1
Firebase ML API di modelli personalizzati 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: modello di rilevamento dei volti 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: 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



Passaggi successivi

Aggiungi i servizi Firebase alla tua app:

Scopri di più su Firebase: