Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie opisujemy, jak wczytywać ścieżki za pomocą interfejsu internetowego Winscope.
Przesyłanie za pomocą interfejsu internetowego
Winscope możesz uruchomić lokalnie lub uzyskać do niego dostęp na serwerze internetowym.
Aby załadować zapisany ślad w Winscope, użyj panelu Prześlij ślady, aby przesłać zapisane ślady. Kliknij Prześlij inny plik, aby przesłać więcej ścieżek, lub kliknij X, aby usunąć przesłane ścieżki.
Rysunek 1. Przesyłanie śladów w Winscope.
Aby wyświetlić przesłane ścieżki, kliknij Wyświetl ścieżki. Karty poszczególnych ścieżek są widoczne w górnym panelu okna. Jeśli przesłany plik zawiera odpowiednie ślady, na ekranie wyświetli się pływający widok śladu nagrania ekranu lub zrzutu ekranu.
Winscope używa paska powiadomień do wyświetlania problemów znalezionych podczas wczytywania ścieżki, np. gdy plik ścieżki jest odrzucany, ponieważ dane są stare. Poniżej znajdziesz listę aktualnych ostrzeżeń i ich opisów:
Wiadomość
Opis
uszkodzone archiwum,
Nie udało się wczytać pliku zip. Zwykle dzieje się tak, gdy plik ZIP jest pusty (0 bajtów).
<filename>: odrzucony, ponieważ dane są nieaktualne
Wszystkie śledzenia, które kończą się na więcej niż 5 minut przed rozpoczęciem następnego śledzenia, są odrzucane.
<filename>: odrzucony, ponieważ dane są starsze niż
<time>
Na podstawie ostatniego znalezionego przesunięcia monotonicznego lub czasu rozruchu wszystkie ścieżki z przesunięciem większym niż 5 sekund są odrzucane.
<filename>: zastąpiony przez inny ślad typu <trace type>
Jeśli w tym samym pliku znajdują się równe ścieżki (np. ścieżka śledzenia i zrzut), Winscope stosuje te reguły:
Ścieżki Peretto zastępują starsze ścieżki tego samego typu.
Nagrania ekranu zastępują zrzuty ekranu.
<filename>: zastąpiony przez inny ślad tego samego typu
Jeśli w tym samym pliku znajdują się ślady tego samego typu, Winscope stosuje te reguły:
Ścieżki Perfectto zastępują starsze ścieżki tego samego typu.
Największy ślad Perfetto zastępuje wszystkie inne ślady Perfetto.
Ścieżki zastępują zrzuty pamięci dla WindowManager i SurfaceFlinger.
<filename>: nieobsługiwany format
Nie można przeanalizować starszego śledzenia z powodu nieprawidłowego protokołu lub braku parsera Winscope.
Nie udało się utworzyć parsowania <parser_name>:
<error>
Winscope wykrył parsowanie śladu, ale nie udało się przeanalizować pliku.
Zgłoś błąd w Winscope i załącz ślad.
Nie można wizualizować wszystkich ścieżek: nie udało się zainicjować danych osi czasu.
Spróbuj usunąć niektóre ślady.
Winscope nie udało się przeanalizować danych osi czasu z wykresu. Zgłoś błąd Winscope i załącz ślad
Wystąpił błąd podczas mapowania ramki: <error>
Winscope nie mógł zmapować stanów między różnymi śladami na potrzeby nawigacji. Zgłoś błąd w Winscope i załącz ślad.
Brak wartości vsync_id w co najmniej 1 wpisie w tabeli <table>
Nie udało się wczytać ścieżki Peretto z powodu braku informacji o identyfikatorze VSync.
Zgłoś błąd w Winscope i załącz ślad.
Znaleziono zduplikowany identyfikator warstwy SF <layerId> – dodano go do hierarchii jako duplikat
Ślad SurfaceFlinger zawiera 2 warstwy z tą samą wartością layerId.
Zgłoś błąd w SurfaceFlingerze i załącz ślad
Nagrywanie ekranu może nie być zsynchronizowane z innymi śladami.
Metadane zawierają monotoniczny czas zamiast upływu czasu
Plik nagrywania ekranu jest stary i używa starszego formatu metadanych, który nie może być synchronizowany. W przypadku nowszych wersji Androida ten problem nie powinien występować.
Nie można przeanalizować wszystkich przejść. Niektóre z nich mogą być niewidoczne w przeglądarce Transitions.
Nie udało się przeanalizować starszego śladu przejść, ponieważ w odtwarzaczu może brakować danych.
<filename>: <error>
Inne niemapowane błędy. Zgłoś błąd w Winscope i załącz ślad błędu.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# Load traces\n\nThis page describes how to load traces using the Winscope Web UI.\n\nUpload using the web UI\n-----------------------\n\nYou can [run Winscope](/docs/core/graphics/winscope/run) locally or access it from a web server.\n\nTo load [captured traces](/docs/core/graphics/winscope/capture/overview) in Winscope, use the **Upload Traces** panel to\nupload saved traces. Click **Upload another file** to upload more traces or\nclick **X** to remove uploaded traces.\n\n**Figure 1.** Upload traces in Winscope.\n\nClick **View traces** to view the uploaded traces. Tabs for each trace\nappear on the top panel of the window. If the uploaded file contains the\nrelevant traces, a floating view of the screen recording trace or screenshot is\noverlaid on the screen.\n\nSee [Analyze traces](/docs/core/graphics/winscope/analyze/overview) for more information.\n| **Note:** The supported trace file types are Winscope traces (in Perfetto or legacy proto format), screenshots, MP4 videos with Winscope metadata (collected with adb screenrecord), zip files, gzip file, and bug reports.\n\nParse warnings and errors\n-------------------------\n\nWinscope uses a snackbar to display issues found when loading a trace, such as\nwhen a trace file is discarded because the data is old. The following list\nincludes the current warnings and their meanings:\n\n| Message | Description |\n|-----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| *corrupted archive* | Failed to load the zip file. This usually happens when the zip is empty (0 bytes). |\n| *`\u003cfilename\u003e`: discarded because data is old* | Any traces that finish more than 5 minutes before the next trace starts are discarded. |\n| *`\u003cfilename\u003e`: discarded because data is older than `\u003ctime\u003e`* | Based on the most recent monotonic or boot time offset found, any traces with an offset greater than 5 seconds are discarded. |\n| *`\u003cfilename\u003e`: overridden by another trace of type `\u003ctrace type\u003e`* | When equivalent traces (for example, trace and dump) exist in the same file, Winscope uses the following rules: - Perfetto traces override legacy traces of the same type. - Screen recordings override screenshots. |\n| *`\u003cfilename\u003e`: overridden by another trace of same type* | When traces of the same type exist in the same file, Winscope uses the following rules: - Perfetto traces override legacy traces of same type. - The largest Perfetto trace overrides all other Perfetto traces. - Traces overrides dumps for WindowManager and SurfaceFlinger. |\n| *`\u003cfilename\u003e`: unsupported format* | The legacy trace can't be parsed due to an invalid proto or missing Winscope parser. |\n| *Failed to create `\u003cparser_name\u003e` parser: `\u003cerror\u003e`* | Winscope identified the trace parser but couldn't parse the file. *File a Winscope bug and attach your trace.* |\n| *Cannot visualize all traces: Failed to initialize timeline data. Try removing some traces.* | Winscope failed to parse timeline data from the trace. *File a Winscope bug and attach your trace*. |\n| *Error occurred in frame mapping: `\u003cerror\u003e`* | Winscope failed to map the states between different traces for navigation. *File a Winscope bug and attach your trace*. |\n| *Missing `vsync_id` value for one or more entries in `\u003ctable\u003e`* | Failed to load Perfetto trace due to missing VSync ID information. *File a Winscope bug and attach your trace*. |\n| *Duplicate SF layer ID `\u003clayerId\u003e` found - adding it as **Duplicate** to the hierarchy* | SurfaceFlinger trace contains two layers with the same `layerId`. *File a SurfaceFlinger bug and attach your trace*. |\n| *Screen recording may not be synchronized with the other traces. Metadata contains monotonic time instead of elapsed* | The screen recording file is old and uses legacy metadata format that can't be synchronized. Screen recordings from newer versions of Android shouldn't have this issue. |\n| *Cannot parse all transitions. Some may be missing in Transitions viewer.* | Unable to parse the legacy transitions trace, data might be missing from the viewer. |\n| *`\u003cfilename\u003e`: `\u003cerror\u003e`* | Other unmapped errors. *File a Winscope bug and attach your trace*. |"]]