Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На этой странице описывается, как загружать трассировки с помощью веб-интерфейса Winscope.
Загрузить с помощью веб-интерфейса
Вы можете запустить Winscope локально или получить к нему доступ с веб-сервера.
Чтобы загрузить захваченные трассы в Winscope, используйте панель Upload Traces для загрузки сохраненных трасс. Нажмите Upload another file для загрузки дополнительных трасс или нажмите X для удаления загруженных трасс.
Рисунок 1. Загрузка трассировок в Winscope.
Нажмите Просмотреть трассы , чтобы просмотреть загруженные трассы. Вкладки для каждой трассы отображаются на верхней панели окна. Если загруженный файл содержит соответствующие трассы, на экран накладывается плавающее представление трассы записи экрана или скриншота.
Winscope использует снэкбар для отображения проблем, обнаруженных при загрузке трассировки, например, когда файл трассировки отбрасывается из-за того, что данные устарели. Следующий список включает текущие предупреждения и их значения:
Сообщение
Описание
поврежденный архив
Не удалось загрузить zip-файл. Обычно это происходит, когда zip-файл пустой (0 байт).
<filename> : отклонено, так как данные устарели
Любые трассы, которые заканчиваются более чем за 5 минут до начала следующей трассы, отбрасываются.
<filename> : отклонено, так как данные старше, чем <time>
На основе последнего найденного монотонного или временного смещения загрузки любые трассировки со смещением более 5 секунд отбрасываются.
<filename> : переопределено другой трассировкой типа <trace type>
Если в одном файле существуют эквивалентные трассировки (например, трассировка и дамп), Winscope использует следующие правила:
Трассировки Perfetto переопределяют устаревшие трассировки того же типа.
Записи экрана имеют приоритет над снимками экрана.
<filename> : переопределено другой трассировкой того же типа
Если в одном файле присутствуют трассировки одного и того же типа, Winscope использует следующие правила:
Трассировки Perfetto переопределяют устаревшие трассировки того же типа.
Самый большой след Perfetto перекрывает все остальные следы Perfetto.
Трассировки переопределяют дампы для WindowManager и SurfaceFlinger.
<filename> : неподдерживаемый формат
Устаревшую трассировку невозможно проанализировать из-за недопустимого прототипа или отсутствующего анализатора Winscope.
Не удалось создать парсер <parser_name> : <error>
Winscope идентифицировал парсер трассировки, но не смог проанализировать файл. Сообщите об ошибке Winscope и прикрепите свой след.
Невозможно визуализировать все следы: Не удалось инициализировать данные временной шкалы. Попробуйте удалить некоторые следы.
Winscope не удалось проанализировать данные временной шкалы из трассировки. Сообщите об ошибке Winscope и прикрепите свою трассировку .
Произошла ошибка при отображении фрейма: <error>
Winscope не удалось сопоставить состояния между различными трассами для навигации. Сообщите об ошибке Winscope и прикрепите свою трассировку .
Отсутствует значение vsync_id для одной или нескольких записей в <table>
Не удалось загрузить трассировку Perfetto из-за отсутствия информации VSync ID. Сообщите об ошибке Winscope и прикрепите свою трассировку .
Найден дубликат идентификатора слоя SF <layerId> — добавляем его как дубликат в иерархию
Трассировка SurfaceFlinger содержит два слоя с одинаковым layerId . Сообщите об ошибке SurfaceFlinger и прикрепите свою трассировку .
Запись экрана может не синхронизироваться с другими трассировками. Метаданные содержат монотонное время вместо прошедшего
Файл записи экрана старый и использует устаревший формат метаданных, который невозможно синхронизировать. Записи экрана из более новых версий Android не должны иметь этой проблемы.
Невозможно проанализировать все переходы. Некоторые могут отсутствовать в просмотрщике переходов.
Невозможно проанализировать трассировку устаревших переходов, данные могут отсутствовать в средстве просмотра.
<filename> : <error>
Другие неотображенные ошибки. Сообщите об ошибке в Winscope и прикрепите свой след .
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 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*. |"]]
