Erhalten Sie lesbare Absturzberichte im Crashlytics-Dashboard

iOS+ Android Flutter Unity

Wir empfehlen die Verwendung der neuesten Version des Crashlytics Unity SDK (v11.8.0). Laden Sie die neueste Version herunter.

iOS+ (Apple-Plattformen)

Für Apple-Plattform-Apps, die das Crashlytics Unity SDK 8.2.0+ verwenden, konfiguriert das Firebase Unity Editor-Plugin Ihr Xcode-Projekt automatisch zum Hochladen von Symbolen. Laden Sie die neueste Version herunter.

Android

Für Android-Apps umfasst das Crashlytics Unity SDK 8.6.1+ automatisch die NDK-Absturzberichterstattung, die es Crashlytics ermöglicht, Unity IL2CPP- Abstürze auf Android automatisch zu melden. Um jedoch symbolische Stack-Traces für Abstürze nativer Bibliotheken im Crashlytics-Dashboard anzuzeigen, müssen Sie zum Zeitpunkt der Erstellung mithilfe der Firebase-CLI Symbolinformationen hochladen.

1. Stellen Sie sicher, dass Sie das Crashlytics Unity SDK v8.6.1 oder höher verwenden. Laden Sie die neueste Version herunter.

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

   1. Befolgen Sie die Anweisungen, um die Firebase-CLI zu installieren .

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

   2. (nur für Apps mit Android-API-Level 30+) Aktualisieren Sie AndroidManifest.xml Vorlage Ihrer App, um das Pointer-Tagging zu deaktivieren:

      1. Aktivieren Sie das Kontrollkästchen für Android Player-Einstellungen > Veröffentlichungseinstellungen > Erstellen > Benutzerdefiniertes Hauptmanifest .

      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 symbolisierte Stack-Traces in der Firebase-Konsole sehen möchten.

   1. Führen Sie im Dialogfeld „Build-Einstellungen“ einen der folgenden Schritte aus:

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

      • Erstellen Sie Ihr APK direkt aus dem Unity-Editor.
        Stellen Sie vor dem Erstellen sicher, dass das Kontrollkästchen für „Symbole erstellen.zip“ im Dialogfeld „Erstellungseinstellungen“ aktiviert ist.

   2. Sobald Ihr Build abgeschlossen ist, generieren Sie eine Crashlytics-kompatible Symboldatei und laden Sie sie auf Firebase-Server hoch, indem Sie den folgenden Firebase-CLI-Befehl ausführen:

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

      • FIREBASE_APP_ID : Ihre Firebase-Android-App-ID (nicht Ihr Paketname)
        Beispiel-ID einer Firebase-Android-App: 1:567383003300:android:17104a2ced0c9b9b

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

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

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

        • Gehen Sie in der Firebase-Konsole zu Ihren Projekteinstellungen . Scrollen Sie nach unten zur Karte „Ihre Apps“ und klicken Sie dann auf die gewünschte Firebase-App, um deren App-ID zu finden.

      • PATH/TO/SYMBOLS : Der Pfad zur von der CLI generierten Symboldatei

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

        • Erstellen Sie das APK direkt aus Unity heraus – PATH/TO/SYMBOLS ist der Pfad der komprimierten Symboldatei, die nach Abschluss Ihres Builds im Projektstammverzeichnis generiert wurde (zum Beispiel: myproject/myapp-1.0-v100.symbols.zip ).

      Sehen Sie sich erweiterte Optionen für die Verwendung des Firebase-CLI-Befehls zum Generieren und Hochladen von Symboldateien an

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