Aggiungi Firebase al tuo progetto Android

Prerequisiti

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

  • Assicurati che il tuo progetto soddisfi questi requisiti:

    • Ha come target il livello API 19 (KitKat) o superiore
    • Utilizza Android 4.4 o versioni successive
    • Utilizza Jetpack (AndroidX) , che include il rispetto di questi requisiti di versione:
      • com.android.tools.build:gradle v7.3.0 o successivo
      • compileSdkVersion 28 o successiva
  • Configura un dispositivo fisico o utilizza un emulatore per eseguire la tua app.
    Tieni presente che gli SDK Firebase con una dipendenza dai servizi Google Play richiedono che sul dispositivo o sull'emulatore siano installati i servizi Google Play.

  • Accedi a Firebase utilizzando il tuo account Google.

Se non disponi già di un progetto Android e desideri semplicemente 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 Android Studio Firebase Assistant (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 che nel tuo progetto Android aperto (ad esempio, scarichi i file di configurazione Firebase dalla console, quindi li sposti nel tuo progetto Android).

Passaggio 1 : crea un progetto Firebase

Prima di poter aggiungere Firebase alla tua app Android, devi creare un progetto Firebase per connetterti alla tua app Android. Visita Comprendere i progetti Firebase per ulteriori informazioni sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Per utilizzare Firebase nella tua app Android, devi registrare la tua app con il tuo progetto Firebase. La registrazione della tua app viene spesso chiamata "aggiunta" della tua app al tuo progetto.

  1. Vai alla console Firebase .

  2. Al centro della pagina di panoramica 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 della tua app nel campo Nome del pacchetto Android .

  4. (Facoltativo) Inserisci altre informazioni sull'app: nickname dell'app e certificato di firma di debug SHA-1 .

  5. Fai clic su Registra app .

Passaggio 3 : aggiungi un file di configurazione Firebase

  1. Scarica e quindi aggiungi il file di configurazione Android Firebase ( google-services.json ) alla tua app:

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

    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 root (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.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.4.0' apply false
      }
      
    2. Nel file Gradle del tuo modulo (a livello di app) (solitamente <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) (solitamente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle ), aggiungi le dipendenze per i prodotti Firebase che desideri utilizzare nella tua app. Ti consigliamo di utilizzare la distinta base Android Firebase per controllare il controllo delle versioni della libreria.

    Analisi abilitata

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

    Cerchi un modulo di libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0) , sia gli sviluppatori Kotlin che quelli Java potranno dipendere dal modulo della libreria principale (per i dettagli, vedere le FAQ su questa iniziativa ).

    Analisi non abilitata

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

    Cerchi un modulo di libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0) , sia gli sviluppatori Kotlin che quelli Java potranno dipendere dal modulo della libreria principale (per i dettagli, vedere le FAQ su questa iniziativa ).

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

Questo è tutto! Puoi andare avanti per controllare i passaggi successivi consigliati.

Se riscontri problemi durante la configurazione, visita la sezione 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, il tutto da Android Studio!

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

    • Windows/Linux: Guida > Verifica 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 sua sezione, quindi fai clic sul collegamento del tutorial (ad esempio, Analytics > Registra un evento Analytics ).

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

    2. Fai clic sul pulsante per aggiungere il prodotto Firebase desiderato (ad esempio, Aggiungi Analytics alla tua app ).

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

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

  6. Aggiungi tutti gli altri prodotti Firebase che desideri tramite Firebase Assistant!

Questo è tutto! Assicurati di controllare i passaggi successivi consigliati.

Se riscontri problemi durante la configurazione, visita la sezione Risoluzione dei problemi e domande frequenti su Android .



Biblioteche disponibili

Questa sezione elenca i prodotti Firebase supportati per Android e le relative dipendenze Gradle. Ulteriori informazioni su queste librerie Android Firebase:

Tieni presente che quando utilizzi la distinta base Android Firebase , non specifichi le singole versioni della libreria quando dichiari le dipendenze della libreria Firebase nel file di configurazione della build Gradle.

Servizio o prodotto Dipendenza dal grado Ultimo
versione
Aggiungere Analisi?
Distinta base Android Firebase
(Distinta materiali)
com.google.firebase:firebase-bom

