Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.
Wenn Sie aufgezeichnete Traces in Winscope laden möchten, laden Sie die gespeicherten Traces über den Bereich Traces hochladen hoch. Klicken Sie auf Weitere Datei hochladen, um weitere Traces hochzuladen, oder auf X, um hochgeladene Traces zu entfernen.
Abbildung 1: Laden Sie die Traces in Winscope hoch.
Klicken Sie auf Traces anzeigen, um die hochgeladenen Traces aufzurufen. Oben im Fenster werden Tabs für jeden Trace angezeigt. Wenn die hochgeladene Datei die relevanten Informationen enthält, wird eine schwebende Ansicht der Bildschirmaufzeichnung oder des Screenshots auf dem Bildschirm eingeblendet.
In Winscope werden in einer Snackbar Probleme angezeigt, die beim Laden eines Tracings auftreten, z. B. wenn eine Tracingdatei verworfen wird, weil die Daten veraltet sind. In der folgenden Liste sind die aktuellen Warnungen und ihre Bedeutung aufgeführt:
Nachricht
Beschreibung
Beschädigtes Archiv
Die ZIP-Datei konnte nicht geladen werden. Das passiert in der Regel, wenn die ZIP-Datei leer ist (0 Byte).
<filename>: Daten wurden verworfen, da sie veraltet sind
Alle Traces, die mehr als 5 Minuten vor Beginn des nächsten Traces enden, werden verworfen.
<filename>: verworfen, da die Daten älter als <time> sind
Basierend auf dem zuletzt gefundenen Offset der Monotonie oder Bootzeit werden alle Spuren mit einem Offset von mehr als 5 Sekunden verworfen.
<filename>: von einer anderen Spur vom Typ <trace type> überschrieben
Wenn sich in derselben Datei gleichwertige Protokolle (z. B. Protokoll und Dump) befinden, verwendet Winscope die folgenden Regeln:
Die größte Perfetto-Spur überschreibt alle anderen Perfetto-Spuren.
Traces überschreiben Dumps für WindowManager und SurfaceFlinger.
<filename>: Nicht unterstütztes Format
Der bisherige Trace kann aufgrund eines ungültigen Proto oder eines fehlenden Winscope-Parsers nicht geparst werden.
<parser_name>-Parser konnte nicht erstellt werden:
<error>
Winscope hat den Trace-Parser erkannt, konnte die Datei aber nicht parsen.
Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.
Nicht alle Spuren können visualisiert werden: Die Zeitachsendaten konnten nicht initialisiert werden.
Versuchen Sie, einige Spuren zu entfernen.
Winscope konnte die Zeitachsendaten aus dem Trace nicht parsen. Melden Sie einen Winscope-Fehler und hängen Sie die Ablaufverfolgung an.
Bei der Framezuordnung ist ein Fehler aufgetreten: <error>
Winscope konnte die Zustände zwischen verschiedenen Traces für die Navigation nicht abgleichen. Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.
Bei einem oder mehreren Einträgen in <table> fehlt der Wert für vsync_id.
Das Laden der Perfetto-Spur ist aufgrund fehlender Informationen zur VSync-ID fehlgeschlagen.
Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.
Doppelte SF-Ebenen-ID <layerId> gefunden – wird der Hierarchie als Duplikat hinzugefügt
Die SurfaceFlinger-Spur enthält zwei Ebenen mit derselben layerId.
Erheben Sie einen SurfaceFlinger-Fehler und hängen Sie die Trace-Datei an.
Die Bildschirmaufzeichnung ist möglicherweise nicht mit den anderen Aufzeichnungen synchronisiert.
Metadaten enthalten monotone Zeit statt verstrichene Zeit
Die Bildschirmaufzeichnungsdatei ist alt und verwendet ein älteres Metadatenformat, das nicht synchronisiert werden kann. Bei Bildschirmaufzeichnungen mit neueren Android-Versionen sollte dieses Problem nicht auftreten.
Nicht alle Übergänge können geparst werden. Einige davon sind im Übergangsbetrachter möglicherweise nicht zu sehen.
Der Trace für die alten Übergänge konnte nicht geparst werden. In der Wiedergabe fehlen möglicherweise Daten.
<filename>: <error>
Andere nicht zugeordnete Fehler Melden Sie einen Winscope-Fehler und hängen Sie den Trace an.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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*. |"]]
