iOS + (Apple-Plattformen)
Bei Apple-Plattform-Apps, die das Crashlytics Unity SDK 8.2.0 oder höher verwenden, konfiguriert das Firebase Unity Editor-Plug-in Ihr Xcode-Projekt automatisch für den Upload von Symbolen. Laden Sie die neueste Version herunter.
Android
Für Android-Apps enthält das Crashlytics Unity SDK 8.6.1 und höher automatisch NDK-Absturzberichte. So kann Crashlytics automatisch Unity-IL2CPP-Abstürze auf Android-Geräten melden. Wenn Sie jedoch symbolische Stapelabzüge für Abstürze von nativen Bibliotheken im Crashlytics-Dashboard sehen möchten, müssen Sie Symbolinformationen zum Zeitpunkt des Builds mit der Firebase-Befehlszeile hochladen.
Sie benötigen das Crashlytics Unity SDK 8.6.1 oder höher. Laden Sie die neueste Version herunter.
Richten Sie Ihre Umgebung und Ihr Projekt für den Symbolupload ein:
Folgen Sie der Anleitung zum Installieren der Firebase CLI.
Wenn Sie die Befehlszeile bereits installiert haben, aktualisieren Sie sie auf die neueste Version.
(nur für Apps mit Android API-Level 30 und höher) Aktualisieren Sie die
AndroidManifest.xml
-Vorlage Ihrer App, um das Zeiger-Tagging zu deaktivieren:Klicke das Kästchen bei Android-Player-Einstellungen > Einstellungen für die Veröffentlichung > Build > Benutzerdefiniertes Hauptmanifest an.
Öffnen Sie die Manifestvorlage unter
Assets/Plugins/Android/AndroidManifest.xml
.(nur für Apps, die eine SDK-Version vor 8.8.0 verwenden) Fügen Sie dem Anwendungs-Tag das folgende Attribut hinzu:
<application android:allowNativeHeapPointerTagging="false" ... />
Erstellen Sie Ihr Projekt und laden Sie Symbole hoch.
Führen Sie diese Schritte jedes Mal aus, wenn Sie einen Release-Build oder einen Build erstellen, für den Sie symbolische Stack-Traces in der Firebase-Konsole sehen möchten.
Führen Sie im Dialogfeld Build-Einstellungen einen der folgenden Schritte aus:
Exportieren Sie das Projekt in ein Android Studio-Projekt, um es zu erstellen.
Erstellen Sie Ihr APK direkt im Unity-Editor.
Achten Sie vor dem Erstellen darauf, dass im Dialogfeld Build-Einstellungen das Kästchen für symbols.zip erstellen angeklickt ist.
Nachdem der Build abgeschlossen ist, generieren Sie eine Crashlytics-kompatible Symboldatei und laden Sie sie mit dem folgenden Firebase-Befehl in die Firebase-Server hoch:
firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS
FIREBASE_APP_ID: Ihre Firebase-Android-App-ID (nicht Ihr Paketname)
Beispiel für eine Firebase-Android-App-ID:1:567383003300:android:17104a2ced0c9b9b
PATH/TO/SYMBOLS: Pfad zur Symboldatei, die von der Befehlszeile generiert wurde
In ein Android Studio-Projekt exportiert: PATH/TO/SYMBOLS ist das Verzeichnis
unityLibrary/symbols
, das im Stammverzeichnis des exportierten Projekts erstellt wird, nachdem Sie die App über Gradle oder Android Studio erstellt haben.Sie haben das APK direkt in Unity erstellt. PATH/TO/SYMBOLS ist der Pfad der komprimierten Symboldatei, die im Stammverzeichnis des Projekts generiert wurde, als der Build abgeschlossen wurde (z. B.
).myproject/myapp-1.0-v100.symbols.zip
Erweiterte Optionen für die Verwendung des Firebase-Befehls zur Generierung und zum Hochladen von Symboldateien aufrufen
Flag Beschreibung --generator=csym
Der alte cSYM-Symboldateigenerator wird anstelle des standardmäßigen Breakpad-Generators verwendet.
Nicht empfohlen. Wir empfehlen, den Standardgenerator für Breakpad-Symboldateien zu verwenden.
--generator=breakpad
Verwendet den Breakpad-Symboldateigenerator
Standardmäßig wird Breakpad für die Symboldateigenerierung verwendet. Verwenden Sie dieses Flag nur, wenn Sie
in Ihre Build-Konfiguration eingefügt haben und es überschreiben möchten, um stattdessen Breakpad zu verwenden.symbolGenerator { csym() }
--dry-run
Die Symboldateien werden generiert, aber nicht hochgeladen.
Dieses Flag ist nützlich, wenn Sie den Inhalt der gesendeten Dateien prüfen möchten.
--debug
Bietet zusätzliche Informationen zur Fehlerbehebung