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:gradlev7.3.0 o versioni successivecompileSdkVersion28 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.
Vai alla console Firebase.
Al centro della pagina di riepilogo del progetto, fai clic sull'icona Android () o su Aggiungi app per avviare il workflow di configurazione.
Inserisci il nome del pacchetto dell'app nel campo Nome pacchetto Android.
(Facoltativo) Inserisci un Nickname app, ovvero un identificatore interno di convenienza visibile solo a te nella console Firebase.
Fai clic su Registra app.
Passaggio 3: aggiungi un file di configurazione Firebase
Scarica e aggiungi il file di configurazione Firebase della tua app (
) al codebase:google-services.json Fai clic su Scarica google-services.json per ottenere il file di configurazione Firebase della tua app.
Sposta il file di configurazione nella directory root del modulo (a livello di app) della tua app.
Per rendere i valori nel file di configurazione
accessibili agli SDK Firebase, è necessario il plug-in Gradle dei servizi Google (google-services.json ).google-services Nel file Gradle a livello di directory principale (a livello di progetto) (
<project>/build.gradle.ktso<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 }
Nel file Gradle del modulo (a livello di app) (solitamente
<project>/<app-module>/build.gradle.ktso<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
Nel file Gradle del modulo (a livello di app) (di solito
<project>/<app-module>/build.gradle.ktso<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.
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.
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
Apri l'assistente Firebase: Strumenti > Firebase.
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 ).Fai clic su Connetti a Firebase per connettere il tuo progetto Android a Firebase.
Fai clic sul pulsante per aggiungere un prodotto Firebase (ad esempio,
Aggiungi Analytics alla tua app ).
Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni richieste.
Nel riquadro Assistente, segui le restanti istruzioni di configurazione per il prodotto Firebase selezionato.
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:
SDK Firebase per Android Repository GitHub
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
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Librerie Firebase ML e Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
Crea funzionalità di AI generativa con i modelli Gemini utilizzando Firebase AI Logic.
Ottenere informazioni sul comportamento degli utenti con Analytics.
Configura un flusso di autenticazione utente con Authentication.
Archivia i dati, ad esempio le informazioni utente, con Cloud Firestore o Realtime Database.
Archivia file, come foto e video, con Cloud Storage.
Attiva il codice di backend eseguito in un ambiente sicuro con Cloud Functions.
Invia notifiche con Cloud Messaging.
Scopri quando e perché la tua app si arresta in modo anomalo con Crashlytics.
Scopri di più su Firebase:
Consulta Informazioni sui progetti Firebase per scoprire di più sui progetti Firebase e sulle best practice per i progetti.
Visita la pagina Scopri di più su Android e Firebase se hai domande su concetti non familiari o specifici dello sviluppo di Firebase e Android.
Esplora le app Firebase di esempio.
Fai esperienza pratica con il codelab di Firebase per Android.
Scopri di più con il corso Firebase in a Weekend.
Preparati a lanciare la tua app:
- Configura gli avvisi relativi al budget per il tuo progetto nella console Google Cloud.
- Monitora la dashboard Utilizzo e fatturazione nella console Firebase per avere un quadro generale dell'utilizzo del progetto in più servizi Firebase.
- Consulta l'elenco di controllo per il lancio di Firebase.
Hai problemi con Firebase e il tuo progetto Android? Consulta la pagina Risoluzione dei problemi e domande frequenti su Android.