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

    • Hanno 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 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 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.

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.

  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 di Firebase (google-services.json) della tua app 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 principale del modulo (a livello di app) della tua app.

  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:

      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 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.

    Analytics abilitato 

    dependencies {
  // ...

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

    Analytics non attivato 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.16.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.

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 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 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 singole versioni delle 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 quella versione BoM.

 33.16.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 16.2.0
Analytics com.google.firebase:firebase-analytics 22.5.0
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-beta15
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta15
Plug-in App Distribution com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging 24.1.2
Cloud Storage com.google.firebase:firebase-storage 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics 19.4.4
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.4.4
Plug-in Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.4
Data Connect com.google.firebase:firebase-dataconnect 16.0.3
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.2
(obbligatorio)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 21.0.2
(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.5
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.1.2
Componente aggiuntivo Google Play Services com.google.gms:google-services 4.4.3
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

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 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

1 Firebase AI Logic in precedenza si chiamava "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: