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 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 Comprendere i 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, fare 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 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 tuo file di configurazione Android 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.4'  // 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. Utilizzando Firebase Android BoM , 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 ).

    Analytics abilitato

    Giava

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

    Analytics non abilitato

    Giava

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.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:26.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 saltare avanti per controllare i passaggi successivi consigliati.



Opzione 2 : aggiungi Firebase utilizzando l'Assistente Firebase

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, il tutto da Android Studio!

  1. Apri il tuo progetto Android in Android Studio e accedi a Firebase Assistant:

    1. Vai a File> Verifica aggiornamenti per assicurarti di utilizzare le ultime versioni di Android Studio e Firebase Assistant.

    2. Vai su Strumenti> Firebase per aprire il pannello Assistente .

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

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

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

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

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

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



Librerie disponibili

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

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 .

Giava

Servizio o prodotto Gradle dipendenza Ultimo
versione
Aggiungere Analytics?
Firebase Android BoM
(Distinta base)
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 versione BoM specifica, rivedere le note di rilascio per quella versione BoM.

26.1.0
AdMob com.google.android.gms: play-services-ads 19.5.0
Analytics com.google.firebase: firebase-analytics 18.0.0
Indicizzazione delle app com.google.firebase: firebase-appindexing 19.1.0
Autenticazione com.google.firebase: firebase-auth 20.0.1
Cloud Firestore com.google.firebase: firebase-firestore 22.0.0
Cloud Functions per Firebase Client SDK com.google.firebase: firebase-functions 19.1.0
Messaggistica cloud com.google.firebase: firebase-messaging 21.0.0
Cloud Storage com.google.firebase: firebase-storage 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics 17.3.0
Collegamenti dinamici com.google.firebase: firebase-dynamic-links 19.1.1
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.2
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase: firebase-inappmessaging-display 19.1.2
(necessario)
Monitoraggio delle prestazioni com.google.firebase: firebase-perf 19.0.10
Database in tempo reale com.google.firebase: firebase-database 19.5.1
Configurazione remota com.google.firebase: firebase-config 20.0.1
Plugin dei servizi di Google Play com.google.gms: google-services 4.3.4
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 Gradle dipendenza Ultimo
versione
Aggiungere Analytics?
Firebase Android BoM
(Distinta base)
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 versione BoM specifica, rivedere le note di rilascio per quella versione BoM.

26.1.0
AdMob com.google.android.gms: play-services-ads 19.5.0
Analytics com.google.firebase: firebase-analytics-ktx 18.0.0
Indicizzazione delle app com.google.firebase: firebase-appindexing 19.1.0
Autenticazione com.google.firebase: firebase-auth-ktx 20.0.1
Cloud Firestore com.google.firebase: firebase-firestore-ktx 22.0.0
Cloud Functions per Firebase Client SDK com.google.firebase: firebase-functions-ktx 19.1.0
Messaggistica cloud com.google.firebase: firebase-messaging-ktx 21.0.0
Cloud Storage com.google.firebase: firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 17.3.0
Collegamenti dinamici com.google.firebase: firebase-dynamic-links-ktx 19.1.1
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.2
(necessario)
Visualizzazione della messaggistica in-app com.google.firebase: firebase-inappmessaging-display-ktx 19.1.2
(necessario)
Monitoraggio delle prestazioni com.google.firebase: firebase-perf-ktx 19.0.10
Database in tempo reale com.google.firebase: firebase-database-ktx 19.5.1
Configurazione remota com.google.firebase: firebase-config-ktx 20.0.1
Plugin dei servizi di Google Play com.google.gms: google-services 4.3.4
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

Aggiungi i servizi Firebase alla tua app:

Informazioni su Firebase: