Analizuj problemy z Firebase Crashlytics i Android Vitals za pomocą statystyk dotyczących jakości aplikacji

Uwaga: statystyki jakości aplikacji są dostępne tylko w najnowszej stabilnej wersji Androida Studio i w głównych wersjach (wraz z poprawkami) wydanych w ciągu ostatnich 10 miesięcy. Obecnie najstarsza obsługiwana wersja to Otter. Jeśli używasz starszej wersji Androida Studio, musisz ją zaktualizować, aby korzystać ze statystyk jakości aplikacji. Więcej informacji znajdziesz w artykule Zgodność Androida Studio i usług w chmurze.

Wskazówka: aby przyspieszyć proces debugowania, analizuj awarie za pomocą statystyk jakości aplikacji i Gemini

Dane o awariach aplikacji z Firebase Crashlytics i Android Vitals możesz wyświetlać i na ich podstawie podejmować działania bezpośrednio w Android Studio. Ta integracja pobiera dane o śladach stosu i statystyki awarii z Crashlytics i Google Play do okna narzędzia Statystyki jakości aplikacji w IDE Studio, dzięki czemu nie musisz przełączać się między przeglądarką a IDE. Zespoły programistów mogą korzystać z tych kluczowych funkcji:

• Wyświetlanie w kodzie wierszy wyróżnionych, gdy mają one powiązane dane zdarzeń z Crashlytics.
• Wyświetlanie śladu stosu w przypadku najczęstszych awarii i klikanie go, aby przejść do odpowiednich wierszy w kodzie.
• Wyświetlanie statystyk podsumowujących najczęstsze awarie i zdarzenia niekrytyczne, np. pogrupowane według producenta urządzenia i wersji Androida.
• Filtrowanie zdarzeń według atrybutów, takich jak ważność, czas i wersja aplikacji.
• Uzyskiwanie linku do przeglądarki, który otwiera stronę panelu Crashlytics z większą ilością szczegółów o zdarzeniu.
• Uzyskiwanie statystyk, które ułatwiają zrozumienie i rozwiązanie głównych przyczyn niektórych 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, przeczytaj artykuł Firebase Crashlytics.

Rozpocznij

Aby wyświetlać dane z Crashlytics w Android Studio, musisz skonfigurować Firebase i Crashlytics w projekcie aplikacji. Aby to zrobić, otwórz Asystenta Firebase w Android Studio, klikając Narzędzia > Firebase, a następnie Crashlytics i postępuj zgodnie z instrukcjami, aby dodać Firebase i Crashlytics do projektu. Więcej informacji o procesie Asystenta Firebase znajdziesz w przewodniku dla początkujących użytkowników Firebase w Androidzie.

Jeśli masz już dodane Firebase i Crashlytics do aplikacji, zaloguj się na konto dewelopera w IDE, klikając ikonę awatara . Po zalogowaniu kliknij okno narzędzia Statystyki jakości aplikacji . Powinny się pojawić panele z raportami z Crashlytics.

Analizowanie Android Vitals

Statystyki jakości aplikacji obejmują dane Android Vitals. Dzięki temu możesz łatwiej uzyskiwać dostęp do podstawowych danych zbieranych przez Google Play i poprawiać wygodę użytkowników. Używaj Android Vitals, aby rozwiązywać problemy ze stabilnością aplikacji i poprawiać jej jakość w Google Play.

Problemy z Android Vitals możesz wyświetlać i filtrować oraz przechodzić ze śladu stosu do kodu w oknie narzędzia Statystyki jakości aplikacji. Aby zacząć, wykonaj te czynności:

1. Zaloguj się na konto dewelopera w Android Studio, używając ikony profilu na końcu paska narzędzi.
2. Otwórz Statystyki jakości aplikacji , klikając okno narzędzia w Android Studio lub klikając Widok > Okna narzędzi > Statystyki jakości aplikacji.
3. W Statystykach jakości aplikacji kliknij kartę Android Vitals.

4. Opcjonalnie: aby używać integracji z systemem kontroli wersji w przypadku kompilacji z możliwością debugowania, dodaj do aplikacji najnowszy pakiet SDK Firebase Crashlytics (lub Firebase Android Bill of Materials). Następnie dodaj ten kod do pliku build.gradle.kts lub build.gradle na poziomie modułu. W przypadku kompilacji wersji (bez możliwości debugowania) ta flaga jest domyślnie włączona.

   **Uwaga:** statystyki jakości aplikacji obsługują tylko system kontroli wersji git.

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Dynamiczny

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

Analizowanie danych z Crashlytics w Android Studio

Okno narzędzia Statystyki jakości aplikacji zawiera bogate dane, które pozwalają uzyskać wgląd w zdarzenia, z którymi spotykają się użytkownicy, oraz linki ułatwiające szybkie przejście do źródeł tych zdarzeń.

