Fehlerbehebung & Häufig gestellte Fragen zu Unity und Firebase

Auf dieser Seite finden Sie Tipps und Informationen zur Fehlerbehebung bei Unity-spezifischen Problemen, die bei der Verwendung von Firebase auftreten können.

Sie haben andere Probleme oder können das unten beschriebene Problem nicht sehen? Weitere Firebase-spezifische oder allgemeine Fragen und Antworten finden Sie in den häufig gestellten Fragen zu Firebase.

.NET-Kompatibilität bei Verwendung von Unity 2017.x und höher

Firebase unterstützt .NET 4.x als experimentelle Buildoption in Unity 2017 und höher. Firebase-Plug-ins verwenden Komponenten des Parse SDK, um einige .NET 4.x-Klassen in früheren .NET-Versionen bereitzustellen.

Daher sind im Firebase Unity SDK ab Version 5.4.0 Plug-ins enthalten, die entweder mit .NET 3.x oder .NET 4.x kompatibel sind. Sie finden sie in den Verzeichnissen dotnet3 und dotnet4 des Firebase Unity SDK.

Wenn Sie ein Firebase-Plug-in importieren, das nicht mit der in Ihrem Projekt aktivierten .NET-Version kompatibel ist, werden beim Kompilieren einiger Typen im .NET-Framework, die vom Parse SDK implementiert werden, Fehler angezeigt.

So beheben Sie den Kompilierungsfehler, wenn Sie .NET 3.x verwenden:

  1. Entfernen oder deaktivieren Sie die folgenden DLLs für alle Plattformen:
    • Parse/Plugins/dotNet45/Unity.Compat.dll
    • Parse/Plugins/dotNet45/Unity.Tasks.dll
  2. Aktiviere die folgenden DLLs für alle Plattformen:
    • Parse/Plugins/Unity.Compat.dll
    • Parse/Plugins/Unity.Tasks.dll

So beheben Sie den Kompilierungsfehler, wenn Sie .NET 4.x verwenden:

  1. Entfernen oder deaktivieren Sie die folgenden DLLs für alle Plattformen:
    • Parse/Plugins/Unity.Compat.dll
    • Parse/Plugins/Unity.Tasks.dll
  2. Aktiviere die folgenden DLLs für alle Plattformen:
    • Parse/Plugins/dotNet45/Unity.Compat.dll
    • Parse/Plugins/dotNet45/Unity.Tasks.dll

Wenn Sie ein anderes Firebase-Plug-in importieren:

  • Rufen Sie in Ihrem Unity-Projekt Assets > Play Services Resolver > Version Handler > Update auf, um die richtigen DLLs für Ihr Projekt zu aktivieren.

IL2CPP-Kompilierung in Unity 2017.1 in .NET 4.x-Projekten

Firebase unterstützt .NET 4.x als experimentelle Buildoption in Unity 2017 und höher. Firebase-Plug-ins verwenden Komponenten des Parse SDK, um einige .NET 4.x-Klassen in früheren .NET-Versionen bereitzustellen.

Daher werden ab der Version 5.4.0 des Firebase Unity SDK DLLs zur Weiterleitung von Typen bereitgestellt, die Parse-Typen (z. B. die Parse-Implementierung von System.Threading.Tasks.Task) an das .NET Framework weiterleiten. Leider verarbeitet IL2CPP (ein Transcompiler, der C# in C++ konvertiert), der in Unity 2017.1.x enthalten ist, keine DLLs für die Typweiterleitung korrekt. Dies führt zu Buildfehlern, die in etwa so aussehen:

Fatal error in Unity CIL Linker Mono.Cecil.ResolutionException: Failed to
resolve System.Threading.Tasks.TaskCompletionSource`1<T>

Für .NET 4.x-IL2CPP-Buildfehler in Unity 2017.1 gibt es derzeit keine Problemumgehung. Sie müssen also auf Unity 2017.2 oder höher aktualisieren, um .NET 4.x in Projekten zu verwenden, die mit IL2CPP kompiliert wurden.

Netzwerk in Unity 2017.2

Firebase Realtime Database erstellt TLS-Netzwerkverbindungen mit dem .NET-Netzwerkstack. Die TLS-Funktion ist in Unity 2017.2 bei Verwendung von .NET 4.6 defekt, was dazu führt, dass das Realtime Database-Plug-in in Editoren und auf dem Computer fehlschlägt.

Es gibt keine Behelfslösung für dieses Problem. Sie müssen daher eine andere Version von Unity verwenden, z. B. Version 2017.1 oder 2017.3.

Fehlende Firebase-Android-Konfigurationsdatei in Unity 2020

Um Versionen von Unity zu unterstützen, bei denen der Gradle-Build nicht angepasst werden kann, generiert das Firebase-Editor-Tool Assets/Plugins/Android/Firebase/res/values/google-services.xml als Android-Ressource, die in einen Android-Build verpackt wird, damit das Firebase SDK die Standardinstanz von FirebaseApp damit initialisieren kann.

In Unity 2020 müssen sich alle Android-Ressourcen in Verzeichnissen mit dem Suffix .androidlib befinden. Wenn in Ihrem Projekt ein Firebase SDK verwendet wird, das ein Verzeichnis Assets/Plugins/Android/Firebase generiert, benennen Sie es in Assets/Plugins/Android/Firebase.androidlib um. Sie muss aber auf jeden Fall AndroidManifest.xml, project.properties und res/values/google-services.xml enthalten.

Problem mit Single Dex beim Erstellen einer Android-App

Beim Erstellen einer Android-App kann ein Buildfehler auftreten, der auf eine einzelne DEX-Datei zurückzuführen ist. Die Fehlermeldung sieht in etwa so aus, wenn Ihr Projekt für die Verwendung des Gradle-Build-Systems konfiguriert ist.

Cannot fit requested classes in a single dex file.

In Dalvik-Ausführbaren (.dex) werden eine Reihe von Klassendefinitionen und die zugehörigen Zusatzdaten für Android-Anwendungen (.apk) gespeichert. Eine einzelne dex-Datei kann nur auf 65.536 Methoden verweisen. Der Build schlägt fehl, wenn die Gesamtzahl der Methoden aus allen Android-Bibliotheken in Ihrem Projekt dieses Limit überschreitet.

In Unity 2017.2 wurde die Minimierung eingeführt. Dabei wird mit Proguard (oder anderen Tools in einigen Versionen von Unity) nicht verwendeter Code entfernt, wodurch sich die Gesamtzahl der referenzierten Methoden in einer einzelnen dex-Datei reduzieren lässt. Sie finden die Option unter Player-Einstellungen > Android > Einstellungen für die Veröffentlichung > Minimieren. Die Optionen können sich in verschiedenen Unity-Versionen unterscheiden. Weitere Informationen finden Sie in der offiziellen Unity-Dokumentation.

Wenn die Anzahl der referenzierten Methoden das Limit weiterhin überschreitet, können Sie auch multidex aktivieren. In Unity gibt es dafür mehrere Möglichkeiten:

  • Wenn Custom Gradle Template unter Player Settings aktiviert ist, ändern Sie mainTemplate.gradle.
  • Wenn Sie das exportierte Projekt mit Android Studio erstellen, ändern Sie die build.gradle-Datei auf Modulebene.

Weitere Informationen finden Sie im Multidex-Nutzerhandbuch.

Java 8-Unterstützung und Desugaring für Android-Builds in Unity 2017 und Unity 2018 (Firebase Unity SDK 8.0.0 und höher)

Im Mai 2021 (Firebase BoM v28.0.0) hat Firebase die Desugaring-Funktion für alle Android-Bibliotheken deaktiviert (siehe Release-Note). Beim Erstellen einer Android-App mit dem Firebase Unity SDK (8.0.0 und höher) kann der folgende Buildfehler auftreten:

> Error while dexing.
 The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle

Diese Änderung betrifft nur Android-Builds in Unity 2017 und Unity 2018. In neueren Versionen von Unity wird der Block compileOptions standardmäßig in Gradle-Builddateien hinzugefügt. So beheben Sie diesen Buildfehler in Unity 2017 und Unity 2018:

  • Fügen Sie Ihrer Gradle-Vorlage einen compileOptions-Block hinzu:

    1. Verwenden Sie Gradle als Build-System.
    2. Aktivieren Sie unter Player Settings die Option Custom Gradle Template.

    3. Fügen Sie mainTemplate.gradle (oder build.gradle auf Modulebene, wenn Sie ein Projekt für Android Studio exportieren) die folgenden Zeilen hinzu:

      android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

  • Alternativ können Sie die minSdkVersion für Ihr Android-Projekt auf 26 oder höher erhöhen.

Weitere Informationen finden Sie unter Fehlerbehebung bei Android – Desugaring-Build-Fehler.

Probleme beim Erstellen für iOS mit Cocoapods

Wenn Sie für iOS erstellen, schlägt die Cocoapod-Installation möglicherweise mit einem Fehler bezüglich der Sprachlokalisierung oder der UTF-8-Codierung fehl. Es gibt derzeit mehrere Möglichkeiten, das Problem zu umgehen.

  • Führen Sie pod install direkt im Terminal aus und öffnen Sie die resultierende xcworkspace-Datei.

  • Führen Sie ein Downgrade der Cocoapods-Version auf 1.10.2 aus. Das Problem tritt nur in Version 1.11 und höher auf.

  • Fügen Sie export LANG=en_US.UTF-8 zu Ihrem ~/.bash_profile oder einem ähnlichen Tool hinzu.

Version des Firebase Unity SDKs aktualisieren

Wie Sie die Versionen der Firebase Unity SDKs aktualisieren, hängt davon ab, wie sie ursprünglich importiert wurden. Hier sind die beiden alternativen Importmethoden:

  • .unitypackage-Dateien in das Assets/-Verzeichnis Ihres Projekts importieren
  • Importieren mit dem Unity Package Manager (UPM)
    • Dies ist die empfohlene Methode zum Verwalten von Paketen in Unity 2018.4 und höher.
    • Mit dieser Methode lassen sich zukünftige Versionsupdates einfacher durchführen und Ihr Assets/-Verzeichnis wird aufgeräumt.

In Ihrem Unity-Projekt sollten Sie nur eine Importmethode verwenden, um alle Firebase-Pakete zu verwalten. Mit der folgenden Anleitung können Sie nicht nur die Version einzelner Pakete aktualisieren, sondern bei Bedarf auch die Paketverwaltung zu UPM migrieren (die empfohlene Importmethode).