À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment charger des traces à l'aide de l'interface utilisateur Web de Winscope.
Importer à l'aide de l'UI Web
Vous pouvez exécuter Winscope localement ou y accéder à partir d'un serveur Web.
Pour charger les traces capturées dans Winscope, utilisez le panneau Importer des traces pour importer les traces enregistrées. Cliquez sur Importer un autre fichier pour importer d'autres traces ou sur X pour supprimer les traces importées.
Figure 1 : Importez les traces dans Winscope.
Cliquez sur Afficher les traces pour afficher les traces importées. Les onglets de chaque trace s'affichent dans le panneau supérieur de la fenêtre. Si le fichier importé contient les traces pertinentes, une vue flottante de la trace d'enregistrement d'écran ou de la capture d'écran est superposée à l'écran.
Winscope utilise une snackbar pour afficher les problèmes détectés lors du chargement d'une trace, par exemple lorsqu'un fichier de trace est supprimé parce que les données sont obsolètes. La liste suivante inclut les avertissements actuels et leur signification :
Message
Description
archive corrompue
Échec du chargement du fichier ZIP. Cela se produit généralement lorsque le fichier ZIP est vide (0 octets).
<filename> : supprimées, car les données sont obsolètes
Les traces qui se terminent plus de cinq minutes avant le début de la trace suivante sont supprimées.
<filename> : supprimées, car les données sont plus anciennes que <time>
En fonction du décalage temporel monotone ou de démarrage le plus récent détecté, toutes les traces dont le décalage est supérieur à cinq secondes sont supprimées.
<filename> : remplacé par une autre trace de type <trace type>
Lorsque des traces équivalentes (par exemple, une trace et un dump) existent dans le même fichier, Winscope utilise les règles suivantes :
Les traces Perfetto remplacent les anciennes traces du même type.
Les enregistrements d'écran remplacent les captures d'écran.
<filename> : remplacé par une autre trace du même type
Lorsque des traces du même type existent dans le même fichier, Winscope utilise les règles suivantes :
Les traces Perfetto remplacent les anciennes traces du même type.
La plus grande trace Perfetto remplace toutes les autres traces Perfetto.
Les traces remplacent les vidages pour WindowManager et SurfaceFlinger.
<filename> : format non compatible
Impossible d'analyser l'ancienne trace en raison d'un protocole non valide ou de l'absence d'analyseur Winscope.
Échec de la création de l'analyseur <parser_name> : <error>
Winscope a identifié l'analyseur de trace, mais n'a pas pu analyser le fichier.
Signalez un bug Winscope et joignez votre trace.
Impossible de visualiser toutes les traces : échec de l'initialisation des données de la chronologie.
Essayez de supprimer certaines traces.
Winscope n'a pas réussi à analyser les données de chronologie à partir de la trace. Signalez un bug Winscope et joignez votre trace.
Erreur lors du mappage des cadres : <error>
Winscope n'a pas réussi à mapper les états entre différentes traces pour la navigation. Signalez un bug Winscope et joignez votre trace.
Valeur vsync_id manquante pour une ou plusieurs entrées dans <table>
Échec du chargement de la trace Perfetto en raison d'informations manquantes sur l'ID VSync.
Signalez un bug Winscope et joignez votre trace.
ID de calque SF <layerId> en double détecté. Ajouté en tant que doublon à la hiérarchie.
La trace SurfaceFlinger contient deux calques avec le même layerId.
Signalez un bug SurfaceFlinger et joignez votre trace.
L'enregistrement d'écran peut ne pas être synchronisé avec les autres traces.
Les métadonnées contiennent une heure monotone au lieu d'une durée écoulée
Le fichier d'enregistrement d'écran est ancien et utilise un ancien format de métadonnées qui ne peut pas être synchronisé. Ce problème ne devrait pas se produire avec les enregistrements d'écran des versions plus récentes d'Android.
Impossible d'analyser toutes les transitions. Il est possible que certaines d'entre elles ne soient pas disponibles dans le visionneuse de transitions.
Impossible d'analyser la trace des anciennes transitions. Il est possible que des données manquent dans l'aperçu.
<filename> : <error>
Autres erreurs non mappées. Signalez un bug Winscope et joignez votre trace.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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*. |"]]
