Aggiungi Firebase al tuo progetto Unity

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

Per mostrare quanto sia facile collegare Firebase al tuo progetto Unity, abbiamo realizzato un gioco di esempio, MechaHamster. Se vuoi provare ad aggiungere Firebase a un gioco, utilizza la versione iniziale disponibile su GitHub . Se desideri una versione completa, controlla le versioni nell'App Store o nel Google Play Store .

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Scopri ulteriori informazioni su come potenziare i tuoi giochi con Firebase nella nostra pagina dei giochi Firebase .

Hai già aggiunto Firebase al tuo progetto Unity? Assicurati di utilizzare la versione più recente dell'SDK Firebase Unity .

Prerequisiti

  • Installa Unity 2019.1 o versione successiva. Anche le versioni precedenti potrebbero essere compatibili ma non saranno supportate attivamente. Il supporto per Unity 2019.1 è considerato deprecato e non sarà più supportato attivamente dopo la prossima versione principale.

  • (Solo piattaforme Apple) Installare quanto segue:

    • Xcode 13.3.1 o versione successiva
    • CocoaPods 1.10.0 o successiva

  • Assicurati che il tuo progetto Unity soddisfi questi requisiti:

    • Per iOS : è destinato a iOS 11 o versioni successive
    • Per tvOS : è destinato a tvOS 12 o versioni successive
    • Per Android : ha come target il livello API 19 (KitKat) o superiore

  • Configura un dispositivo fisico o utilizza un emulatore per eseguire la tua app.

    • Per 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 disponi già di un progetto Unity e desideri semplicemente 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 per connetterti al tuo progetto Unity. Visita Comprendere i progetti Firebase per ulteriori informazioni sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Puoi registrare una o più app o giochi per connetterti al tuo progetto Firebase.

  1. Vai alla console Firebase .

  2. Al centro della pagina di panoramica del progetto, fai clic sull'icona Unity ( ) 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. Seleziona quale destinazione di build del tuo progetto Unity desideri registrare oppure puoi anche scegliere di registrare entrambe le destinazioni contemporaneamente.

  4. Inserisci gli ID specifici della 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 del nome del pacchetto Android .
      I termini nome pacchetto e ID applicazione vengono spesso utilizzati in modo intercambiabile.

  5. (Facoltativo) Inserisci i nickname specifici della 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 Firebase specifici della 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. Tornando alla 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 un posto comodo.

    • Puoi scaricare nuovamente 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 .

  3. Dall'SDK decompresso, seleziona i prodotti Firebase supportati che desideri utilizzare nella tua app.

    Analisi abilitata

    • Aggiungi il pacchetto Firebase per Google Analytics: FirebaseAnalytics.unitypackage
    • Aggiungi i pacchetti per tutti gli altri prodotti Firebase che desideri utilizzare nella tua app. Ad esempio, per utilizzare l'autenticazione Firebase e il database Firebase Realtime:
      FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

    Analisi non abilitata

    Aggiungi i pacchetti per i prodotti Firebase che desideri utilizzare nella tua app. Ad esempio, per utilizzare l'autenticazione Firebase e il database Firebase Realtime:
    FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

  4. Nella finestra Importa pacchetto Unity , fare clic su Importa .

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

Passaggio 5 : conferma i requisiti della versione dei servizi Google Play

L'SDK Firebase Unity per Android richiede i servizi Google Play , che devono essere aggiornati prima di poter utilizzare l'SDK.

Aggiungi il seguente codice all'inizio della tua applicazione. Puoi verificare e facoltativamente aggiornare i servizi Google Play alla versione richiesta dall'SDK Firebase Unity prima di chiamare qualsiasi altro metodo nell'SDK.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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 riscontri problemi durante la configurazione, visita la sezione Risoluzione dei problemi e domande frequenti di Unity .

Configura un flusso di lavoro desktop ( beta )

Quando crei un gioco, spesso è molto più semplice testarlo prima nell'editor Unity e sulle piattaforme desktop, quindi distribuirlo e testarlo sui dispositivi mobili in una fase successiva dello sviluppo. Per supportare questo flusso di lavoro, forniamo un sottoinsieme degli SDK Firebase Unity che possono essere eseguiti su Windows, macOS, Linux e dall'editor Unity.

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

  2. Esegui il tuo progetto Unity nell'IDE Unity o scegli di creare il tuo progetto Unity per desktop .

  3. (Facoltativo) Esegui il tuo progetto Unity in modalità di modifica.

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

    1. Quando crei una FirebaseApp utilizzata dall'editor, non utilizzare l'istanza predefinita.

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

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

Prodotti Firebase supportati

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

Librerie Firebase disponibili per dispositivi mobili

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

Prodotto Firebase Pacchetto unitario
AdMob Distribuito separatamente nel plug-in AdMob Unity
Analitica FirebaseAnalytics.unitypackage
Controllo dell'app FirebaseAppCheck.unitypackage
Autenticazione FirebaseAuth.unitypackage
Cloud Fire Store FirebaseFirestore.unitypackage
Funzioni del cloud FirebaseFunctions.unitypackage
Messaggistica sul cloud FirebaseMessaging.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Archiviazione nel cloud FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Collegamenti dinamici FirebaseDynamicLinks.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Banca dati in tempo reale FirebaseDatabase.unitypackage
Configurazione remota FirebaseRemoteConfig.unitypackage
(consigliato) FirebaseAnalytics.unitypackage

Librerie Firebase disponibili per desktop

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

Prodotto Firebase (desktop) Pacchetto unitario
Controllo dell'app FirebaseAppCheck.unitypackage
Autenticazione FirebaseAuth.unitypackage
Funzioni del cloud FirebaseFunctions.unitypackage
Cloud Fire Store FirebaseFirestore.unitypackage
Archiviazione nel cloud FirebaseStorage.unitypackage
Banca dati in tempo reale FirebaseDatabase.unitypackage
Configurazione remota FirebaseRemoteConfig.unitypackage

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

Prossimi passi