Ta strona została przetłumaczona przez Cloud Translation API.

Otrzymuj czytelne raporty o awariach w panelu Crashlytics

Domyślnie Firebase Crashlytics automatycznie przetwarza pliki symboli debugowania (dSYM), aby uzyskać przejrzyste i czytelne dla człowieka raporty o awariach. To zachowanie jest ustawiane po dodaniu skryptu uruchamiania, który inicjuje Crashlytics do fazy kompilacji aplikacji.

Niestety istnieje kilka przypadków, które mogą spowodować niepowodzenie przesyłania pliku dSYM, na przykład kod bitowy w aplikacji lub inne unikalne konfiguracje projektu. W tym przewodniku znajdziesz kilka sposobów rozwiązywania problemów, gdy Crashlytics nie może zlokalizować pliku dSYM Twojej aplikacji.

Sprawdź, czy Xcode produkuje pliki dSYM

Najczęściej pliki dSYM znikają, ponieważ Xcode po prostu ich nie produkuje. Gdy przesyłanie nie powiedzie się, Crashlytics wyświetla alert „Brak pliku dSYM” w konsoli Firebase. Jeśli otrzymasz ten alert, najpierw sprawdź, czy Xcode tworzy poprawny plik dSYM dla każdej kompilacji:

Otwórz swój projekt w Xcode i wybierz plik projektu w Xcode Navigator.
Wybierz główny cel kompilacji.
Otwórz kartę Ustawienia budowania celu, a następnie kliknij opcję Wszystkie .
Wyszukaj „format informacji o debugowaniu”.
Ustaw format informacji debugowania na DWARF z plikiem dSYM dla wszystkich typów kompilacji.
Przebuduj swoją aplikację.

Twoje raporty o awariach powinny teraz pojawiać się w konsoli Firebase. Jeśli problem będzie się powtarzał lub napotkasz inne błędy, spróbuj zlokalizować dSYM i ręcznie przesłać go do Crashlytics.

Znajdź swoje pliki dSYM

Czasami Crashlytics nie może zlokalizować pliku dSYM Twojej aplikacji ze względu na konfigurację kodów bitowych lub łączność konsoli. W takim przypadku istnieją dwa dodatkowe sposoby rozwiązywania problemów:

Pobierz bitcode dSYMs z App Store

Firma Apple generuje nowe pliki dSYM dla kompilacji obsługujących kody bitowe, które zostały udostępnione w sklepie App Store lub przesłane do TestFlight. Jeśli którakolwiek z poniższych sytuacji dotyczy Twojej aplikacji, pobierz dla niej nowy plik dSYM ze sklepu App Store:

Zaloguj się do App Store Connect, a następnie kliknij Moje aplikacje > Aktywność .
Wybierz kompilację, dla której chcesz pobrać plik dSYM.
Kliknij Szczegóły kompilacji > Pobierz dSYM .

Znajdź pliki dSYM na komputerze lokalnym

Uruchom następujące polecenie, aby wyświetlić identyfikatory UUID wszystkich dSYM na swoim komputerze, a następnie wyszukaj brakujący dSYM:

mdfind -name .dSYM | while read -r line; do dwarfdump -u "$line"; done

Po znalezieniu pliku dSYM prześlij go do Crashlytics. Jeśli polecenie mdfind nie zwróci żadnych wyników, możesz zajrzeć do katalogu Products , w którym znajduje się Twoja aplikacja .app (domyślnie katalog Products znajduje się w Derived Data ). Jeśli Twoja aplikacja została wydana do produkcji, możesz również poszukać jej dSYM w katalogu .xcarchive na dysku:

W Xcode otwórz okno Organizatora i wybierz aplikację z listy. Xcode wyświetla listę archiwów twojego projektu.
Kliknij z klawiszem Control w archiwum, aby wyświetlić je w Finderze. Następnie ponownie kliknij z wciśniętym klawiszem Control i kliknij Pokaż zawartość pakietu .

W .xcarchive znajduje się katalog dSYMs, który zawiera pliki dSYM wygenerowane w ramach procesu archiwizacji Xcode. Ponownie skompilowane pliki dSYM z kodem bitowym są również pobierane do tego folderu podczas korzystania z narzędzia Pobierz pliki dSYM... w oknie Organizatora.

Prześlij swoje pliki dSYM

Aby ręcznie przesłać pliki dSYM, możesz użyć dostępnej w konsoli opcji „przeciągnij i upuść”, aby przesłać archiwum ZIP zawierające pliki dSYM (przejdź do konsoli Firebase > Crashlytics > karta dSYM ).

Alternatywnie, jako kopia zapasowa, Crashlytics zawiera skrypt upload-symbols , który można wywołać z dowolnego miejsca w procesie kompilacji, aby ręcznie przesłać pliki dSYM. Skrypt dostarcza więcej informacji o procesie wysyłania i bardziej wyczerpujące komunikaty o błędach (aby uzyskać uwagi dotyczące użytkowania i dodatkowe instrukcje, uruchom upload-symbols bez żadnych parametrów).

Podczas przesyłania plików dSYM z kodem bitowym pomocne może być usunięcie wszystkich plików ikon z archiwum zip, uruchamiając:

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

Aby uruchomić skrypt upload-symbols , użyj jednej z następujących opcji:

Uwzględnij następujący wiersz w procesie kompilacji:

find dSYM_DIRECTORY -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \{\}

Uruchom skrypt bezpośrednio z terminala:

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