Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Android SDK
Code

Android od podstaw: raporty błędów Firebase

by
Difficulty:BeginnerLength:ShortLanguages:

Polish (Polski) translation by Mateusz Kurlit (you can also view the original English article)

Obecnie ponad miliard ludzi używa urządzeń z systemem Android, a tysiące dołączają do nich każdego dnia. Sprawienie, że wszyscy ci ludzie będą z radością korzystać z twojej aplikacji nie jest łatwym zadaniem.

Specyfikacje urządzeń z Androidem znacznie się różnią. Istnieją różne poziomy API, rozmiary ekranów, gęstości pikseli oraz dostępności czujników sprzętowych. Co gorsza, producenci urządzeń intensywnie modyfikują Androida, często wprowadzając drobiazgi, które wyglądają na unikalne na tle konkurencji.

Przy takiej różnorodności, w aplikacji prawdopodobnie pojawią się błędy na kilku urządzeniach i w paru sytuacjach. Zbierając i analizując informacje o tych błędach, możesz wprowadzić poprawki do swojej aplikacji, aby była stabilna i dawała radość z użytkowania.

W tym krótkim artykule, pokażę ci jak użyć Firebase jako rozwiązania do raportów błędów. Bezpłatna, oferująca dużo przydatnych funkcji i łatwa w integracji z dowolną aplikacją na Androida.

1. Tworzenie pliku konfiguracyjnego Firebase

Każdy projekt Android Studio korzystający z Firebase należy zarejestrować za pomocą konsoli Firebase od Google. Po zalogowaniu do konsoli, kliknij przycisk Create New Project, aby rozpocząć proces rejestracji.

Firebase console welcome screen

Po pojawieniu się okna, nadaj odpowiednią nazwę projektowi oraz określ swój kraj.

Create a project dialog

Następnie kliknij przycisk Add Firebase to your Android app.

Platform selection screen

Zostaniesz poproszony o wpisane nazwy pakietu aplikacji Android. Upewnij się, że wpisana nazwa odpowiada tej użytej w projekcie Android Studio.

App configuration dialog

Aby zakończyć, kliknij przycisk Add app. Twoja przeglądarka powinna rozpocząć pobieranie pliku o nazwie google-service.json, który zawiera szczegóły konfiguracji—takie jak ID projektu Firebase, klucz API oraz ID aplikacji—odpowiednio zdefiniowane.

Po zakończeniu pobierania, przenieś plik do katalogu zawierającego projekt Android Studio.

2. Konfigurowanie aplikacji

Aby móc używać Firebase w projekcie Android Studio, musisz dodać wtyczkę Gradle usług Google jako zależność w pliku build.gradle, który znajduje się w głównym katalogu projektu.

Dodatkowo, musisz zaaplikować wtyczkę Gradle usług Google. Dlatego dodaj poniższy wiersz na końcu pliku build.gradle modułu app:

Teraz możesz dodać SDK raportów błędów Firebase jako zależność compile.

To wszystko. Od teraz, Firebase za każdym razem będzie automatycznie generował raport błędów.

3. Ręczne generowanie raportu błędów

Aplikacje ulegają awarii, gdy napotykają na wyjątki lub błędy. Ale co z wyjątkami, które zostały przechwycone za pomocą bloków try...catch? Firebase nie zgłosi ich automatycznie, ponieważ zakłada, że już o nich wiesz. Mimo tego, niekiedy chcesz je zobaczyć w swoich raportach.

Aby wygenerować raport ręcznie, musisz użyć metody FirebaseCrash.report() . Oczekuje ona obiektu Throwable jako jedynego argumentu. W związku z tym, wywołasz ją wewnątrz bloku catch. Poniższy fragment kodu pokazuje jak z niej skorzystać podczas obsługi IOException:

Oto jak wygląda raport błędów w konsoli Firebase:

Crash reports screen of Firebase console

Jak widzisz, podobne raporty błędów są grupowane razem tworząc klaster. Klikając klaster i naciskając przycisk View Details, możesz zapoznać się z poszczególnymi raportami znajdującymi się wewnątrz.

Crash details including stack trace

4. Dodawanie komunikatów dziennika do raportów awarii.

Choć raporty błędów Firebase obejmują ślady stosów i dużo danych diagnostycznych, czasami chcesz dowiedzieć się więcej na temat warunków, które spowodowały pojawienie się błędów w aplikacji. Na przykład, chcesz poznać dokładne wartości kilku ważnych zmiennych lokalnych.

Prostym sposobem na dołączenie takich szczegółów do raportów jest wygenerowanie niestandardowych komunikatów dziennika za pomocą metody FirebaseCrash.log(), która oczekuje ciągu jako jedynego argumentu.

Poniższy fragment kodu generuje niestandardowy komunikat dziennika.

Zwróć uwagę, ze niestandardowy komunikat dziennika zostanie dołączony do kolejnego raportu błędów.

W konsoli Firebase możesz zobaczyć komunikaty dziennika na końcu raportu błędów.

Log messages in Firebase console

Podsumowanie

Błędy nigdy nie powinny być ignorowane, ponieważ przez nie użytkownicy tracą zainteresowanie aplikacją. Ponadto mogą prowadzić do utraty danych. Korzystając z usług takich jak Firebase, możesz regularnie monitorować błędy aplikacji oraz błyskawicznie wprowadzać odpowiednie poprawki. Dobry pomysłem jest również dołączenie opisów poprawek w dzienniku zmian aplikacji, aby użytkownicy wiedzieli, że o nich dbasz!

Aby dowiedzieć się więcej o raportach błędów Firebase, przejrzyj oficjalną dokumentację. Więcej informacji na temat Firebase i związanych z nim technologii znajdziesz w naszych pozostałych poradnikach!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.