L'ultima versione della distinta base Firebase contiene le versioni più recenti di ciascuna libreria Android Firebase. Per sapere quali versioni della libreria sono mappate a una specifica versione della distinta base, rivedere le note sulla versione per quella versione della distinta base.

32.6.0
AdMob com.google.android.gms:play-services-ads 22.5.0
Analitica com.google.firebase:firebase-analytics 21.5.0
App Controlla il provider personalizzato com.google.firebase:firebase-appcheck 17.1.1
Provider di debug App Check com.google.firebase:firebase-appcheck-debug 17.1.1
App Controlla il fornitore di integrità di Play com.google.firebase:firebase-appcheck-playintegrity 17.1.1
Distribuzione dell'app com.google.firebase:firebase-appdistribution 16.0.0-beta11
API di distribuzione delle app com.google.firebase:firebase-appdistribution-api 16.0.0-beta11
Plug-in per la distribuzione delle app com.google.firebase:firebase-appdistribution-gradle 4.0.1
Autenticazione com.google.firebase:firebase-auth 22.3.0
Cloud Fire Store com.google.firebase:firebase-firestore 24.9.1
Funzioni cloud per l'SDK client Firebase com.google.firebase:funzioni-firebase 20.4.0
Messaggistica sul cloud com.google.firebase:firebase-messaggistica 23.3.1
Archiviazione nel cloud com.google.firebase:firebase-storage 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
Supporto del modulo di funzionalità dinamiche com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Collegamenti dinamici com.google.firebase:firebase-dynamic-links 21.2.0
Messaggistica in-app com.google.firebase:firebase-inappmessaging 20.4.0
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase:firebase-inappmessaging-display 20.4.0
(necessario)
Installazioni Firebase com.google.firebase:installazioni-firebase 17.2.0
API per il download di modelli Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.2.1
Monitoraggio delle prestazioni com.google.firebase:firebase-perf 20.5.1
Plug-in per il monitoraggio delle prestazioni com.google.firebase:perf-plugin 1.4.2
Banca dati in tempo reale com.google.firebase:database-firebase 20.3.0
Configurazione remota com.google.firebase:firebase-config 21.6.0
Plug-in dei servizi Google Play com.google.gms:servizi-google 4.4.0
BIBLIOTECHE DEPRECATE
App Controlla il fornitore di SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indicizzazione delle app com.google.firebase:firebase-appindexing 20.0.0

Moduli Firebase KTX

Analitica com.google.firebase:firebase-analytics-ktx 21.5.0
App Controlla il provider personalizzato com.google.firebase:firebase-appcheck-ktx 17.1.1
API di distribuzione delle app com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta11
Autenticazione com.google.firebase:firebase-auth-ktx 22.3.0
Cloud Fire Store com.google.firebase:firebase-firestore-ktx 24.9.1
Funzioni cloud per l'SDK client Firebase com.google.firebase:firebase-functions-ktx 20.4.0
Messaggistica sul cloud com.google.firebase:firebase-messaging-ktx 23.3.1
Archiviazione nel cloud com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
Collegamenti dinamici com.google.firebase:firebase-dynamic-links-ktx 21.2.0
Messaggistica in-app com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(necessario)
Installazioni Firebase com.google.firebase:firebase-installations-ktx 17.2.0
API per il download di modelli Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
Monitoraggio delle prestazioni com.google.firebase:firebase-perf-ktx 20.5.1
Banca dati in tempo reale com.google.firebase:firebase-database-ktx 20.3.0
Configurazione remota com.google.firebase:firebase-config-ktx 21.6.0

Librerie del kit Firebase ML

API del modello personalizzato Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
API Firebase ML 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 tracciamento 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 di 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 in linguaggio naturale com.google.firebase:firebase-ml-natural-linguaggio 22.0.1
Firebase ML: modello di identificazione della lingua com.google.firebase:firebase-ml-natural-lingual-lingual-id-model 20.0.8
Firebase ML: traduci modello com.google.firebase:firebase-ml-natural-lingual-translate-model 20.0.9
Firebase ML: modello di risposta intelligente com.google.firebase:firebase-ml-natural-lingual-smart-reply-model 20.0.8



Prossimi passi

Aggiungi i servizi Firebase alla tua app:

Ulteriori informazioni su Firebase: