Raport o błędzie zawiera dzienniki urządzenia, zrzuty stosu i inne informacje diagnostyczne, które pomogą Ci znaleźć i naprawić błędy w aplikacji. Aby utworzyć raport o błędzie z urządzenia, użyj opcji dla programistów Zgłoś błąd na urządzeniu, menu Emulatora Androida lub polecenia adb bugreport
na komputerze do programowania.
![](https://developer.android.com/static/studio/images/run/dev-options-pixel_2x_cropped.png?authuser=7&hl=pl)
Rysunek 1. Opcje programisty na urządzeniu.
Aby utworzyć raport o błędzie, na urządzeniu musisz mieć włączone Opcje programisty, aby uzyskać dostęp do opcji Zgłoś błąd.
Zapisuj raport o błędzie z urządzenia
![](https://developer.android.com/static/studio/images/run/dev-options-take-bug-report_2x.png?authuser=7&hl=pl)
Rysunek 2. Raport o błędzie jest gotowy.
Aby pobrać raport o błędzie bezpośrednio z urządzenia:
- Włącz Opcje programisty.
- W Opcjach programisty kliknij Zgłoś błąd.
- Wybierz typ raportu o błędzie i kliknij Zgłoś.
Po chwili otrzymasz powiadomienie, że raport o błędzie jest gotowy (jak pokazano na rysunku 2).
- Aby udostępnić raport o błędzie, kliknij powiadomienie.
Zapisywanie raportu o błędzie z emulatora Androida
W emulatorze Androida możesz użyć funkcji Zgłoś błąd w rozszerzonych ustawieniach:
- W panelu emulatora kliknij Więcej
.
W oknie Rozszerzone elementy sterujące wybierz Raport o błędzie.
Otworzy się ekran, na którym możesz zobaczyć szczegóły raportu o błędzie, np. zrzut ekranu, informacje o konfiguracji AVD oraz dziennik raportu o błędzie. Możesz też wpisać wiadomość z instrukcjami odtwarzania, aby zapisać ją w raporcie.
Poczekaj, aż zakończy się zbieranie raportu o błędzie, a potem kliknij Zapisz raport.
Zapisywanie raportu o błędzie za pomocą narzędzia adb
Jeśli masz połączone tylko 1 urządzenie, możesz pobrać raport o błędzie, korzystając z usługi adb
:
$ adb bugreport E:\Reports\MyBugReports
Jeśli nie określisz ścieżki raportu o błędzie, zostanie on zapisany w katalogu lokalnym.
Jeśli masz podłączonych kilka urządzeń, musisz określić urządzenie za pomocą opcji -s
. Uruchom te polecenia adb
, aby uzyskać numer seryjny urządzenia i wygenerować raport o błędzie:
$ adb devices List of devices attached emulator-5554 device 8XV7N15C31003476 device $ adb -s 8XV7N15C31003476 bugreport
Zapisz starszy raport o błędzie
Domyślnie raporty o błędach są zapisywane na /bugreports
i można je wyświetlić za pomocą tego polecenia:
$ adb shell ls /bugreports/ bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS-dumpstate_log-yyy.txt bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS.zip dumpstate-stats.txt
Następnie możesz pobrać plik zip przez adb pull
:
$ adb pull /bugreports/bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS.zip
Sprawdź plik ZIP z raportem o błędzie
Domyślnie ten plik nosi nazwę bugreport-BUILD_ID-DATE.zip
. Plik ZIP może zawierać wiele plików. Najważniejszym z nich jest bugreport-BUILD_ID-DATE.txt
. Oto raport o błędzie, który zawiera dane wyjściowe diagnostyczne dotyczące usług systemowych (dumpsys
), dzienników błędów (dumpstate
) i dzienników komunikatów systemowych (logcat
). Komunikaty systemowe obejmują zrzuty stosu, gdy urządzenie zgłasza błąd, oraz komunikaty zapisane ze wszystkich aplikacji z klasą Log
.
Plik ZIP zawiera plik metadanych version.txt
z literą dotyczącą wersji Androida. Gdy protokół systrace jest włączony, plik ZIP zawiera też plik systrace.txt
. Narzędzie Systrace pomaga analizować wydajność aplikacji, rejestrując i wyświetlając czasy wykonywania procesów aplikacji i innych procesów systemu Android.
Narzędzie dumpstate
kopiuje pliki z systemu plików na urządzeniu do pliku ZIP w folderze FS
, aby można było się do nich odwołać. Na przykład plik /dirA/dirB/fileC
na urządzeniu wygenerowałby w pliku ZIP wpis FS/dirA/dirB/fileC
.
Rysunek 3. Struktura pliku z raportem o błędzie.
Więcej informacji znajdziesz w sekcji Odczytywanie raportów o błędach.
Otrzymuj raporty od użytkowników
Generowanie raportów o błędach jest przydatne, gdy samodzielnie korzystasz z aplikacji, ale użytkownicy nie mogą łatwo udostępniać Ci takich raportów. Aby otrzymywać raporty o awariach ze zrzutami stosu rzeczywistych użytkowników, skorzystaj z funkcji zgłaszania awarii w Google Play i Firebase.
Konsola Google Play
W Konsoli Google Play możesz otrzymywać raporty o awariach i błędach typu Aplikacja nie odpowiada (ANR) wywołanych przez użytkowników, którzy zainstalowali Twoją aplikację z Google Play. Dostępne dane pochodzą z ostatnich 6 miesięcy.
Więcej informacji znajdziesz w sekcji dotyczącej wyświetlania awarii i błędów ANR w Centrum pomocy Konsoli Play.
Zgłaszanie awarii Firebase
Funkcja raportowania Firebase Crashlytics tworzy szczegółowe raporty o błędach w aplikacji. Błędy są pogrupowane w problemy na podstawie podobnych zrzutów stosu i klasyfikowane według wagi wpływu na użytkowników. Oprócz raportów automatycznych możesz rejestrować zdarzenia niestandardowe, które pomagają rejestrować kroki prowadzące do awarii.
Aby zacząć otrzymywać raporty o awariach od dowolnego użytkownika, dodaj zależności Firebase do pliku build.gradle
. Więcej informacji znajdziesz w sekcji Firebase Crashlytics.