Lesbare Absturzberichte im Crashlytics-Dashboard abrufen (Unity)

Plattform auswählen : iOS+ Android Flutter Unity


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 so, dass Symbole hochgeladen werden. Neueste 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. Achten Sie darauf, dass Sie das Crashlytics Unity SDK Version 8.6.1 oder höher verwenden. Neueste Version herunterladen

  2. Richten Sie Ihre Umgebung und Ihr Projekt für den Symbolupload 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 .

    2. (Nur für Apps mit Android API-Level 30 oder höher) Aktualisieren Sie die Vorlage AndroidManifest.xml Ihrer App, um die Pointer-Kennzeichnung 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

      • PATH/TO/SYMBOLS: Der Pfad zur Symboldatei, die von der CLI generiert wurde

        • In ein Android Studio-Projekt exportiert: 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

      Nicht zur Verwendung empfohlen. Wir empfehlen, den Standard Breakpad-Symboldateien-Generator zu verwenden.

      --generator=breakpad

      Verwendet den Generator für Breakpad-Symboldateien

      Standardmäßig wird Breakpad zum Generieren von Symboldateien verwendet. 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 Stellt zusätzliche Debugging-Informationen bereit