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 das Hochladen von Symbolen 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

        So finden Sie Ihre Firebase App-ID:

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

        • Rufen Sie in der Firebase Console die Projekteinstellungen auf. Scrollen Sie nach unten zur Karte Meine Apps und klicken Sie auf die gewünschte Firebase-App, um die App-ID zu sehen.

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

        • Das APK wurde 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).

      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