Risoluzione dei problemi e domande frequenti per Unity e Firebase

Questa pagina offre suggerimenti e risoluzione dei problemi specifici di Unity che potresti riscontrare durante l'utilizzo di Firebase.

Hai altre sfide o non vedi il tuo problema descritto di seguito? Assicurati di consultare le domande frequenti principali di Firebase per altre domande frequenti su Firebase o specifiche per prodotto.

Un problema con il singolo dex durante la creazione dell'app per Android

Durante la creazione dell'app per Android, potresti riscontrare un errore di build correlato alla presenza di un singolo file dex. Il messaggio di errore è simile al seguente se il tuo progetto è configurato per utilizzare il sistema di build Gradle.

Cannot fit requested classes in a single dex file.

I file Dalvik Executable (.dex) vengono utilizzati per contenere un insieme di definizioni di classe e i relativi dati aggiuntivi per le applicazioni Android (.apk). Un singolo file dex può fare riferimento a un massimo di 65.536 metodi. La build non andrà a buon fine se il numero totale di metodi di tutte le librerie Android nel tuo progetto supera questo limite.

Unity ha introdotto la minimizzazione nella versione 2017.2, che utilizza Proguard (o altri strumenti in alcune versioni di Unity) per eliminare il codice inutilizzato, il che può ridurre il numero totale di metodi a cui viene fatto riferimento in un singolo file dex. L'opzione si trova in Impostazioni del giocatore > Android > Impostazioni di pubblicazione > Minify. Le opzioni potrebbero differire nelle diverse versioni di Unity, pertanto consulta la documentazione ufficiale di Unity.

Se il numero di metodi di riferimento supera ancora il limite, un'altra opzione è attivare multidex. Esistono diversi modi per farlo in Unity:

  • Se Custom Gradle Template in Player Settings è abilitato, modifica mainTemplate.gradle.
  • Se utilizzi Android Studio per creare il progetto esportato, modifica il file build.gradle a livello di modulo.

Per ulteriori dettagli, consulta la guida dell'utente di multidex.

Problemi durante la creazione per Android con minSdkVersion 23

Quando crei build per Android, se scegli come target minSdkVersion 23, la procedura potrebbe non riuscire nel passaggio di dexing, di solito nell'attività Gradle ":launcher:mergeExtDexDebug", dove viene visualizzato il messaggio "Failed to transform" (Impossibile trasformare) per una delle librerie Android. Ciò è dovuto a un bug nello strumento dex predefinito dell'SDK Android utilizzato dalla maggior parte degli editor Unity e può essere risolto in diversi modi:

  • Imposta minSdkVersion su 24.
  • Attiva la minimizzazione di Android in Impostazioni del player > Android > Impostazioni di pubblicazione > Minimizza.
  • Specifica una versione diversa dello strumento dex aggiungendo questo codice al file settingsTemplate.gradle:
buildscript {
  repositories {
    mavenLocal()
    maven { url 'https://maven.google.com'  }
    mavenCentral()
  }
  dependencies {
    classpath 'com.android.tools:r8:8.3.37'
  }
}

Problemi durante la creazione per iOS con Cocoapods

Quando crei una build per iOS, l'installazione di Cocoapod potrebbe non riuscire a causa di un errore relativo alle impostazioni internazionali della lingua o alla codifica UTF-8. Al momento esistono diversi modi per risolvere il problema.

  • Dal terminale, esegui pod install direttamente e apri il file xcworkspace risultante.

  • Esegui il downgrade della versione di CocoaPods alla 1.10.2. Il problema esiste solo nella versione 1.11 e successive.

  • Nel tuo ~/.bash_profile o equivalente, aggiungi export LANG=en_US.UTF-8

Come aggiornare la versione degli SDK Firebase Unity

La procedura per aggiornare le versioni degli SDK Firebase Unity dipende da come sono stati importati inizialmente. Ecco i due metodi di importazione alternativi:

  • Importazione di file .unitypackage nella directory Assets/ del progetto
  • Importazione tramite Unity Package Manager (UPM)
    • Questo è il modo consigliato per gestire i pacchetti in Unity 2018.4 e versioni successive.
    • Utilizza questo metodo per semplificare gli aggiornamenti delle versioni future e la pulizia della directory Assets/.

Nel tuo progetto Unity, devi utilizzare un solo metodo di importazione per gestire tutti i tuoi pacchetti Firebase. Le istruzioni riportate di seguito possono essere utilizzate non solo per aggiornare la versione dei singoli pacchetti, ma anche, se necessario, per eseguire la migrazione della gestione dei pacchetti a UPM (il metodo di importazione consigliato).