Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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 16 (Jelly Bean) o successivo
    • Utilizza Gradle 4.1 o successivo
    • Utilizza Jetpack (AndroidX) , che include il soddisfacimento di questi 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 Google Play richiedono che il dispositivo o l'emulatore dispongano di servizi Google Play installati.

  • 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) utilizzare il flusso di lavoro di configurazione della console Firebase.
  • Opzione 2 : utilizzare Android Studio Firebase Assistant (potrebbe richiedere una configurazione aggiuntiva).



Opzione 1 : aggiungi Firebase utilizzando la console Firebase

L'aggiunta di Firebase alla tua app implica 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 Comprensione dei 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 della panoramica del progetto, fai clic sull'icona Android ( ) o Aggiungi app per avviare il flusso di lavoro di installazione.

  3. Inserisci il nome del pacchetto della tua app nel campo del nome del pacchetto Android .

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

  5. Fare clic su Registra app .

Passaggio 3 : aggiungi un file di configurazione di Firebase

  1. Aggiungi il file di configurazione di Firebase Android alla tua app:

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

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

  2. Per abilitare i prodotti Firebase nella tua app, aggiungi il plug-in google-services ai tuoi file Gradle.

    1. Nel tuo file Gradle a livello di root (a livello di progetto) ( build.gradle ), aggiungi 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.8'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. Nel file Gradle del 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

  1. Utilizzando il BoM Android di Firebase , 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 ).

    Analitica abilitata

    Giava

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

    Analitica non abilitata

    Giava

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

  2. Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.

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

Tuttavia, se hai problemi con la configurazione, visita la risoluzione dei problemi e le 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, tutto da Android Studio!

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

    • Windows/Linux: Aiuto > Verifica aggiornamenti
    • macOS: Android Studio > Verifica 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 link del tutorial (ad esempio, Analytics > Registra un evento di Analytics ).

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

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

  4. Sincronizza la tua 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 desideri tramite Firebase Assistant!

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

Tuttavia, se hai problemi con la configurazione, 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:

Tieni presente che quando utilizzi il BoM Android di Firebase , non specifichi le singole versioni della libreria quando dichiari le dipendenze della libreria Firebase in build.gradle .

Giava

Servizio o prodotto Dipendenza da Gradle Ultimo
versione
Aggiungere analisi?
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, rivedere le note di rilascio per quella versione della distinta base.

28.1.0
AdMob com.google.android.gms:play-services-ads 20.2.0
Analisi com.google.firebase:firebase-analytics 19.0.0
Plugin di distribuzione app com.google.firebase:firebase-appdistribution-gradle 2.1.2
Indicizzazione dell'app com.google.firebase:firebase-appindexing 20.0.0
Autenticazione com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.1
Funzioni cloud per Firebase Client SDK com.google.firebase:funzioni-firebase 20.0.0
Messaggistica cloud com.google.firebase:messaggi-firebase 22.0.0
Archiviazione cloud com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.0.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.0.1
Plugin di Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.0
Supporto per moduli di funzionalità dinamici com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Collegamenti dinamici com.google.firebase:firebase-dynamic-links 20.1.0
Messaggi in-app com.google.firebase:firebase-inappmessaging 20.0.0
(necessario)
Visualizzazione messaggi in-app com.google.firebase:firebase-inappmessaging-display 20.0.0
(necessario)
Installazioni Firebase com.google.firebase: installazioni-firebase 17.0.0
API per il download di modelli ML Firebase com.google.firebase:firebase-ml-modeldownloader 24.0.0
Monitoraggio delle prestazioni com.google.firebase:firebase-perf 20.0.1
Plugin per il monitoraggio delle prestazioni com.google.firebase:perf-plugin 1.4.0
Database in tempo reale com.google.firebase:firebase-database 20.0.0
Configurazione remota com.google.firebase:firebase-config 21.0.0
Plugin servizi Google Play Play com.google.gms:servizi-google 4.3.8
Librerie deprecate
API del modello personalizzato Firebase ML com.google.firebase: interprete-modello-firebase-ml 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: rilevamento di oggetti e modello di tracciamento 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 dei 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-lingua-naturale 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: 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 da Gradle Ultimo
versione
Aggiungere analisi?
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, rivedere le note di rilascio per quella versione della distinta base.

28.1.0
AdMob com.google.android.gms:play-services-ads 20.2.0
Analisi com.google.firebase:firebase-analytics-ktx 19.0.0
Plugin di distribuzione app com.google.firebase:firebase-appdistribution-gradle 2.1.2
Indicizzazione dell'app com.google.firebase:firebase-appindexing 20.0.0
Autenticazione com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.1
Funzioni cloud per Firebase Client SDK com.google.firebase:firebase-funzioni-ktx 20.0.0
Messaggistica cloud com.google.firebase:firebase-messaging-ktx 22.0.0
Archiviazione cloud com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.0.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.0.1
Plugin di Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.0
Supporto per moduli di funzionalità dinamici com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Collegamenti dinamici com.google.firebase:firebase-dynamic-links-ktx 20.1.0
Messaggi in-app com.google.firebase:firebase-inappmessaging-ktx 20.0.0
(necessario)
Visualizzazione messaggi in-app com.google.firebase:firebase-inappmessaging-display-ktx 20.0.0
(necessario)
Installazioni Firebase com.google.firebase:firebase-installations-ktx 17.0.0
API per il download di modelli ML Firebase com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
Monitoraggio delle prestazioni com.google.firebase:firebase-perf-ktx 20.0.1
Plugin per il monitoraggio delle prestazioni com.google.firebase:perf-plugin 1.4.0
Database in tempo reale com.google.firebase:firebase-database-ktx 20.0.0
Configurazione remota com.google.firebase:firebase-config-ktx 21.0.0
Plugin servizi Google Play Play com.google.gms:servizi-google 4.3.8
Librerie deprecate
API del modello personalizzato Firebase ML com.google.firebase: interprete-modello-firebase-ml 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: rilevamento di oggetti e modello di tracciamento 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 dei 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-lingua-naturale 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: 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:

Informazioni su Firebase: