Aggiungi Firebase al tuo progetto Unity

Migliora i tuoi giochi Unity con i nostri SDK Firebase Unity.

Per mostrare quanto sia facile integrare Firebase nel tuo progetto Unity, abbiamo creato un gioco di esempio, MechaHamster. Se vuoi provare ad aggiungere Firebase a un gioco, utilizza la versione iniziale disponibile su GitHub. Se vuoi una versione completa, dai un'occhiata alle versioni nell'App Store o nel Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Scopri di più su come migliorare i tuoi giochi con Firebase nella nostra pagina dei giochi di Firebase.

Hai già aggiunto Firebase al tuo progetto Unity? Assicurati di utilizzare l'ultima versione dell'SDK Firebase Unity.

Prerequisiti

  • Installa Unity 2021 LTS o versioni successive. Il supporto di Unity 2020 è considerato deprecato e non sarà più supportato attivamente dopo la prossima release principale. Anche le versioni precedenti potrebbero essere compatibili, ma non saranno supportate attivamente.

  • (Solo piattaforme Apple) Installa quanto segue:

    • Xcode 13.3.1 o versioni successive
    • CocoaPods 1.12.0 o versioni successive

  • Assicurati che il tuo progetto Unity soddisfi questi requisiti:

    • Per iOS: ha come target iOS 13 o versioni successive
    • Per tvOS: ha come target tvOS 13 o versioni successive
    • Per Android: ha come target il livello API 21 (Lollipop) o versioni successive

  • Configura un dispositivo fisico o utilizza un emulatore per eseguire l'app.

    • Per le piattaforme Apple: configura un dispositivo fisico o utilizza un simulatore iOS o tvOS.

    • Per Android: gli emulatori devono utilizzare un'immagine dell'emulatore con Google Play.

Se non hai ancora un progetto Unity e vuoi solo provare un prodotto Firebase, puoi scaricare uno dei nostri esempi di avvio rapido.

Passaggio 1: crea un progetto Firebase

Prima di poter aggiungere Firebase al tuo progetto Unity, devi creare un progetto Firebase a cui connetterti. Visita la pagina Informazioni sui progetti Firebase per scoprire di più sui progetti Firebase.

Passaggio 2: registra la tua app con Firebase

Puoi registrare una o più app o giochi da connettere al tuo progetto Firebase.

  1. Vai alla console Firebase.

  2. Al centro della pagina di riepilogo del progetto, fai clic sull'icona Unity () per avviare il flusso di lavoro della configurazione.

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

  3. Seleziona la destinazione di build del progetto Unity che vuoi registrare oppure puoi selezionare la registrazione di entrambe le destinazioni contemporaneamente.

  4. Inserisci gli ID specifici per la piattaforma del tuo progetto Unity.

    • Per iOS: inserisci l'ID iOS del tuo progetto Unity nel campo ID bundle iOS.

    • Per Android: inserisci l'ID Android del tuo progetto Unity nel campo Nome pacchetto Android.
      I termini nome del pacchetto e ID applicazione vengono spesso utilizzati in modo intercambiabile.

  5. (Facoltativo) Inserisci i nickname specifici per la piattaforma del tuo progetto Unity.
    Questi nickname sono identificatori interni e pratici e sono visibili solo a te nella console Firebase.

  6. Fai clic su Registra app.

Passaggio 3: aggiungi i file di configurazione di Firebase

  1. Ottieni i file di configurazione di Firebase specifici per la piattaforma nel flusso di lavoro di configurazione della console Firebase.

    • Per iOS: fai clic su Scarica GoogleService-Info.plist.

    • Per Android: fai clic su Scarica google-services.json.

  2. Apri la finestra Progetto del tuo progetto Unity, quindi sposta i file di configurazione nella cartella Assets.

  3. Nella console Firebase, nel flusso di lavoro di configurazione, fai clic su Avanti.

Passaggio 4: aggiungi gli SDK Firebase Unity

  1. Nella console Firebase, fai clic su Scarica Firebase Unity SDK, quindi decomprimi l'SDK in una posizione comoda.

    • Puoi scaricare di nuovo l'SDK Firebase Unity in qualsiasi momento.

    • L'SDK Firebase Unity non è specifico della piattaforma.

  2. Nel tuo progetto Unity aperto, vai a Assets > Import Package > Custom Package (Risorse > Importa pacchetto > Pacchetto personalizzato).

  3. Dall'SDK non compresso, seleziona i prodotti Firebase supportati che vuoi utilizzare nella tua app.

    Analytics abilitato

    • Aggiungi il pacchetto Firebase per Google Analytics: FirebaseAnalytics.unitypackage
    • Aggiungi i pacchetti per tutti gli altri prodotti Firebase che vuoi utilizzare nella tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:
      FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

    Analytics non abilitato

    Aggiungi i pacchetti per i prodotti Firebase che vuoi utilizzare nella tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:
    FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

  4. Nella finestra Import Unity Package (Importa il pacchetto Unity), fai clic su Import (Importa).

  5. Nella console Firebase, nel flusso di lavoro di configurazione, fai clic su Avanti.

Passaggio 5: conferma i requisiti della versione di Google Play Services

Alcuni prodotti dell'SDK Firebase Unity per Android richiedono Google Play services. Scopri quali prodotti hanno questa dipendenza. Google Play services deve essere aggiornato prima di poter utilizzare questi prodotti.

Aggiungi la seguente istruzione using e il codice di inizializzazione all'inizio dell'applicazione. Puoi controllare e, se vuoi, aggiornare Google Play services alla versione richiesta prima di chiamare altri metodi nell'SDK.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

È tutto pronto. Il tuo progetto Unity è registrato e configurato per utilizzare Firebase.

Se hai difficoltà con la configurazione, consulta la Risoluzione dei problemi e domande frequenti su Unity.

Configurare un flusso di lavoro desktop (beta)

Quando crei un gioco, spesso è molto più facile testarlo prima nell'editor Unity e sulle piattaforme desktop, per poi eseguirne il deployment e il test sui dispositivi mobili in un secondo momento dello sviluppo. Per supportare questo flusso di lavoro, forniamo un sottoinsieme degli SDK Firebase Unity che possono essere eseguiti su Windows, macOS, Linux e all'interno dell'editor Unity.

  1. Configura un progetto Unity per la piattaforma desktop seguendo le stesse istruzioni per una piattaforma mobile (inizia con il passaggio Registra la tua app con Firebase riportato sopra).

  2. Esegui il progetto Unity nell'IDE Unity o seleziona la creazione del progetto Unity per computer.

  3. (Facoltativo) Esegui il progetto Unity in modalità Modifica.

    L'SDK Firebase Unity può essere eseguito anche in modalità di modifica di Unity, consentendone l'utilizzo nei plug-in dell'editor.

    1. Quando crei un FirebaseApp utilizzato dall'editor, non utilizzare l'istanza predefinita.

    2. Fornisci invece un nome univoco alla chiamata FirebaseApp.Create().

      Questo è importante per evitare un conflitto nelle opzioni tra l'istanza utilizzata dall'IDE Unity e l'istanza utilizzata dal tuo progetto Unity.

Prodotti Firebase supportati

Scopri di più sulle librerie Unity Firebase nella documentazione di riferimento.

Librerie Firebase disponibili per il mobile

L'SDK Firebase Unity supporta i seguenti prodotti Firebase su Apple e Android:

Prodotto Firebase Pacchetto Unity
AdMob Distribuito separatamente nel plug-in Unity AdMob
Firebase AI Logic FirebaseAI.unitypackage
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(consigliato) FirebaseAnalytics.unitypackage

Librerie Firebase disponibili per computer

L'SDK Firebase Unity include il supporto del flusso di lavoro desktop per un sottoinsieme di prodotti, consentendo l'utilizzo di determinate parti di Firebase nell'editor Unity e in build desktop autonome su Windows, macOS e Linux.

Prodotto Firebase (computer) Pacchetto Unity
Firebase AI Logic FirebaseAI.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

Firebase fornisce le librerie desktop rimanenti come implementazioni stub (non funzionali) per comodità durante la creazione per Windows, macOS e Linux. Pertanto, non è necessario compilare codice in modo condizionale per il targeting del desktop.

Passaggi successivi