Erhalten Sie lesbare Absturzberichte im Crashlytics-Dashboard

Standardmäßig verarbeitet Firebase Crashlytics automatisch Ihre Debug-Symboldateien (dSYM), um Ihnen entschleierte und für Menschen lesbare Absturzberichte zu liefern. Dieses Verhalten wird festgelegt, wenn Sie ein Ausführungsskript hinzufügen, das Crashlytics in der Erstellungsphase Ihrer App initialisiert.

Leider gibt es einige Fälle, die dazu führen können, dass Ihr dSYM-Upload fehlschlägt, wie z. B. Bitcode in Ihrer App oder andere einzigartige Projektkonfigurationen. Dieser Leitfaden bietet einige Möglichkeiten zur Fehlerbehebung, wenn Crashlytics das dSYM Ihrer App nicht finden kann.

Überprüfen Sie, ob Xcode dSYMs produziert

Meistens gehen dSYM-Dateien verloren, weil Xcode sie einfach nicht produziert. Wenn ein Upload fehlschlägt, zeigt Crashlytics eine „Fehlende dSYM“-Warnung in der Firebase-Konsole an. Wenn Sie diese Warnung erhalten, überprüfen Sie zunächst, ob Xcode das richtige dSYM für jeden Build erstellt:

  1. Öffnen Sie Ihr Projekt in Xcode und wählen Sie die Projektdatei im Xcode-Navigator aus.

  2. Wählen Sie Ihr Haupt-Build-Ziel aus.

  3. Öffnen Sie die Registerkarte Build-Einstellungen des Ziels und klicken Sie dann auf Alle .

  4. Suchen Sie nach „Debug-Informationsformat“.

  5. Stellen Sie das Debug-Informationsformat für alle Ihre Build-Typen auf DWARF mit dSYM-Datei ein.

  6. Erstellen Sie Ihre App neu.

Ihre Absturzberichte sollten jetzt in der Firebase-Konsole angezeigt werden. Wenn das Problem weiterhin besteht oder andere Fehler auftreten, versuchen Sie, Ihr dSYM zu finden und es manuell auf Crashlytics hochzuladen.

Suchen Sie Ihre dSYMs

Manchmal kann Crashlytics das dSYM Ihrer App aufgrund von Bitcode-Konfigurationen oder der Konnektivität der Konsole nicht finden. In diesem Fall gibt es zwei weitere Möglichkeiten zur Fehlerbehebung:

Laden Sie Ihre dSYMs hoch

Um Ihre dSYMs manuell hochzuladen, können Sie die konsolenbasierte „Drag and Drop“-Option verwenden, um ein ZIP-Archiv hochzuladen, das Ihre dSYM-Dateien enthält (gehen Sie zur Firebase-Konsole > Crashlytics > Registerkarte dSYMs ).

Als Backup enthält Crashlytics alternativ ein upload-symbols Symbols-Skript, das Sie von überall in Ihrem Build-Prozess aufrufen können, um Ihre dSYM-Dateien manuell hochzuladen. Das Skript bietet weitere Informationen zum Upload-Vorgang und umfassendere Fehlermeldungen (für Nutzungshinweise und zusätzliche Anweisungen führen upload-symbols ohne Parameter aus).

Beim Hochladen von Bitcode-dSYMs kann es hilfreich sein, alle Icon-Dateien im Zip-Archiv zu entfernen, indem Sie Folgendes ausführen:

unzip appDsyms.zip
cd appDsyms rm -rf $(find . | grep Icon)
# Enumerate all the dSYMs
upload-symbols ... $(ls)

Um das Skript upload-symbols auszuführen, verwenden Sie eine der folgenden Optionen:

  • Fügen Sie die folgende Zeile in Ihren Build-Prozess ein:

    find dSYM_DIRECTORY -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \{\}
  • Führen Sie das Skript direkt von Ihrem Terminal aus:

    /PATH/TO/PODS/DIRECTORY/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p ios /PATH/TO/dSYMs