Lesbare Absturzberichte im Crashlytics-Dashboard abrufen (Unity)

Plattform auswählen :

iOS+ Android Flutter Unity

Wir empfehlen die Verwendung der neuesten Version des Crashlytics Unity SDK (Version 13.10.0). Aktuelle Version herunterladen

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 das Hochladen von Symbolen. Aktuelle Version herunterladen

Android

Bei Android-Apps enthält das Crashlytics Unity SDK 8.6.1 oder höher automatisch die NDK-Absturzberichterstattung, sodass Crashlytics Unity IL2CPP Abstürze unter Android automatisch melden kann. Wenn Sie jedoch symbolisierte Stacktraces für Abstürze in nativen Bibliotheken im Crashlytics Dashboard sehen möchten, müssen Sie zur Build-Zeit Symbolinformationen mit der Firebase CLI hochladen.

1. Verwenden Sie das Crashlytics Unity SDK Version 8.6.1 oder höher. Aktuelle Version herunterladen

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

   1. Folgen Sie der Anleitung, um die CLI zu Firebaseinstallieren.

      Wenn Sie die CLI bereits installiert haben, stellen Sie sicher, dass Sie sie auf die neueste Version aktualisieren .

      Hinweis: Sie können Firebase CLI-Befehle auch in Cloud Shell ausführen. Cloud Shell ist eine browserbasierte, vorab authentifizierte Befehlszeilenumgebung, auf die Sie über die Firebase Console zugreifen können. Die Firebase CLI ist vorinstalliert. Das ist eine praktische Option für den schnellen Einstieg , vorausgesetzt, Sie fügen Ihre Projektdateien der Cloud Shell Umgebung hinzu.

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

      1. Aktivieren Sie das Kästchen für Android Player Settings > Publishing Settings > Build > Custom Main Manifest.

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

      3. (Nur für Apps mit einer SDK-Version vor 8.8.0) 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 in der Firebase Console sehen möchten.

   1. Führen Sie im Dialogfeld Build Settings einen der folgenden Schritte aus:

      • Exportieren Sie das Projekt in ein Android Studio-Projekt, um es zu erstellen.

      • Erstellen Sie die APK-Datei direkt im Unity Editor.
        Achten Sie vor dem Erstellen darauf, dass im Dialogfeld Build Settings das Kästchen Create symbols.zip aktiviert ist.

   2. Nachdem der Build abgeschlossen ist, generieren Sie eine Crashlytics-kompatible Symbol datei 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 Ihr Paketname)
        Beispiel für eine Firebase Android-App-ID: 1:567383003300:android:17104a2ced0c9b9b

        Sie müssen Ihre Firebase-App-ID finden?

        Hier sind zwei Möglichkeiten, Ihre Firebase-App-ID zu finden:

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

        • Rufen Sie in der Firebase Console die Projekteinstellungen auf. Gehen 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 CLI generiert wurde

        • Exportiert in ein Android Studio-Projekt: PATH/TO/SYMBOLS ist das unityLibrary/symbols Verzeichnis, das im Stammverzeichnis des exportierten Projekts erstellt wird, nachdem Sie die App über Gradle oder Android Studio erstellt haben.

        • APK-Datei direkt in Unity erstellt: PATH/TO/SYMBOLS ist der Pfad der komprimierten 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 Legacy-Generator für cSYM-Symboldateien anstelle des Standardgenerators Breakpad Die Verwendung wird nicht empfohlen. Wir empfehlen, den Standard Breakpad-Symboldateien-Generator zu verwenden.
      --generator=breakpad	Verwendet den Generator für Breakpad-Symboldateien 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 Dateien prüfen möchten.
      --debug	Liefert zusätzliche Informationen zur Fehlerbehebung