A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página descreve como carregar rastros usando a interface da Web do Winscope.
Fazer upload usando a interface da Web
É possível executar o Winscope localmente ou acessá-lo em um servidor da Web.
Para carregar traços capturados no Winscope, use o painel Upload Traces para
fazer upload de rastros salvos. Clique em Fazer upload de outro arquivo para enviar mais rastros ou
em X para remover os rastros enviados.
Figura 1. Faça upload de rastros no Winscope.
Clique em Visualizar traces para conferir os traces enviados. As guias de cada rastro
aparecem no painel de cima da janela. Se o arquivo enviado tiver os
rastreamentos relevantes, uma visualização flutuante do rastro de gravação de tela ou da captura de tela será
sobreposta à tela.
O Winscope usa uma snackbar para mostrar problemas encontrados ao carregar um rastro, como
quando um arquivo de rastro é descartado porque os dados estão desatualizados. A lista a seguir
inclui os avisos atuais e os significados deles:
Mensagem
Descrição
arquivo corrompido
Falha ao carregar o arquivo ZIP. Isso geralmente acontece quando o arquivo ZIP está vazio (0
bytes).
<filename>: descartado porque os dados são antigos
Os rastros que terminarem mais de cinco minutos antes do início do próximo serão
descartados.
<filename>: descartado porque os dados são mais antigos que
<time>
Com base no deslocamento de tempo de inicialização ou monótono mais recente encontrado, todos os rastros
com um deslocamento maior que 5 segundos são descartados.
<filename>: substituído por outro rastro do tipo
<trace type>
Quando rastros equivalentes (por exemplo, rastro e despejo) existirem no mesmo
arquivo, o Winscope usará as seguintes regras:
Os rastros do Perfetto substituem rastros legados do mesmo tipo.
As gravações de tela substituem as capturas de tela.
<filename>: substituído por outro rastro do mesmo
tipo
Quando rastros do mesmo tipo existem no mesmo arquivo, o Winscope usa as
seguintes regras:
Os rastros do Perfetto substituem rastros legados do mesmo tipo.
O rastro do Perfetto mais longo substitui todos os outros.
Os rastros substituem despejos para WindowManager e
SurfaceFlinger.
<filename>: formato não compatível
O rastro legado não pode ser analisado devido a um proto inválido ou a um analisador do Winscope ausente.
Não foi possível criar o analisador <parser_name>:
<error>
O Winscope identificou o analisador de rastro, mas não conseguiu analisar o arquivo.
Registre um bug do Winscope e anexe seu rastro.
Não é possível visualizar todos os rastros: falha ao inicializar os dados da linha do tempo.
Tente remover alguns rastros.
O Winscope não conseguiu analisar os dados da linha do tempo do rastreamento. Registre um
bug do Winscope e anexe seu rastro.
Ocorreu um erro no mapeamento de frames: <error>
O Winscope não conseguiu mapear os estados entre diferentes rastros para
navegação. Registre um bug do Winscope e anexe seu rastro.
Valor vsync_id ausente para uma ou mais entradas em
<table>
Não foi possível carregar o rastreamento do Perfetto devido à falta de informações do ID do VSync.
Registre um bug do Winscope e anexe seu rastro.
ID da camada SF duplicado <layerId> encontrado. Ele foi adicionado
como Duplicate à hierarquia.
O rastro do SurfaceFlinger contém duas camadas com o mesmo layerId.
Envie um bug do SurfaceFlinger e anexe seu rastro.
A gravação de tela pode não ser sincronizada com os outros rastros.
Os metadados contêm o tempo monótono em vez do tempo decorrido
O arquivo de gravação de tela é antigo e usa um formato de metadados legado que
não pode ser sincronizado. As gravações de tela de versões mais recentes do Android
não têm esse problema.
Não é possível analisar todas as transições. Alguns podem estar ausentes no visualizador
de transições.
Não foi possível analisar o rastro de transições legada. Talvez os dados não estejam disponíveis
no visualizador.
<filename>: <error>
Outros erros não mapeados. Registre um bug do Winscope e anexe seu
rastro.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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*. |"]]
