A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se describe cómo cargar registros con la IU web de Winscope.
Sube datos con la IU web
Puedes ejecutar Winscope de forma local o acceder a él desde un servidor web.
Para cargar seguimientos capturados en Winscope, usa el panel Upload Traces para subir los seguimientos guardados. Haz clic en Subir otro archivo para subir más registros o en X para quitar los registros subidos.
Figura 1: Sube registros en Winscope.
Haz clic en Ver seguimientos para ver los seguimientos subidos. Las pestañas de cada registro
aparecen en el panel superior de la ventana. Si el archivo subido contiene los registros relevantes, se superpone una vista flotante del registro de la grabación de pantalla o la captura de pantalla en la pantalla.
Winscope usa una barra de notificaciones para mostrar los problemas que se encuentran cuando se carga un registro, por ejemplo, cuando se descarta un archivo de registro porque los datos son antiguos. En la siguiente lista, se incluyen las advertencias actuales y sus significados:
Mensaje
Descripción
archivo dañado
No se pudo cargar el archivo ZIP. Esto suele ocurrir cuando el archivo ZIP está vacío (0 bytes).
<filename>: Se descarta porque los datos son antiguos.
Se descartarán todos los seguimientos que finalicen más de 5 minutos antes de que comience el siguiente.
<filename>: Se descarta porque los datos son más antiguos que <time>
En función del desfase de tiempo de inicio o monótono más reciente que se encuentre, se descartan los registros con un desfase superior a 5 segundos.
<filename>: Se anula con otro seguimiento de tipo <trace type>.
Cuando hay registros equivalentes (por ejemplo, registro y volcado) en el mismo archivo, Winscope usa las siguientes reglas:
Los registros de Perfetto anulan los registros heredados del mismo tipo.
Las grabaciones de pantalla anula las capturas de pantalla.
<filename>: Se anula por otro registro del mismo tipo.
Cuando existen registros del mismo tipo en el mismo archivo, Winscope usa las siguientes reglas:
Los registros de Perfetto anulan los registros heredados del mismo tipo.
El registro de Perfetto más grande anula todos los demás.
Los seguimientos anulan los volcados de WindowManager y SurfaceFlinger.
<filename>: Formato no admitido
No se puede analizar el seguimiento heredado debido a un proto no válido o a que falta el analizador de Winscope.
No se pudo crear el analizador <parser_name>: <error>
Winscope identificó el analizador de seguimiento, pero no pudo analizar el archivo.
Informa un error de Winscope y adjunta el registro.
No se pueden visualizar todos los seguimientos: No se pudieron inicializar los datos del cronograma.
Intenta quitar algunos rastros.
Winscope no pudo analizar los datos de cronograma del seguimiento. Informa un error de Winscope y adjunta el registro.
Se produjo un error en la asignación de tramas: <error>
Winscope no pudo asignar los estados entre diferentes seguimientos para la navegación. Informa un error de Winscope y adjunta el registro.
Falta el valor vsync_id para una o más entradas en <table>
No se pudo cargar el seguimiento de Perfetto debido a que falta información del ID de VSync.
Informa un error de Winscope y adjunta el registro.
Se encontró el ID de capa de SF <layerId> duplicado. Se agregará como Duplicado a la jerarquía.
El registro de SurfaceFlinger contiene dos capas con el mismo layerId.
Envía un informe de error de SurfaceFlinger y adjunta el registro.
Es posible que la grabación de pantalla no esté sincronizada con los otros registros.
Los metadatos contienen tiempo monotónico en lugar de transcurrido
El archivo de grabación de pantalla es antiguo y usa un formato de metadatos heredado que no se puede sincronizar. Las grabaciones de pantalla de versiones más recientes de Android no deberían tener este problema.
No se pueden analizar todas las transiciones. Es posible que falten algunos en el visor de transiciones.
No se puede analizar el seguimiento de transiciones heredadas, por lo que es posible que falten datos en el visor.
<filename>: <error>
Otros errores no asignados Informa un error de Winscope y adjunta el registro.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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*. |"]]