Catch up on everthing we announced at this year's Firebase Summit. Learn more

Aggiungi Firebase al tuo progetto Android

Prerequisiti

  • Installare o aggiornare Android Studio alla sua ultima versione.

  • Assicurati che il tuo progetto soddisfi questi requisiti:

    • Mira al livello API 19 (KitKat) o superiore
    • Utilizza Android 4.4 o versioni successive
    • Utilizza Jetpack (AndroidX) , che comprende soddisfare questi requisiti di versione:
      • com.android.tools.build:gradle V3.2.1 o successivo
      • compileSdkVersion 28 o successivo
  • Configurare un dispositivo fisico o utilizzare un emulatore per eseguire la vostra applicazione.
    Si noti che Firebase SDK con una dipendenza da Google Play Services richiedere al dispositivo o emulatore di avere Google Play Services installati.

  • Accedi al Firebase utilizzando il tuo account Google.

Se non si dispone già di un progetto Android e volete solo provare un prodotto Firebase, è possibile scaricare uno dei nostri esempi rapidi .


Puoi connettere la tua app Android a Firebase utilizzando una delle seguenti opzioni:

  • Opzione 1 : (consigliato) Utilizzare il flusso di lavoro di configurazione della console Firebase.
  • Opzione 2 : utilizzare l'Android Studio Firebase Assistant (può richiedere una configurazione aggiuntiva).



Opzione 1: Aggiungere Firebase utilizzando la console Firebase

L'aggiunta di Firebase per la vostra applicazione comporta compiti sia nella console Firebase e nel progetto Android aperto (ad esempio, si scaricano i file di configurazione Firebase dalla console, poi li sposta nel progetto Android).

Passo 1: Creare un progetto Firebase

Prima di poter aggiungere Firebase alla tua app Android, devi creare un progetto Firebase per connetterti alla tua app Android. Visita Capire Firebase progetti per saperne di più su progetti Firebase.

Step 2: Registrare l'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 panoramica del progetto, fare clic sull'icona di Android ( ) o aggiungere app per lanciare il flusso di lavoro di installazione.

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

  4. (Facoltativo) Immettere altre informazioni app: App nickname e Debug firma certificato SHA-1.

  5. Fare clic su Registra app.

Passo 3: Aggiungere un file di configurazione Firebase

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

    1. Fare clic su Download google-services.json per ottenere il file di configurazione 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 Firebase prodotti nella vostra app, aggiungere i google-servizi plug ai file Gradle.

    1. In root-level (a livello di progetto) di file Gradle ( build.gradle ), aggiungere le regole per includere il plug-in di Google Servizi Gradle. 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.10'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. Nel modulo (a livello di app) File Gradle (di solito app/build.gradle ), applicare il plug-in di Google Servizi Gradle:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Fase 4: Aggiungere Firebase SDK per la vostra applicazione

  1. Utilizzando la Firebase Android BoM , dichiarare le dipendenze per i prodotti Firebase che si desidera utilizzare nella vostra applicazione. Li Dichiarare nel modulo (a livello di app) File Gradle (di solito app/build.gradle ).

    Analitica abilitata

    Giava

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.0.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:29.0.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'
    }
    

    Usando il Firebase Android BoM , la vostra applicazione sarà sempre utilizzare versioni compatibili delle librerie Firebase Android.

    Analitica non abilitata

    Giava

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.0.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:29.0.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'
    }
    

    Usando il Firebase Android BoM , la vostra applicazione sarà sempre utilizzare versioni compatibili delle librerie Firebase Android.

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

Questo è tutto! È possibile saltare avanti di controllare la raccomandata prossimi passi .

Se hai problemi a ottenere istituito, però, visitare la risoluzione dei problemi di Android e FAQ .



Opzione 2: Aggiungi Firebase utilizzando la Firebase Assistant

Il Firebase Assistant registra la vostra applicazione con un progetto Firebase e aggiunge i necessari file Firebase, plugin, e le dipendenze al progetto Android - il tutto all'interno di 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: Guida> Controlla aggiornamenti
    • MacOS: Android Studio> Verifica aggiornamenti
  2. Aprire la Firebase Assistente: Strumenti> Firebase.

  3. Nel riquadro Assistant, scegliere un prodotto Firebase da aggiungere alla vostra applicazione. Espandere la sua sezione, quindi fare clic sul collegamento tutorial (per esempio, Analytics> registrare un evento Analytics).

    1. Fare clic su Connetti per Firebase per collegare il progetto Android con Firebase.

    2. Fare clic sul pulsante per aggiungere un prodotto Firebase desiderata (ad esempio, Aggiungi Analytics per la tua app).

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

  5. Nel riquadro Assistant, seguire le istruzioni di configurazione rimanenti per il prodotto Firebase selezionato.

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

Questo è tutto! Assicuratevi di controllare la raccomandata prossimi passi .

Se hai problemi a ottenere istituito, però, visitare la risoluzione dei problemi di Android e FAQ .



Librerie disponibili

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

Si noti che quando si utilizza il Firebase Android distinta , non è necessario specificare le versioni singole di libreria quando si dichiara dipendenze di librerie Firebase in build.gradle .

Giava

Servizio o prodotto Dipendenza da Gradle Più recente
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.

29.0.1
AdMob com.google.android.gms:play-services-ads 20.5.0
Analisi com.google.firebase:firebase-analytics 20.0.0
App Check provider personalizzato com.google.firebase:firebase-appcheck 16.0.0-beta04
Provider di debug di App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta04
App Check fornitore SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta04
Plugin di distribuzione dell'app com.google.firebase:firebase-appdistribution-gradle 2.2.0
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 24.0.0
Funzioni cloud per Firebase Client SDK com.google.firebase:funzioni-firebase 20.0.1
Messaggistica cloud com.google.firebase:messaggi-firebase 23.0.0
Archiviazione cloud com.google.firebase:firebase-storage 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.5
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.5
Plugin di Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.8.1
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 21.0.0
Messaggi in-app com.google.firebase:firebase-inappmessaging 20.1.1
(necessario)
Visualizzazione messaggi in-app com.google.firebase:firebase-inappmessaging-display 20.1.1
(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.1
Monitoraggio delle prestazioni com.google.firebase:firebase-perf 20.0.4
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.3
Configurazione remota com.google.firebase:firebase-config 21.0.1
Plugin servizi Google Play com.google.gms:servizi-google 4.3.10
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 Più recente
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.

29.0.1
AdMob com.google.android.gms:play-services-ads 20.5.0
Analisi com.google.firebase:firebase-analytics-ktx 20.0.0
App Check provider personalizzato com.google.firebase:firebase-appcheck 16.0.0-beta04
Provider di debug di App Check com.google.firebase:firebase-appcheck-debug 16.0.0-beta04
App Check fornitore SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta04
Plugin di distribuzione app com.google.firebase:firebase-appdistribution-gradle 2.2.0
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 24.0.0
Funzioni cloud per Firebase Client SDK com.google.firebase:firebase-funzioni-ktx 20.0.1
Messaggistica cloud com.google.firebase:firebase-messaging-ktx 23.0.0
Archiviazione cloud com.google.firebase:firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.5
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.5
Plugin di Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.8.1
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 21.0.0
Messaggi in-app com.google.firebase:firebase-inappmessaging-ktx 20.1.1
(necessario)
Visualizzazione messaggi in-app com.google.firebase:firebase-inappmessaging-display-ktx 20.1.1
(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.1
Monitoraggio delle prestazioni com.google.firebase:firebase-perf-ktx 20.0.4
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.3
Configurazione remota com.google.firebase:firebase-config-ktx 21.0.1
Plugin servizi Google Play com.google.gms:servizi-google 4.3.10
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: