Dane o awariach aplikacji z Firebase Crashlytics i Android Vitals możesz wyświetlać i wykorzystywać bezpośrednio w Android Studio. Ta integracja pobiera dane z wykresu śledzenia pakietu i statystyki dotyczące awarii z Crashlytics i Google Play do okna narzędzi Statystyki jakości aplikacji w Studio IDE, dzięki czemu nie musisz przełączać się między przeglądarką a IDE. Zespoły programistów mogą korzystać z podstawowych funkcji, takich jak:
- Zobacz, które wiersze kodu są wyróżnione, gdy mają powiązane dane zdarzenia Crashlytics.
- Zobacz zrzut stosu dla najczęściej występujących awarii i kliknij go, aby przejść do odpowiednich linii kodu.
- Zobacz statystyki podsumowujące dotyczące najczęstszych awarii i niekrytycznych zdarzeń, np. pogrupowane według producenta urządzenia i wersji Androida.
- Filtruj zdarzenia według atrybutów, takich jak stopień ważności, czas i wersja aplikacji.
- Otrzymasz link do przeglądarki, który otworzy stronę panelu Crashlytics z dodatkowymi informacjami o wydarzeniu.
- Uzyskaj statystyki, które ułatwią Ci zrozumienie i rozwiązanie przyczyn określonych problemów.
Raporty Android Vitals są dostępne dla wszystkich aplikacji opublikowanych w Google Play. Jeśli nie korzystasz jeszcze z Crashlytics i chcesz dowiedzieć się więcej o jego funkcjach, zapoznaj się z artykułem Firebase Crashlytics.
Rozpocznij
Aby wyświetlać dane Crashlytics w Android Studio, musisz skonfigurować Firebase i Crashlytics w projekcie aplikacji. Oto jak to zrobić: otwórz Asystenta Firebase w Android Studio (Narzędzia > Firebase), kliknij Crashlytics, a potem postępuj zgodnie z instrukcjami, aby dodać Firebase i Crashlytics do projektu. Więcej informacji o procesie pracy z asystentem Firebase znajdziesz w przewodniku Firebase dla początkujących użytkowników na Androida.
Jeśli Firebase i Crashlytics zostały już dodane do aplikacji, zaloguj się na konto dewelopera w IDE, klikając ikonę awatara.
Po zalogowaniu się kliknij okno narzędzia Statystyki jakości aplikacji.
Panele powinny wypełnić się raportami z Crashlytics.
Analizowanie Android Vitals
Statystyki dotyczące jakości aplikacji obejmują dane Android Vitals. Dzięki temu łatwiej uzyskasz dostęp do podstawowych danych zbieranych przez Google Play i ulepszyć wrażenia użytkowników. Korzystaj z Android Vitals, aby rozwiązywać problemy związane ze stabilnością aplikacji i poprawiać jakość aplikacji w Google Play.
W oknie narzędzia Statystyki jakości aplikacji możesz wyświetlać problemy Android Vitals, filtrować je oraz przechodzić z zrzutu stosu do kodu. Aby rozpocząć, wykonaj te czynności:
- Zaloguj się na konto dewelopera w Android Studio, używając ikony profilu
na końcu paska narzędzi.
- Otwórz Statystyki dotyczące jakości aplikacji, klikając okno narzędzia w Android Studio lub klikając Widok > okna narzędzia > Statystyki dotyczące jakości aplikacji.
- Na stronie Statystyki dotyczące jakości aplikacji kliknij kartę Android Vitals.
Opcjonalnie: aby korzystać z integracji kontroli wersji w przypadku wersji do debugowania, dodaj do aplikacji najnowszy pakiet SDK Firebase Crashlytics (lub Firebase Android Bill of Materials). Następnie dodaj do pliku na poziomie modułu (
build.gradle.kts
lubbuild.gradle
) ten kod. Wersje produkcyjne (nieobsługiwane przez debuger) mają tę flagę włączoną domyślnie.
Kotlin
android { buildTypes { getByName("debug") { vcsInfo { include = true } } } }
Groovy
android { buildTypes { debug { vcsInfo { include true } } } }
Analizowanie danych Crashlytics w Android Studio
Okno narzędzia Statystyki jakości aplikacji zawiera obszerne dane o zdarzeniach, z którymi spotykają się użytkownicy, oraz linki, które ułatwiają szybkie przechodzenie do źródeł tych zdarzeń.
- W menu identyfikatora aplikacji wybierz identyfikator aplikacji, który chcesz analizować. Podczas pracy nad wersją debugowania aplikacji w IDE możesz na przykład chcieć wyświetlić dane zdarzeń dla wersji produkcyjnej aplikacji, którą instalują użytkownicy.
- Panel Problemy zawiera najczęstsze zdarzenia, o których Crashlytics ma dane, i jest posortowany według najbardziej dotkliwych awarii.
- Wyświetlaj zdarzenia według wariantów lub grup zdarzeń o podobnych śladach stosu. Analiza zdarzeń według wariantu ułatwia identyfikowanie przyczyn awarii.
Karta Ślad wywołania zawiera szczegóły dotyczące ostatniego wystąpienia zdarzenia, które klikniesz w panelu Problemy. Możesz wyświetlić zrzut stosu zdarzenia i kliknąć go, aby przejść do odpowiednich linii w Twoim kodzie. Jeśli kod zmienił się od czasu wystąpienia awarii, kliknij pokaż różnice obok błędu w zrzucie stosu, aby wyświetlić różnice między bieżącym kodem a wersją kodu, która spowodowała awarię.
Znajdziesz tam też informacje o typie urządzenia, na którym wystąpiło zdarzenie, jego wersji Androida i czasie wystąpienia zdarzenia, a także link do zdarzenia na panelu Firebase Crashlytics. Aby przeglądać informacje o kilku zdarzeniach w grupie, użyj strzałek w lewo i w prawo. Kliknij Zamknij problem, aby zamknąć problem bezpośrednio w panelu.
- Karty Klucze i Dzienniki zawierają niestandardowe pary klucz-wartość oraz dzienniki dotyczące każdego raportu Crashlytics.
- W panelu Szczegóły podana jest liczba awarii według typu urządzenia i wersji Androida, dzięki czemu możesz określić, które grupy użytkowników są najbardziej dotknięte problemem. Pokazuje też, w których wersjach aplikacji wystąpiła awaria, oraz liczbę użytkowników, których dotyczy problem.
- Czytaj i dołączaj notatki do problemów, aby były widoczne w konsoli Firebase i dla Twoich współpracowników. Aby napisać notatkę na temat problemu, wybierz go i otwórz panel Notatki. Aby pisać notatki, musisz mieć uprawnienia do zapisu w projekcie Crashlytics. Problemy z notatkami są oznaczone ikoną „notatki”
w panelu Problemy.
- Korzystaj z różnych filtrów, aby skupić się na określonych podzbiorach zdarzeń. Możesz zaznaczać i odznaczać zdarzenia Fatal
, Niefatal
, oraz ANR
, a także filtrować według czasu, wersji aplikacji, sygnału Crashlytics, marki i modelu urządzenia oraz wersji platformy Android. Pamiętaj, że w przypadku stanów sygnału Crashlytics problem jest uważany za regresowany, gdy został zamknięty w przeszłości, a pojawił się ponownie w nowej wersji aplikacji.
Oprócz przechodzenia od ścieżki wywołań do kodu możesz też przeskoczyć z kodu do ścieżki wywołań: Android Studio oznacza teraz wiersze kodu związane z awariami za pomocą ikony żółtego trójkąta, dzięki czemu możesz je łatwo wykryć i debugować.
Gdy najedziesz kursorem na ikonę awarii, pojawi się wyskakujące okienko z liczbą zdarzeń związanych z tą linią kodu oraz ich częstotliwością.
Kliknij ikonę awarii, aby wyświetlić bardziej szczegółową listę zdarzeń, w tym częstotliwość występowania i liczbę użytkowników, których dotyczą. Kliknij konkretne zdarzenie, aby przejść do jego szczegółów w oknie narzędzia Statystyki jakości aplikacji.
Różne liczby w Android Vitals i Crashlytics
Pamiętaj, że Android Vitals i Crashlytics mogą podawać różne wartości liczby użytkowników i zdarzeń związanych z tym samym awarią. Te rozbieżności występują, ponieważ Google Play i Crashlytics mogą rejestrować awarie w różnych momentach i w przypadku różnych użytkowników. Oto kilka powodów, dla których liczby w Google Play i Crashlytics mogą się różnić:
- Play rejestruje awarie od momentu uruchomienia, a Crashlytics – awarie, które występują po zainicjowaniu pakietu SDK Crashlytics.
- Jeśli użytkownik zrezygnuje ze zgłaszania awarii po otrzymaniu nowego telefonu, awarie te nie będą zgłaszane do Google Play. Crashlytics będzie jednak rejestrować awarie zgodnie z własną polityką prywatności aplikacji.
Rozwiąż problemy z ograniczoną funkcjonalnością w trybie offline
Jeśli prześlesz nowe żądanie, np. klikając Odśwież, a Android Studio nie może nawiązać połączenia z Crashlytics, w oknie Statystyki dotyczące jakości aplikacji możesz przejść do trybu offline.
W tym trybie możesz nadal analizować problemy i najnowsze zdarzenia na podstawie danych z pamięci podręcznej. Niektóre funkcje, takie jak zmiana niektórych opcji filtrowania czy zamykanie problemów, są niedostępne. Aby ponownie połączyć się z Crashlytics i przywrócić stan online, kliknij Połącz ponownie
.