1. W menu aplikacji wybierz identyfikator aplikacji, którą chcesz przeanalizować. Na przykład podczas pracy nad wersją debugowania aplikacji w IDE możesz chcieć wyświetlić dane zdarzeń dotyczące wersji produkcyjnej aplikacji, którą instalują użytkownicy.
2. Panel Problemy pokazuje najczęstsze zdarzenia, dla których Crashlytics ma dane, i jest posortowany według najbardziej istotnych awarii.
3. Wyświetlaj zdarzenia według wariantów, czyli grup zdarzeń o podobnych śladach stosu. Analizowanie zdarzeń według wariantów pomaga zidentyfikować główne przyczyny awarii.

4. Karta Ślad stosu zawiera szczegóły dotyczące ostatniego wystąpienia zdarzenia, które klikniesz w panelu Problemy. Możesz wyświetlić ślad stosu zdarzenia i kliknąć go, aby przejść do odpowiednich wierszy w bazie kodu. Jeśli kod uległ zmianie od czasu wystąpienia awarii, kliknij Pokaż różnicę obok błędu w śladzie stosu, aby wyświetlić różnicę między bieżącym kodem a wersją bazy kodu, która spowodowała awarię.

   

   Znajdują się tu też informacje o typie urządzenia, którego dotyczy problem, jego Android wersji i czasie wystąpienia zdarzenia, a także link do zdarzenia w panelu Firebase Crashlytics. Aby przeglądać informacje o wielu zdarzeniach w grupie, użyj strzałek w lewo i w prawo. Aby zamknąć problem bezpośrednio z panelu, kliknij Zamknij problem.

5. Karty Klucze i Logi zawierają niestandardowe pary klucz-wartość i logi dla każdego raportu Crashlytics.
6. Panel Szczegóły zawiera podział liczby 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 i ilu użytkowników dotyczy problem.
7. Czytaj notatki i dołączaj je do problemów, aby były widoczne w konsoli Firebase i dla członków zespołu. Aby napisać notatkę o problemie, 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.

   

8. Użyj różnych filtrów, aby zawęzić zakres do określonych podzbiorów zdarzeń. Możesz zaznaczać i odznaczać zdarzenia krytyczne , niekrytyczne , i błędy ANR , a także filtrować według czasu, wersji aplikacji, sygnału Crashlytics, producenta i modelu urządzenia oraz wersji platformy Android. Pamiętaj, że w przypadku stanów sygnału Crashlytics problem jest uważany za powracający , jeśli został już zamknięty, ale wystąpił ponownie w nowej wersji aplikacji.

Oprócz możliwości przechodzenia ze śladu stosu do kodu możesz też przechodzić z kodu do śladu stosu. Android Studio dodaje teraz do wierszy kodu powiązanych z awariami ikonę awarii dzięki czemu możesz je łatwo wykrywać i debugować.

Gdy najedziesz kursorem na ikonę awarii, pojawi się wyskakujące okienko z informacją o tym, ile zdarzeń dotyczy danego wiersza kodu, oraz o częstotliwości zdarzeń.

Kliknij ikonę awarii, aby wyświetlić bardziej szczegółową listę zdarzeń, w tym częstotliwość występowania danego zdarzenia i liczbę użytkowników, których dotyczy. Kliknij konkretne zdarzenie, aby przejść do jego szczegółów w oknie narzędzia Statystyki jakości aplikacji.

Różnice w liczbach między Android Vitals a Crashlytics

Pamiętaj, że Android Vitals i Crashlytics mogą podawać różne wartości liczby użytkowników i zdarzeń powiązanych z tą samą awarią. Te rozbieżności wynikają z tego, że Play i Crashlytics mogą wykrywać awarie w różnych momentach i w przypadku różnych użytkowników. Oto kilka powodów, dla których liczby w Play i Crashlytics mogą się różnić:

• Play wykrywa awarie od momentu uruchomienia, a Crashlytics – awarie, które występują po zainicjowaniu pakietu SDK Crashlytics.
• Jeśli użytkownik zrezygnuje z raportowania awarii po otrzymaniu nowego telefonu, te awarie nie będą zgłaszane do Play. Crashlytics wykrywa jednak awarie na podstawie własnej polityki prywatności aplikacji.

Analizowanie z ograniczoną funkcjonalnością w trybie offline

Jeśli wyślesz nowe żądanie, np. klikając Odśwież, a Android Studio nie będzie mogło się połączyć z Crashlytics, w oknie Statystyki 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, np. zmienianie niektórych opcji filtrowania lub zamykanie problemów, są niedostępne. Aby ponownie połączyć się z Crashlytics i wrócić do trybu online, kliknij Połącz ponownie .

Uprawnienia

Zapoznaj się z uprawnieniami usługi.