欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

Aggiungi Firebase al tuo progetto Android

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.

  1. Vai alla console Firebase .

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

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

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

  5. Fare clic su Registra app .

Passaggio 3 : aggiungi un file di configurazione di Firebase

  1. Scarica e quindi aggiungi il file di configurazione di Firebase Android ( google-services.json ) alla tua app:

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

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

  2. Per rendere i valori nel file di configurazione google-services.json accessibili agli SDK Firebase, è necessario il plug-in Gradle dei servizi Google ( google-services ).

    1. Nel tuo file Gradle a livello di root (a livello di progetto) ( <project>/build.gradle ), aggiungi il plug-in dei servizi Google come dipendenza buildscript:

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.14'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. Nel file Gradle del tuo modulo (a livello di app) (di solito <project>/<app-module>/build.gradle ), aggiungi il plug-in dei servizi di Google:

      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

  1. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle ), aggiungi le dipendenze per i prodotti Firebase che desideri utilizzare nella tua app. Ti consigliamo di utilizzare la BoM Android di Firebase per controllare il controllo delle versioni della libreria.

    Analisi abilitata

    Java

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

    Kotlin+KTX

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

    Kotlin+KTX

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

  2. Dopo aver aggiunto le dipendenze per i prodotti che desideri utilizzare, sincronizza il tuo progetto Android con i file Gradle.

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!

  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 > Verifica aggiornamenti
    • macOS: Android Studio > Verifica aggiornamenti
  2. Apri l'Assistente Firebase: Strumenti > Firebase .

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

    1. Fai clic su Connetti a Firebase per connettere il tuo progetto Android a 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 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:

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.4.1
AdMob com.google.android.gms:play-services-ads 21.2.0
Analitica com.google.firebase:firebase-analytics 21.1.1
App Check provider personalizzato com.google.firebase:firebase-appcheck 16.0.2
Provider di debug di App Check com.google.firebase:firebase-appcheck-debug 16.0.2
App Check Play Integrity provider com.google.firebase:firebase-appcheck-playintegrity 16.0.2
App Controllare il provider SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.2
Distribuzione dell'app com.google.firebase:firebase-appdistribution 16.0.0-beta04
API di distribuzione dell'app com.google.firebase:firebase-appdistribution-api 16.0.0-beta04
Plugin di distribuzione dell'app com.google.firebase:firebase-appdistribution-gradle 3.0.3
Autenticazione com.google.firebase:firebase-auth 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore 24.3.1
Funzioni cloud per Firebase Client SDK com.google.firebase: funzioni-firebase 20.1.1
Messaggistica cloud com.google.firebase: messaggistica di firebase 23.0.8
Archiviazione su cloud com.google.firebase:firebase-storage 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Plugin Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Supporto per moduli di funzionalità dinamici com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Collegamenti dinamici com.google.firebase: collegamenti dinamici-firebase 21.0.2
Messaggistica in-app com.google.firebase:firebase-inappmessaging 20.1.3
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase:firebase-inappmessaging-display 20.1.3
(necessario)
Installazioni Firebase com.google.firebase: installazioni-firebase 17.0.3
API per il download del modello di Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.0.5
Monitoraggio delle prestazioni com.google.firebase:firebase-perf 20.1.1
Plugin di monitoraggio delle prestazioni com.google.firebase:perf-plugin 1.4.1
Database in tempo reale com.google.firebase: database-firebase 20.0.6
Configurazione remota com.google.firebase:firebase-config 21.1.2
Plugin dei servizi di Google Play com.google.gms:servizi-google 4.3.14
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.4.1
AdMob com.google.android.gms:play-services-ads 21.2.0
Analitica com.google.firebase:firebase-analytics-ktx 21.1.1
App Check provider personalizzato com.google.firebase:firebase-appcheck-ktx 16.0.2
Provider di debug di App Check com.google.firebase:firebase-appcheck-debug 16.0.2
App Controllare il provider SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.2
API di distribuzione dell'app com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta04
Plugin di distribuzione dell'app com.google.firebase:firebase-appdistribution-gradle 3.0.3
Autenticazione com.google.firebase:firebase-auth-ktx 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.3.1
Funzioni cloud per Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.1.1
Messaggistica cloud com.google.firebase:firebase-messaging-ktx 23.0.8
Archiviazione su cloud com.google.firebase:firebase-storage-ktx 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Plugin Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Supporto per moduli di funzionalità dinamici com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Collegamenti dinamici com.google.firebase:firebase-dynamic-links-ktx 21.0.2
Messaggistica in-app com.google.firebase:firebase-inappmessaging-ktx 20.1.3
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase:firebase-inappmessaging-display-ktx 20.1.3
(necessario)
Installazioni Firebase com.google.firebase:firebase-installations-ktx 17.0.3
API per il download del modello di Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.5
Monitoraggio delle prestazioni com.google.firebase:firebase-perf-ktx 20.1.1
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.6
Configurazione remota com.google.firebase:firebase-config-ktx 21.1.2
Plugin dei servizi di Google Play com.google.gms:servizi-google 4.3.14
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:

Ulteriori informazioni su Firebase: