Rejestrowanie śladu systemu na urządzeniu

Urządzenia z Androidem 9 (poziom interfejsu API 28) lub nowszym zawierają aplikację systemową o nazwie Monitorowanie systemu. Ta aplikacja jest podobna do narzędzia wiersza poleceń systrace, ale umożliwia rejestrowanie logów czasu bezpośrednio z urządzenia testowego bez konieczności podłączania urządzenia i łączenia się z nim przez adb. Następnie możesz użyć aplikacji, aby udostępnić wyniki tych śledzeń swojemu zespołowi programistów.

Urządzenia z Androidem 10 lub nowszym zapisują ścieżki w formacie Peretto, a starsze urządzenia – w formacie Systrace. Zalecamy korzystanie z przeglądarki śledzenia Perfetto do otwierania obu formatów i analizowania logów czasu.

Pomaga to rejestrować ścieżki podczas rozwiązywania problemów z wydajnością w aplikacji, takich jak długie uruchamianie, wolne przejścia lub problemy z interfejsem.

Rejestrowanie śladu systemu

Aplikacja śledzenia systemu umożliwia rejestrowanie śladów systemu za pomocą płytki Szybkie ustawienia lub menu w samej aplikacji. W poniższych sekcjach opisaliśmy, jak dokończyć proces nagrywania za pomocą tych interfejsów.

Nagrywaj za pomocą kafelka Szybkich ustawień

Płytka Szybkie ustawienia to zwykle wygodniejszy sposób na przeprowadzenie procesu śledzenia na urządzeniu.

Konfigurowanie płytki

Jeśli po raz pierwszy korzystasz z śledzenia systemu na urządzeniu testowym lub nie widzisz kafelka Śledzenie systemu w panelu Szybkie ustawienia urządzenia, jak pokazano na rysunku 2, wykonaj te czynności konfiguracyjne:

1. Włącz opcje programisty.
2. Otwórz ekran ustawień Opcje programisty.
3. W sekcji Debugowanie kliknij Śledzenie systemu. Otworzy się aplikacja śledzenia systemu, która wyświetli menu aplikacji.

4. W menu aplikacji włącz Pokaż kafelek Szybkie ustawienia, jak pokazano na rysunku 1. System dodaje kafelek Śledzenie systemu do panelu Szybkie ustawienia, jak pokazano na rysunku 2.

   

   

   Uwaga: system domyślnie dodaje kafelek Śledzenie systemowe jako pierwszy kafelek w panelu Szybkie ustawienia. Jeśli chcesz, aby kafelek wyświetlał się w innym miejscu, użyj trybu edycji panelu, aby go przesunąć.

Przeprowadzanie nagrywania śledzenia systemu

Aby zarejestrować ślad systemu za pomocą panelu Szybkich ustawień, wykonaj te czynności:

1. Kliknij kafelek Śledzenie systemu z etykietą Zarejestruj ślad. Kafelek staje się aktywny, a na ekranie pojawia się stałe powiadomienie informujące o tym, że system rejestruje ślad.

   

2. Wykonaj w aplikacji działania, które ma sprawdzić system.

3. Aby zatrzymać śledzenie, kliknij kafelek Śledzenie systemowe w panelu Szybkie ustawienia lub kliknij powiadomienie o śledzeniu systemowym.

   System wyświetli nowe powiadomienie z komunikatem „Zapisywanie ścieżki”. Po zakończeniu zapisywania system zamknie powiadomienie i wyświetli trzecie powiadomienie z potwierdzeniem, że ślad został zapisany i możesz udostępnić ślad systemu, jak pokazano na rysunku 4:

   

Nagrywanie za pomocą menu aplikacji

Menu aplikacji umożliwia konfigurowanie kilku zaawansowanych ustawień związanych z śledzeniem systemu oraz zawiera przełącznik do uruchamiania i zatrzymywania śledzenia systemu.

Aby zarejestrować śledzenie systemu za pomocą menu aplikacji Śledzenie systemu:

1. Włącz opcje programisty.

2. Otwórz ekran ustawień Opcje programisty. W sekcji Debugowanie wybierz Śledzenie systemu. Otworzy się aplikacja Monitorowanie systemu.

   Jeśli masz skonfigurowany kafelek Śledzenie systemu, możesz go nacisnąć i przytrzymać, aby otworzyć aplikację Monitorowanie systemu.

3. Aby uwzględnić w logu czasu aplikacje z włączonym debugowaniem, wybierz Aplikacje z możliwością debugowania śledzenia.

4. Opcjonalnie wybierz Kategorie wywołań systemu i czujników do śledzenia, a potem wybierz w KB rozmiar bufora według procesora. Wybierz kategorie odpowiadające testowanym przypadkom użycia, np. kategorię Dźwięk do testowania operacji Bluetooth lub kategorię Pamięć do przydzielania pamięci.

5. Opcjonalnie wybierz Długie ślady, aby włączyć ślady, które są stale zapisywane w pamięci urządzenia. W przypadku tej opcji ustaw limity Maksymalny rozmiar długiego śladu i Maksymalny czas trwania długiego śladu.

6. Włącz przełącznik Rejestruj ślad, zaznaczony na rysunku 5. Kafelek zostaje włączony i pojawi się trwałe powiadomienie z informacją, że system rejestruje ślad, tak jak to pokazano na rysunku 3.

   

7. Wykonaj w aplikacji działania, które chcesz sprawdzić.

8. Aby zatrzymać śledzenie, wyłącz przełącznik Nagrywaj śledzenie.

   System wyświetli nowe powiadomienie z komunikatem „Zapisywanie ścieżki”. Po zakończeniu zapisywania system zamknie powiadomienie i wyświetli trzecie powiadomienie z potwierdzeniem, że ślad został zapisany i możesz udostępnić ślad systemu, jak pokazano na rysunku 4.

Udostępnij log czasu systemu

Aplikacja śledzenia systemu pomaga udostępniać wyniki śledzenia systemu w ramach kilku różnych procesów. Na urządzeniu z Androidem 10 (poziom interfejsu API 29) lub nowszym pliki śledzone są zapisywane z rozszerzeniem .perfetto-trace i można je otwierać w interfejsie Perfectto. Na urządzeniu z starszą wersją Androida pliki śledzone są zapisywane z rozszerzeniem .ctrace, które oznacza format Systrace.

Udostępnianie jako wiadomość

Śledzenie systemu pozwala udostępniać zebrane zapisy innym aplikacjom na urządzeniu. Śledzenie możesz wysłać do zespołu programistów e-mailem lub w aplikacji do śledzenia błędów bez konieczności podłączania urządzenia do komputera programistycznego.

Po zarejestrowaniu ścieżki systemu kliknij powiadomienie, które pojawi się na urządzeniu, jak na rysunku 4. Pojawi się selektor intencji platformy, który umożliwia udostępnienie ścieżki za pomocą wybranej aplikacji do obsługi wiadomości.

Udostępnianie w aplikacji Pliki

Na urządzeniach z Androidem 10 (poziom interfejsu API 29) lub nowszym ścieżki są wyświetlane w aplikacji Pliki. Możesz udostępnić ścieżkę z tej aplikacji.

Pobieranie raportu za pomocą ADB

Możesz też wyodrębnić ślad systemowy z urządzenia za pomocą adb. Podłącz urządzenie, na którym nagrano ślad, do komputera programisty, a potem uruchom w oknie terminala te polecenia:

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

Konwertowanie między formatami śledzenia

Pliki śledzone za pomocą narzędzia Perfetto możesz konwertować do formatu Systrace. Więcej informacji znajdziesz w artykule Konwertowanie między formatami ścieżek.

Tworzenie raportu HTML

Podczas udostępniania ścieżki raport jest zapisywany w pliku .perfetto-trace na urządzeniach z Androidem 10 lub nowszym albo w pliku .ctrace we wszystkich innych wersjach.

Utwórz raport HTML z pliku śledzonego za pomocą interfejsu internetowego lub z poziomu wiersza poleceń.

Interfejs internetowy

Aby otworzyć plik śledzenia i wygenerować raport, użyj interfejsu Perfecto.

W przypadku pliku Perfectto kliknij Otwórz plik z wykresami. W przypadku pliku Systrace kliknij Otwórz w starszym interfejsie użytkownika. Starszy interfejs wygląda i działa tak samo jak raport Systrace.

Wiersz poleceń

Aby wygenerować raport HTML z pliku śledzenia, uruchom te polecenia w oknie terminala:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Jeśli nie masz jeszcze programu wiersza poleceń systrace, możesz go pobrać z projektu Catapult na GitHubie lub bezpośrednio z projektu Android Open Source.