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.
Stellen Sie sicher, dass Sie das Crashlytics Unity SDK v8.6.1 oder höher verwenden. Laden Sie die neueste Version herunter.
Richten Sie Ihre Umgebung und Ihr Projekt für das Hochladen von Symbolen ein:
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 .
(nur für Apps mit Android-API-Level 30+) Aktualisieren Sie
AndroidManifest.xml
Vorlage Ihrer App, um das Pointer-Tagging zu deaktivieren:Aktivieren Sie das Kontrollkästchen für Android Player-Einstellungen > Veröffentlichungseinstellungen > Erstellen > Benutzerdefiniertes Hauptmanifest .
Öffnen Sie die Manifestvorlage unter
Assets/Plugins/Android/AndroidManifest.xml
.(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" ... />
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.
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.
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
Hier sind zwei Möglichkeiten, Ihre Firebase-App-ID zu finden:
In Ihrer Datei
google-services.json
ist Ihre App-ID der Wertmobilesdk_app_id
. oderGehen 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