A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.
Per caricare le tracce acquisite in Winscope, utilizza il riquadro Carica tracce per caricare le tracce salvate. Fai clic su Carica un altro file per caricare altre tracce o su X per rimuoverle.
Figura 1. Carica le tracce in Winscope.
Fai clic su Visualizza tracce per visualizzare le tracce caricate. Le schede per ogni traccia
vengono visualizzate nel riquadro superiore della finestra. Se il file caricato contiene le tracce pertinenti, sullo schermo viene sovrapposta una visualizzazione mobile della traccia della registrazione dello schermo o dello screenshot.
Winscope utilizza uno snackbar per visualizzare i problemi rilevati durante il caricamento di una traccia, ad esempio quando un file di traccia viene eliminato perché i dati sono obsoleti. L'elenco che segue include gli avvisi attuali e il relativo significato:
Messaggio
Descrizione
Archivio danneggiato
Impossibile caricare il file ZIP. Questo accade in genere quando l'archivio ZIP è vuoto (0
byte).
<filename>: ignorato perché i dati sono obsoleti
Le tracce che terminano più di 5 minuti prima dell'inizio della traccia successiva vengono eliminate.
<filename>: ignorato perché i dati sono precedenti al giorno
<time>
In base all'offset monotonico o di avvio più recente trovato, tutte le tracce con un offset maggiore di 5 secondi vengono eliminate.
<filename>: sostituito da un'altra traccia di tipo
<trace type>
Quando nello stesso
file esistono tracce equivalenti (ad esempio, traccia e dump), Winscope utilizza le seguenti regole:
Le tracce Perfetto sostituiscono le tracce precedenti dello stesso tipo.
Le registrazioni dello schermo sostituiscono gli screenshot.
<filename>: sostituita da un'altra traccia dello stesso
tipo
Quando nello stesso file sono presenti tracce dello stesso tipo, Winscope utilizza le seguenti regole:
Le tracce Perfetto sostituiscono le tracce precedenti dello stesso tipo.
La traccia Perfetto più grande sostituisce tutte le altre tracce Perfetto.
Le tracce sostituiscono i dump per WindowManager e
SurfaceFlinger.
<filename>: formato non supportato
La traccia precedente non può essere analizzata a causa di un proto non valido o di un parser Winscope mancante.
Impossibile creare il parser <parser_name>:
<error>
Winscope ha identificato l'analizzatore di tracce, ma non è riuscito ad analizzare il file.
Segnala un bug di Winscope e allega la traccia.
Impossibile visualizzare tutte le tracce: impossibile inizializzare i dati della cronologia.
Prova a rimuovere alcune tracce.
Winscope non è riuscito ad analizzare i dati della cronologia dalla traccia. Segnala un bug di Winscope e allega la traccia.
Si è verificato un errore nella mappatura dei frame: <error>
Winscope non è riuscito a mappare gli stati tra tracce diverse per la navigazione. Segnala un bug di Winscope e allega la traccia.
Valore vsync_id mancante per una o più voci in
<table>
Impossibile caricare la traccia Perfetto a causa di informazioni mancanti sull'ID VSync.
Segnala un bug di Winscope e allega la traccia.
È stato trovato un ID livello SF duplicato <layerId>. Lo aggiungeremo come Duplicato alla gerarchia
La traccia SurfaceFlinger contiene due livelli con lo stesso layerId.
Segnala un bug di SurfaceFlinger e allega la traccia.
La registrazione dello schermo potrebbe non essere sincronizzata con le altre tracce.
I metadati contengono un'ora monotonica anziché il tempo trascorso
Il file di registrazione dello schermo è precedente e utilizza il formato dei metadati precedente che non può essere sincronizzato. Le registrazioni dello schermo delle versioni più recenti di Android
non dovrebbero presentare questo problema.
Impossibile analizzare tutte le transizioni. Alcune potrebbero non essere presenti nel visualizzatore di Transizioni.
Impossibile analizzare la traccia delle transizioni legacy. I dati potrebbero non essere presenti nel visualizzatore.
<filename>: <error>
Altri errori non mappati. Segnala un bug di Winscope e allega la traccia.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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*. |"]]
