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.
Capturar rastros
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É possível capturar rastros no
dispositivo
usando o
Winscope
ou os comandos
Android Debug Bridge (adb).
No Winscope, é possível recuperar os rastros mais recentes coletados de um dispositivo durante
a sessão anterior. Esse recurso é muito útil quando você enfrenta problemas de
conexão, como ao usar o ADB por Wi-Fi ou quando o Winscope fecha inesperadamente. Se
não houver rastros da última sessão, o Winscope vai mostrar No valid trace
files found.
Mensagens de erro
O Winscope mostra as seguintes mensagens durante a coleta de rastros:
| Mensagem |
Descrição |
| Nenhum destino de rastreamento selecionado |
Nenhuma caixa de seleção de rastreamento está marcada. |
Ocorreram erros durante o rastreamento:
ERRO: INVALID_LAYER_STACK, verifique
o estado da tela (precisa estar ativado
no início do rastreamento) |
Uma gravação de tela foi solicitada, mas a tela estava desligada no início
do rastreamento. |
Erros ocorreram durante a geração de rastros:
Uma mensagem de erro específica recebida do
comando adb, como "Não foi possível
encontrar arquivos válidos para <trace types
requested>". |
O adb não conseguiu ler os arquivos de rastreamento, o que geralmente acontece quando
o adb não está sendo executado como root. |
| Ocorreram erros durante o rastreamento:
Tempo limite do rastreamento |
Há um problema de conexão com o dispositivo. |
| Ocorreram erros durante o rastreamento:
{inner error} |
Esta mensagem abrange todos os outros erros. |
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,["# Capture traces\n\nYou can capture traces on the\n[device](/docs/core/graphics/winscope/capture/on-device),\nthrough\n[Winscope](/docs/core/graphics/winscope/capture/winscope),\nor through\n[Android Debug Bridge (adb)](/docs/core/graphics/winscope/capture/adb)\ncommands.\n\nIn Winscope, you can retrieve the latest traces collected from a device during\nthe previous session. This feature is especially helpful when facing connection\nissues, such as using ADB over Wi-Fi, or when Winscope closes unexpectedly. If\nthere are no traces from the last session, Winscope displays **No valid trace\nfiles found**.\n\nError messages\n--------------\n\nWinscope shows the following messages during trace collection:\n\n| Message | Description |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| No trace targets selected | No trace checkboxes are selected. |\n| Errors occurred during tracing: ERROR: `INVALID_LAYER_STACK`, please check your display state (must be on at start of trace) | A screen recording was requested, but the display was off at the start of trace. |\n| Errors occurred during tracing: A specific error message received from adb command, such as Failed to find valid files for *\\\u003ctrace types requested\\\u003e* | adb couldn't read the trace files, which typically happens when adb isn't running as root. |\n| Errors occurred during tracing: *Tracing time out* | There's a connection issue with the device. |\n| Errors occurred during tracing: *{inner error}* | This message covers all other errors. |"]]
