Lesbare Absturzberichte im Crashlytics-Dashboard abrufen (Unity)

Plattform auswählen:

iOS+ Android Flutter Unity

iOS+ (Apple-Plattformen)

Bei Apple-Plattform-Apps, die das Crashlytics Unity SDK 8.2.0 oder höher verwenden, wird Ihr Xcode-Projekt vom Firebase Unity Editor-Plug-in automatisch so konfiguriert, dass Symbole hochgeladen werden. Laden Sie die aktuelle Version herunter.

Android

Bei Android-Apps enthält das Crashlytics Unity SDK 8.6.1 oder höher automatisch NDK-Absturzberichte, sodass Crashlytics Unity-IL2CPP-Abstürze unter Android automatisch melden kann. Wenn Sie jedoch symbolisierte Stacktraces für Abstürze nativer Bibliotheken im Crashlytics-Dashboard sehen möchten, müssen Sie während des Builds Symbolinformationen mit der Firebase-Befehlszeile hochladen.

1. Sie benötigen das Crashlytics Unity SDK in der Version 8.6.1 oder höher. Laden Sie die aktuelle Version herunter.

2. Richten Sie Ihre Umgebung und Ihr Projekt für das Hochladen von Symbolen ein:

   1. Folgen Sie der Anleitung unter Firebase-CLI installieren.

      Wenn Sie die Befehlszeile bereits installiert haben, aktualisieren Sie sie auf die aktuelle Version.

   2. (Nur für Apps, die Android API-Level 30 oder höher verwenden) Aktualisieren Sie die Vorlage AndroidManifest.xml Ihrer App, um Pointer Tagging zu deaktivieren:

      1. Klicken Sie das Kästchen für Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Android-Player-Einstellungen > Veröffentlichungseinstellungen > Build > Benutzerdefiniertes Hauptmanifest) an.

      2. Öffnen Sie die Manifestvorlage unter Assets/Plugins/Android/AndroidManifest.xml.

      3. (Nur für Apps, die eine SDK-Version vor 8.8.0 verwenden) Fügen Sie dem Anwendungstag das folgende Attribut hinzu: <application android:allowNativeHeapPointerTagging="false" ... />

3. Erstellen Sie Ihr Projekt und laden Sie Symbole hoch.

   Führen Sie diese Schritte jedes Mal aus, wenn Sie einen Release-Build oder einen anderen Build erstellen, für den Sie symbolisierte Stacktraces im Dashboard Crashlytics sehen möchten.

   1. 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 Settings (Build-Einstellungen) das Kästchen Create symbols.zip (symbols.zip erstellen) angeklickt ist.

   2. Nachdem der Build abgeschlossen ist, generieren Sie eine Crashlytics-kompatible Symboldatei und laden Sie sie auf die Firebase-Server hoch. Führen Sie dazu den folgenden Firebase-CLI-Befehl aus:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: Ihre Firebase-Android-App-ID (nicht der Paketname)
        Beispiel für eine Firebase-Android-App-ID: 1:567383003300:android:17104a2ced0c9b9b

        Sie möchten Ihre Firebase-App-ID finden?

        Es gibt zwei Möglichkeiten, Ihre Firebase-App-ID zu finden:

        • In der Datei google-services.json ist die App-ID der Wert mobilesdk_app_id.

        • Rufen Sie in der Firebase Console die Seite settings Einstellungen > Allgemein auf. Scrollen Sie zur Karte Meine Apps und klicken Sie auf die gewünschte Firebase-App, um die App-ID zu finden.

      • PATH/TO/SYMBOLS: Der 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 gezippten Symboldatei, die nach Abschluss des Builds im Stammverzeichnis des Projekts generiert wurde (z. B. myproject/myapp-1.0-v100.symbols.zip).

      Erweiterte Optionen für die Verwendung des Firebase-CLI-Befehls zum Generieren und Hochladen von Symboldateien ansehen

      Flag	Beschreibung
      --generator=csym	Verwendet den alten cSYM-Symboldateigenerator anstelle des standardmäßigen Breakpad-Generators Nicht empfohlen. Wir empfehlen, den standardmäßigen Breakpad-Symboldateigenerator zu verwenden.
      --generator=breakpad	Verwendet den Breakpad-Symboldateigenerator Die Standardeinstellung für die Generierung von Symboldateien ist Breakpad. Verwenden Sie dieses Flag nur, wenn Sie symbolGenerator { csym() } in Ihrer Build-Konfiguration hinzugefügt haben und es überschreiben möchten, um stattdessen Breakpad zu verwenden.
      --dry-run	Generiert die Symboldateien, lädt sie aber nicht hoch Dieses Flag ist nützlich, wenn Sie den Inhalt der gesendeten Dateien prüfen möchten.
      --debug	Stellt zusätzliche Debugging-Informationen bereit