Prerequisiti
Installa o aggiorna Android Studio all'ultima versione.
Assicurati che il tuo progetto soddisfi questi requisiti:
- Target API livello 19 (KitKat) o superiore
- Utilizza Android 4.4 o versioni successive
- Utilizza Jetpack (AndroidX) , che include il rispetto dei seguenti requisiti di versione:
-
com.android.tools.build:gradle
v3.2.1 o successivo -
compileSdkVersion
28 o successiva
-
Configura un dispositivo fisico o usa un emulatore per eseguire la tua app.
Tieni presente che gli SDK Firebase con una dipendenza dai servizi di Google Play richiedono che sul dispositivo o sull'emulatore siano installati i servizi di 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 : (consigliato) Usa il flusso di lavoro di configurazione della console Firebase.
- Opzione 2 : utilizzare 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 comporta attività sia nella console Firebase che nel tuo progetto Android aperto (ad esempio, scarichi i file di configurazione di 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 saperne di più 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 è spesso chiamata "aggiunta" della tua app al tuo progetto.
Vai alla console Firebase .
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.Inserisci il nome del pacchetto della tua app nel campo del nome del pacchetto Android .
Il nome del pacchetto identifica in modo univoco la tua app sul dispositivo e nel Google Play Store.
Il nome di un pacchetto viene spesso definito ID applicazione .
Trova il nome del pacchetto della tua app nel file Gradle del tuo modulo (a livello di app), in genere
app/build.gradle
(nome del pacchetto di esempio:com.yourcompany.yourproject
).Tieni presente che il valore del nome del pacchetto fa distinzione tra maiuscole e minuscole e non può essere modificato per questa app Firebase per Android dopo che è stata registrata con il tuo progetto Firebase.
(Facoltativo) Immettere altre informazioni sull'app: nickname dell'app e certificato di firma del debug SHA-1 .
Soprannome dell'app : un identificatore di convenienza interno visibile solo a te nella console Firebase
Debug del certificato di firma SHA-1 : un hash SHA-1 è richiesto dall'autenticazione Firebase (quando si utilizza l'accesso con Google o l' accesso con il numero di telefono ) e Firebase Dynamic Links .
Fare clic su Registra app .
Passaggio 3 : aggiungi un file di configurazione di Firebase
Aggiungi il file di configurazione di Firebase Android alla tua app:
Fai clic su Scarica google-services.json per ottenere il file di configurazione Android di Firebase (
).google-services.json Sposta il file di configurazione nella directory 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 ulteriori informazioni su questo file di configurazione, visita Informazioni sui progetti Firebase .
Puoi scaricare nuovamente il file di configurazione di Firebase in qualsiasi momento.
Assicurati che al nome del file di configurazione non siano aggiunti caratteri aggiuntivi, come
(2)
.
Per abilitare i prodotti Firebase nella tua app, aggiungi il plug-in dei servizi Google ai tuoi file Gradle.
Nel tuo file Gradle a livello di root (a livello di progetto) (
build.gradle
), aggiungi le regole per includere il plug-in Gradle di Google Services. Verifica di avere anche il repository Maven di Google.buildscript { repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository } dependencies { // ... // Add the following line: classpath 'com.google.gms:google-services:4.3.13' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
Nel file Gradle del tuo modulo (a livello di app) (di solito
app/build.gradle
), applica il plug-in Gradle di Google Services:apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
Passaggio 4 : aggiungi gli SDK Firebase alla tua app
Utilizzando la distinta base di Firebase Android , dichiara le dipendenze per i prodotti Firebase che desideri utilizzare nella tua app. Dichiarali nel file Gradle del tuo modulo (a livello di app (di solito
app/build.gradle
).Analisi abilitata
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics-ktx' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Utilizzando la BoM Android di Firebase, la tua app utilizzerà sempre versioni compatibili delle librerie Android di Firebase.
Analisi non abilitate
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin+KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.3.1') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Utilizzando la BoM Android di Firebase, la tua app utilizzerà sempre versioni compatibili delle librerie Android di Firebase.
Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.
Le build Gradle che utilizzano il plugin Android Gradle (AGP) v4.2 o precedenti devono abilitare il supporto Java 8. In caso contrario, questi progetti Android ottengono un errore di compilazione quando si aggiunge un SDK Firebase.
Per correggere questo errore di compilazione, puoi seguire una delle due opzioni:
- Aggiungi le
compileOptions
elencate dal messaggio di errore al filebuild.gradle
a livello di app. - Aumenta
minSdkVersion
per il tuo progetto Android a 26 o superiore.
Ulteriori informazioni su questo errore di compilazione in queste domande frequenti .
- Aggiungi le
Questo è tutto! Puoi andare avanti per controllare i passaggi successivi consigliati.
In caso di problemi con la configurazione, tuttavia, visita la risoluzione dei problemi e le domande frequenti su Android .
Opzione 2 : aggiungi Firebase utilizzando Firebase Assistant
Firebase Assistant registra la tua app con un progetto Firebase e aggiunge i file Firebase, i plug-in e le dipendenze necessari al tuo progetto Android, il tutto da Android Studio!
Apri il tuo progetto Android in Android Studio, quindi assicurati di utilizzare le ultime versioni di Android Studio e Firebase Assistant:
- Windows / Linux: Guida > Verifica aggiornamenti
- macOS: Android Studio > Verifica aggiornamenti
Apri l'Assistente Firebase: Strumenti > Firebase .
Nel riquadro dell'assistente , scegli un prodotto Firebase da aggiungere alla tua app. Espandi la sua sezione, quindi 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.
Questo flusso di lavoro crea automaticamente una nuova app Firebase per Android utilizzando il nome del pacchetto dell'app . Puoi creare questa nuova app Firebase per Android in un progetto Firebase esistente o in un nuovo progetto.
Ecco alcuni suggerimenti sulla configurazione del tuo progetto Firebase:
Consulta le nostre best practice per l'aggiunta di app a un progetto Firebase, incluso come gestire più varianti.
Se crei un nuovo progetto, ti consigliamo vivamente di configurare Google Analytics per il tuo progetto, che ti consente di avere un'esperienza ottimale utilizzando molti prodotti Firebase.
Questo flusso di lavoro aggiunge anche il file di configurazione Android del tuo progetto Firebase (
) alla directory del modulo (a livello di app) della tua app.google-services.json
Fai clic sul pulsante per aggiungere un prodotto Firebase desiderato (ad esempio,
Aggiungi Analytics alla tua app ).
Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.
Nel riquadro Assistente , segui le restanti istruzioni di configurazione per il prodotto Firebase selezionato.
Aggiungi tutti gli altri prodotti Firebase che desideri tramite l'Assistente Firebase!
Questo è tutto! Assicurati di controllare i passaggi successivi consigliati.
In caso di problemi con la configurazione, tuttavia, visita la risoluzione dei problemi e le domande frequenti su Android .
Librerie disponibili
Questa sezione elenca i prodotti Firebase supportati per Android e le loro dipendenze Gradle. Ulteriori informazioni su queste librerie Android Firebase:
Documentazione di riferimento ( Java | Kotlin+KTX )
Repo GitHub dell'SDK Android Firebase
Tieni presente che quando utilizzi Firebase Android BoM , non specifichi le singole versioni della libreria quando dichiari le dipendenze della libreria Firebase in build.gradle
.
Java
Servizio o Prodotto | Dipendenza dal grado | Ultimo versione | Aggiungere Analytics? |
---|---|---|---|
Firebase Android BoM (Distinta materiali) | com.google.firebase:firebase-bom L'ultima versione di Firebase BoM contiene le ultime versioni di ciascuna libreria Firebase Android. Per sapere quali versioni della libreria sono mappate a una specifica versione della distinta base, consultare le note di rilascio per quella versione della distinta base. | 30.3.1 | |
AdMob | com.google.android.gms:play-services-ads | 21.1.0 | |
Analitica | com.google.firebase:firebase-analytics | 21.1.0 | |
App Check provider personalizzato | com.google.firebase:firebase-appcheck | 16.0.0 | |
Provider di debug di App Check | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
App Check Play Integrity provider | com.google.firebase:firebase-appcheck-playintegrity | 16.0.0 | |
App Controllare il provider SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
Distribuzione dell'app | com.google.firebase:firebase-appdistribution | 16.0.0-beta03 | |
API di distribuzione dell'app | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta03 | |
Plugin di distribuzione dell'app | com.google.firebase:firebase-appdistribution-gradle | 3.0.2 | |
Autenticazione | com.google.firebase:firebase-auth | 21.0.6 | |
Cloud Firestore | com.google.firebase:firebase-firestore | 24.2.1 | |
Funzioni cloud per Firebase Client SDK | com.google.firebase: funzioni-firebase | 20.1.0 | |
Messaggistica cloud | com.google.firebase: messaggistica di firebase | 23.0.6 | |
Archiviazione su cloud | com.google.firebase:firebase-storage | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics | 18.2.12 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.2.12 | |
Plugin Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.1 | |
Supporto per moduli di funzionalità dinamici | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta02 | |
Collegamenti dinamici | com.google.firebase: collegamenti dinamici-firebase | 21.0.1 | |
Messaggistica in-app | com.google.firebase:firebase-inappmessaging | 20.1.2 | (necessario) |
Visualizzazione della messaggistica in-app | com.google.firebase:firebase-inappmessaging-display | 20.1.2 | (necessario) |
Installazioni Firebase | com.google.firebase: installazioni-firebase | 17.0.1 | |
API per il download del modello di Firebase ML | com.google.firebase:firebase-ml-modeldownloader | 24.0.4 | |
Monitoraggio delle prestazioni | com.google.firebase:firebase-perf | 20.1.0 | |
Plugin di monitoraggio delle prestazioni | com.google.firebase:perf-plugin | 1.4.1 | |
Database in tempo reale | com.google.firebase: database-firebase | 20.0.5 | |
Configurazione remota | com.google.firebase:firebase-config | 21.1.1 | |
Plugin dei servizi di Google Play | com.google.gms:servizi-google | 4.3.13 | |
Librerie deprecate | |||
Indicizzazione delle app | com.google.firebase: firebase-appindexing | 20.0.0 | |
API del modello personalizzato di 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 di 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-linguaggio-naturale | 22.0.1 | |
Firebase ML: modello di identificazione del linguaggio | com.google.firebase:firebase-ml-natural-language-language-id-model | 20.0.8 | |
Firebase ML: Traduci modello | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: modello di risposta intelligente | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Kotlin+KTX
Servizio o Prodotto | Dipendenza dal grado | Ultimo versione | Aggiungere Analytics? |
---|---|---|---|
Firebase Android BoM (Distinta materiali) | com.google.firebase:firebase-bom L'ultima versione di Firebase BoM contiene le ultime versioni di ciascuna libreria Firebase Android. Per sapere quali versioni della libreria sono mappate a una specifica versione della distinta base, consultare le note di rilascio per quella versione della distinta base. | 30.3.1 | |
AdMob | com.google.android.gms:play-services-ads | 21.1.0 | |
Analitica | com.google.firebase:firebase-analytics-ktx | 21.1.0 | |
App Check provider personalizzato | com.google.firebase:firebase-appcheck | 16.0.0 | |
Provider di debug di App Check | com.google.firebase:firebase-appcheck-debug | 16.0.0 | |
App Controllare il provider SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.0.0 | |
API di distribuzione dell'app | com.google.firebase:firebase-appdistribution-api-ktx | 16.0.0-beta03 | |
Plugin di distribuzione dell'app | com.google.firebase:firebase-appdistribution-gradle | 3.0.2 | |
Autenticazione | com.google.firebase:firebase-auth-ktx | 21.0.6 | |
Cloud Firestore | com.google.firebase:firebase-firestore-ktx | 24.2.1 | |
Funzioni cloud per Firebase Client SDK | com.google.firebase:firebase-functions-ktx | 20.1.0 | |
Messaggistica cloud | com.google.firebase:firebase-messaging-ktx | 23.0.6 | |
Archiviazione su cloud | com.google.firebase:firebase-storage-ktx | 20.0.1 | |
Crashlytics | com.google.firebase:firebase-crashlytics-ktx | 18.2.12 | |
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 18.2.12 | |
Plugin Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 2.9.1 | |
Supporto per moduli di funzionalità dinamici | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta02 | |
Collegamenti dinamici | com.google.firebase:firebase-dynamic-links-ktx | 21.0.1 | |
Messaggistica in-app | com.google.firebase:firebase-inappmessaging-ktx | 20.1.2 | (necessario) |
Visualizzazione della messaggistica in-app | com.google.firebase:firebase-inappmessaging-display-ktx | 20.1.2 | (necessario) |
Installazioni Firebase | com.google.firebase:firebase-installations-ktx | 17.0.1 | |
API per il download del modello di Firebase ML | com.google.firebase:firebase-ml-modeldownloader-ktx | 24.0.4 | |
Monitoraggio delle prestazioni | com.google.firebase:firebase-perf-ktx | 20.1.0 | |
Plugin di monitoraggio delle prestazioni | com.google.firebase:perf-plugin | 1.4.1 | |
Database in tempo reale | com.google.firebase:firebase-database-ktx | 20.0.5 | |
Configurazione remota | com.google.firebase:firebase-config-ktx | 21.1.1 | |
Plugin dei servizi di Google Play | com.google.gms:servizi-google | 4.3.13 | |
Librerie deprecate | |||
Indicizzazione delle app | com.google.firebase: firebase-appindexing | 20.0.0 | |
API del modello personalizzato di 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 di 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-linguaggio-naturale | 22.0.1 | |
Firebase ML: modello di identificazione del linguaggio | com.google.firebase:firebase-ml-natural-language-language-id-model | 20.0.8 | |
Firebase ML: Traduci modello | com.google.firebase:firebase-ml-natural-language-translate-model | 20.0.9 | |
Firebase ML: modello di risposta intelligente | com.google.firebase:firebase-ml-natural-language-smart-reply-model | 20.0.8 |
Prossimi passi
Aggiungi i servizi Firebase alla tua app:
Ottieni informazioni dettagliate sul comportamento degli utenti con Analytics .
Configurare un flusso di autenticazione utente con Autenticazione .
Archivia i dati, come le informazioni sull'utente, con Cloud Firestore o Realtime Database .
Archivia file, come foto e video, con Cloud Storage .
Attiva il codice back-end che viene 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 .
Ulteriori informazioni su Firebase:
Visita Comprendere i progetti Firebase per saperne di più sui progetti Firebase e sulle migliori pratiche per i progetti.
Visita Ulteriori informazioni su Android e Firebase se hai domande su concetti non familiari o specifici dello sviluppo di Firebase e Android.
Esplora app Firebase di esempio .
Ottieni un'esperienza pratica con Firebase Android Codelab .
Scopri di più con il corso Firebase in a Weekend .
Preparati ad avviare la tua app:
- Imposta avvisi di budget per il tuo progetto in Google Cloud Console.
- Monitora il dashboard di utilizzo e fatturazione nella console Firebase per avere un quadro generale dell'utilizzo del tuo progetto su più servizi Firebase.
- Esamina l'elenco di controllo per l'avvio di Firebase .
Hai problemi con Firebase e il tuo progetto Android? Visita la risoluzione dei problemi e le domande frequenti su Android .