Debugowanie instancji roboczych WorkManager przy użyciu inspektora zadań w tle

Inspektor zadań w tle ułatwia wizualizację, monitorowanie i debugowanie pracowników działających w tle w aplikacji przy użyciu biblioteki WorkManager w wersji 2.5.0 lub nowszej.

Rozpocznij

Aby wyświetlić listę instancji roboczych w inspektorze zadań w tle, wykonaj te czynności:

  1. Uruchom aplikację na emulatorze lub połączonym urządzeniu z interfejsem API na poziomie 26 lub wyższym.

  2. Na pasku menu kliknij Widok > Okna narzędzi > Sprawdzanie aplikacji.

  3. Kliknij kartę Inspektor zadań w tle.

  4. Wybierz z menu uruchomiony proces aplikacji.

  5. Instancje robocze w aktualnie uruchomionej aplikacji pojawią się w panelu Inspektora zadań w tle. Kliknij instancję roboczą, którą chcesz dokładniej zbadać.

Wyświetlanie i sprawdzanie instancji roboczych

Gdy wdrażasz aplikację przy użyciu WorkManagera 2.5.0 lub nowszego na urządzeniu z interfejsem API na poziomie 26 lub wyższym, na karcie Inspektor zadań w tle wyświetlają się aktywne instancje robocze. Inspektor zadań w tle (widoczny w późniejszej sekcji jako rysunek 3) zawiera nazwę klasy, bieżący stan, czas rozpoczęcia i liczbę ponawianych prób każdego zadania niezależnie od tego, czy są one uruchomione, nieudane czy ukończone.

Szczegóły zadania

Kliknij zadanie na liście, aby otworzyć panel Szczegóły zadania zawierający szczegółowe informacje o instancji roboczej, które pokazano na rysunku 1.

Zrzut ekranu ze szczegółami wybranej instancji roboczej.
Rysunek 1. Panel Szczegóły zadania.
  • Opis: ta sekcja zawiera nazwę klasy instancji roboczej z pełnym pakietem, a także przypisany tag i identyfikator UUID tej instancji.
  • Wykonanie: ta sekcja przedstawia ograniczenia instancji roboczej (jeśli występują), częstotliwość jej uruchamiania i stan, a także klasę, która została utworzona i umieszczona w kolejce.
  • WorkContinuation: ta sekcja pokazuje, gdzie znajduje się instancja robocza w łańcuchu pracy. Aby sprawdzić szczegóły innej instancji roboczej w łańcuchu pracy, kliknij jej identyfikator UUID.
  • Wyniki: ta sekcja wyświetla czas rozpoczęcia, liczbę ponownych prób i dane wyjściowe wybranej instancji roboczej.

Anuluj instancje robocze

Aby zatrzymać obecnie uruchomioną lub znajdującą się w kolejce instancję roboczą, wybierz ją i na pasku narzędzi kliknij Anuluj wybraną instancję roboczą .

Wyświetl widok wykresu

Instancje robocze są łączone łańcuchami, więc czasami warto przedstawić je na wykresie.

Aby wyświetlić wizualną reprezentację łańcucha instancji roboczych, wybierz instancję roboczą w tabeli i kliknij Pokaż widok wykresu na pasku narzędzi. Na wykresie są rysowane tylko instancje robocze.

Zrzut ekranu przedstawiający widok wykresu.
Rysunek 2. Widok wykresu.

Ten wykres pozwala szybko zobaczyć relacje między instancjami roboczymi i monitorować ich postęp w złożonych łańcuchach relacji.

Aby wrócić do widoku listy, kliknij Pokaż widok listy .

Wyświetlaj i sprawdzaj zadania, alarmy i blokady uśpienia

Inspektor zadań w tle pozwala też sprawdzać zadania, alarmy i blokady uśpienia. Każdy rodzaj zadań asynchronicznego pojawia się pod odpowiednim nagłówkiem na karcie inspektora, co pozwala łatwo monitorować ich stan i postęp.

Podobnie jak w przypadku instancji roboczych, w panelu Szczegóły zadania możesz wybrać zadanie, alarm lub blokadę uśpienia.

Aby wyświetlić szczegółowe informacje o pracowniku, zadaniu, alarmie lub blokadzie uśpienia, wybierz je w panelu Szczegóły zadania po prawej stronie.

Zrzut ekranu okna Inspektora zadań w tle.
Rysunek 3. Okno Inspektora zadań w tle.

Dodatkowe materiały

Więcej informacji o Inspektorze zadań w tle znajdziesz w tych materiałach dodatkowych:

Dokumentacja

Ćwiczenia z programowania

Posty na blogu