Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Aggiungi Firebase al tuo progetto Android

Prerequisiti

  • Installa o aggiorna Android Studio alla sua ultima versione.

  • 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 la soddisfazione di questi requisiti di versione:
      • com.android.tools.build:gradle v3.2.1 o successiva
      • compileSdkVersion 28 o successivo
  • Configura un dispositivo fisico o usa un emulatore per eseguire la tua app.
    Gli emulatori devono utilizzare un'immagine dell'emulatore con Google Play.

  • Accedi a Firebase utilizzando il tuo account Google.

Se non hai già un progetto Android e vuoi solo 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) utilizza il flusso di lavoro di configurazione della console Firebase.
  • Opzione 2 : utilizza l'Assistente Firebase di Android Studio (richiede 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 Comprendere i progetti Firebase per ulteriori informazioni sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Dopo aver creato un progetto Firebase, puoi aggiungervi la tua app Android.

Visita Comprendere i progetti Firebase per saperne di più sulle best practice e considerazioni per l'aggiunta di app a un progetto Firebase, incluso come gestire più varianti di build.

  1. Vai alla console Firebase .

  2. Al centro della pagina di panoramica del progetto, fare clic sull'icona Android ( ) per avviare il flusso di lavoro di configurazione.

    Se hai già aggiunto un'app al tuo progetto Firebase, fai clic su Aggiungi app per visualizzare le opzioni della piattaforma.

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

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

  5. Fare clic su Registra app .

Passaggio 3 : aggiungi un file di configurazione Firebase

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

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

    2. Sposta il 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 dei servizi Google 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.3'  // 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) (solitamente app/build.gradle ), applica il plug-in Gradle dei servizi di Google:

      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. Al file Gradle del modulo (a livello di app) (in genere app/build.gradle ), aggiungi le dipendenze per i prodotti Firebase che desideri utilizzare nella tua app.

    Analytics abilitato

    Giava

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Analytics non abilitato

    Giava

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    
  2. Sincronizza la tua app per assicurarti che tutte le dipendenze abbiano le versioni necessarie.

Questo è tutto! Puoi saltare ai passaggi successivi .

Opzione 2 : aggiungi Firebase utilizzando l'Assistente Firebase

L' Assistente Firebase registra la tua app con un progetto Firebase e aggiunge i file e il codice Firebase necessari al tuo progetto Android, il tutto da Android Studio.

Tieni presente che l'opzione consigliata per connettere la tua app a Firebase è utilizzare il flusso di lavoro di configurazione della console Firebase .

  1. Apri il tuo progetto Android in Android Studio.

  2. Seleziona Strumenti> Firebase per aprire il pannello Assistente .

  3. Scegli un prodotto Firebase da aggiungere alla tua app. Espandere la relativa sezione, quindi fare clic sul collegamento del tutorial (ad esempio, Analytics > Registra un evento di Analytics ).

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

  5. Nel riquadro Firebase Assistant, fai clic sul pulsante per aggiungere la dipendenza della libreria per il prodotto Firebase selezionato (ad esempio, Aggiungi Analytics alla tua app ).

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

  7. Se hai aggiunto Analytics, esegui la tua app per inviare a Firebase la verifica di aver integrato correttamente Firebase. Altrimenti, puoi saltare questo passaggio di verifica.

    I registri del dispositivo mostreranno la verifica Firebase che l'inizializzazione è stata completata. Se hai eseguito la tua app su un emulatore con accesso alla rete, la console Firebase ti avvisa che la connessione dell'app è stata completata.

  8. Nel riquadro Firebase Assistant, segui le restanti istruzioni di configurazione per il prodotto Firebase selezionato.

  9. Aggiungi tutti gli altri prodotti Firebase che desideri tramite l'Assistente Firebase!

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

Controlla il controllo delle versioni delle librerie con una distinta materiali (BoM) Firebase

Per una gestione più semplice della versione della libreria, valuta la possibilità di importare una distinta base (BoM) Firebase.

Librerie disponibili

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

Giava

Servizio o prodotto Dipendenze di grado Aggiungere Analytics?
AdMob com.google.android.gms: play-services-ads: 19.4.0
Analytics com.google.firebase: firebase-analytics: 17.5.0
Indicizzazione delle app com.google.firebase: firebase-appindexing: 19.1.0
Autenticazione com.google.firebase: firebase-auth: 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore: 21.6.0
Cloud Functions per Firebase Client SDK com.google.firebase: funzioni firebase: 19.1.0
Messaggistica cloud com.google.firebase: firebase-messaging: 20.2.4
Cloud Storage com.google.firebase: firebase-storage: 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics: 17.2.1
Collegamenti dinamici com.google.firebase: firebase-dynamic-links: 19.1.0
API Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.1.0
API Firebase ML Custom Model com.google.firebase: firebase-ml-model-interpreter: 22.0.4
Messaggistica in-app com.google.firebase: firebase-inappmessaging: 19.1.1
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase: firebase-inappmessaging-display: 19.1.1
(necessario)
Monitoraggio delle prestazioni com.google.firebase: firebase-perf: 19.0.8
Database in tempo reale com.google.firebase: firebase-database: 19.4.0
Configurazione remota com.google.firebase: firebase-config: 19.2.0
Distinta base Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

L'ultima versione di Firebase BoM contiene le ultime versioni di ciascuna libreria Firebase Android disponibile al rilascio di BoM. Per le versioni della libreria mappate alle precedenti versioni BoM, rivedere le note di rilascio per quella versione.

Plugin per i servizi di Google Play com.google.gms: google-services: 4.3.3
Librerie deprecate
Firebase ML: modello di etichettatura dell'immagine 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: Face Detection Model 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-natural-language: 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 Dipendenze di grado Aggiungere Analytics?
AdMob com.google.android.gms: play-services-ads: 19.4.0
Analytics com.google.firebase: firebase-analytics-ktx: 17.5.0
Indicizzazione delle app com.google.firebase: firebase-appindexing: 19.1.0
Autenticazione com.google.firebase: firebase-auth-ktx: 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx: 21.6.0
Cloud Functions per Firebase Client SDK com.google.firebase: firebase-functions-ktx: 19.1.0
Messaggistica cloud com.google.firebase: firebase-messaging: 20.2.4
Cloud Storage com.google.firebase: firebase-storage-ktx: 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx: 17.2.1
Collegamenti dinamici com.google.firebase: firebase-dynamic-links-ktx: 19.1.0
API Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.1.0
API Firebase ML Custom Model com.google.firebase: firebase-ml-model-interpreter: 22.0.4
Messaggistica in-app com.google.firebase: firebase-inappmessaging-ktx: 19.1.1
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase: firebase-inappmessaging-display-ktx: 19.1.1
(necessario)
Monitoraggio delle prestazioni com.google.firebase: firebase-perf: 19.0.8
Database in tempo reale com.google.firebase: firebase-database-ktx: 19.4.0
Configurazione remota com.google.firebase: firebase-config-ktx: 19.2.0
Distinta base Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

L'ultima versione di Firebase BoM contiene le ultime versioni di ciascuna libreria Firebase Android disponibile al rilascio di BoM. Per le versioni della libreria mappate alle precedenti versioni BoM, rivedere le note di rilascio per quella versione.

Plugin dei servizi di Google Play com.google.gms: google-services: 4.3.3
Librerie deprecate
Firebase ML: modello di etichettatura dell'immagine 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: Face Detection Model 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-natural-language: 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

Informazioni su Firebase:

Aggiungi i servizi Firebase alla tua app: