Im Crashlytics-Dashboard sind lesbare Absturzberichte verfügbar.


iOS + (Apple-Plattformen)

Bei Apps für Apple-Plattformen, 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.

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

  2. Richten Sie Ihre Umgebung und Ihr Projekt für den Symbolupload ein:

    1. Folgen Sie der Anleitung zum Installieren der Firebase CLI.

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

    2. (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:

      1. Klicke das Kästchen bei Android-Player-Einstellungen > Einstellungen für die Veröffentlichung > 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 Anwendungs-Tag 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 Build erstellen, für den Sie symbolische Stack-Traces in der Firebase-Konsole 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-Einstellungen das Kästchen für symbols.zip erstellen angeklickt ist.

    2. Nachdem der Build abgeschlossen ist, generieren Sie eine Crashlytics-kompatible Symboldatei und laden Sie sie mit dem folgenden Firebase-Befehl auf 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 symbolGenerator { csym() } in Ihre Build-Konfiguration eingefügt haben und es überschreiben möchten, um stattdessen Breakpad zu verwenden.

      --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