Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.
Untuk memuat rekaman aktivitas di Winscope, gunakan panel Upload Traces untuk
mengupload rekaman aktivitas yang disimpan. Klik Upload file lain untuk mengupload lebih banyak rekaman aktivitas atau
klik X untuk menghapus rekaman aktivitas yang diupload.
Gambar 1. Upload rekaman aktivitas di Winscope.
Klik Lihat trace untuk melihat trace yang diupload. Tab untuk setiap rekaman aktivitas
akan muncul di panel atas jendela. Jika file yang diupload berisi
rekaman aktivitas yang relevan, tampilan mengambang rekaman aktivitas atau screenshot layar
akan ditempatkan di layar.
Winscope menggunakan snackbar untuk menampilkan masalah yang ditemukan saat memuat rekaman aktivitas, seperti
saat file rekaman aktivitas dihapus karena datanya sudah lama. Daftar berikut
mencakup peringatan saat ini dan artinya:
Pesan
Deskripsi
arsip rusak
Gagal memuat file zip. Hal ini biasanya terjadi jika file ZIP kosong (0
byte).
<filename>: dihapus karena data sudah lama
Setiap rekaman aktivitas yang selesai lebih dari 5 menit sebelum rekaman aktivitas berikutnya dimulai akan
dihapus.
<filename>: dihapus karena data lebih lama dari
<time>
Berdasarkan offset waktu booting atau monoton terbaru yang ditemukan, setiap rekaman aktivitas
dengan offset lebih dari 5 detik akan dihapus.
<filename>: diganti oleh rekaman aktivitas lain dari jenis
<trace type>
Jika rekaman aktivitas yang setara (misalnya, rekaman aktivitas dan dump) ada dalam file
yang sama, Winscope akan menggunakan aturan berikut:
Rekaman aktivitas Perfetto akan menggantikan rekaman aktivitas lama dari jenis yang sama.
Perekaman layar akan menggantikan screenshot.
<filename>: diganti oleh rekaman aktivitas lain dari jenis
yang sama
Jika ada rekaman aktivitas dari jenis yang sama dalam file yang sama, Winscope akan menggunakan
aturan berikut:
Rekaman aktivitas Perfetto menggantikan rekaman aktivitas lama dari jenis yang sama.
Rekaman aktivitas Perfetto terbesar akan menggantikan semua rekaman aktivitas Perfetto lainnya.
Rekaman aktivitas mengganti dump untuk WindowManager dan
SurfaceFlinger.
<filename>: format tidak didukung
Trace lama tidak dapat diuraikan karena proto yang tidak valid atau tidak adanya
parser Winscope.
Gagal membuat parser <parser_name>:
<error>
Winscope mengidentifikasi parser rekaman aktivitas, tetapi tidak dapat mengurai file.
Laporkan bug Winscope dan lampirkan rekaman aktivitas Anda.
Tidak dapat memvisualisasikan semua rekaman aktivitas: Gagal melakukan inisialisasi data linimasa.
Coba hapus beberapa rekaman aktivitas.
Winscope gagal menguraikan data linimasa dari rekaman aktivitas. Laporkan
bug Winscope dan lampirkan rekaman aktivitas Anda.
Terjadi error dalam pemetaan frame: <error>
Winscope gagal memetakan status di antara berbagai rekaman aktivitas untuk
navigasi. Laporkan bug Winscope dan lampirkan rekaman aktivitas Anda.
Nilai vsync_id tidak ada untuk satu atau beberapa entri di
<table>
Gagal memuat rekaman aktivitas Perfetto karena informasi ID VSync tidak ada.
Laporkan bug Winscope dan lampirkan rekaman aktivitas Anda.
ID lapisan SF duplikat <layerId> ditemukan - menambahkannya
sebagai Duplikat ke hierarki
Rekaman aktivitas SurfaceFlinger berisi dua lapisan dengan layerId yang sama.
Ajukan bug SurfaceFlinger dan lampirkan rekaman aktivitas Anda.
Perekaman layar mungkin tidak disinkronkan dengan rekaman aktivitas lainnya.
Metadata berisi waktu monoton, bukan waktu yang berlalu
File perekaman layar sudah lama dan menggunakan format metadata lama yang
tidak dapat disinkronkan. Perekaman layar dari versi Android yang lebih baru
tidak akan mengalami masalah ini.
Tidak dapat mengurai semua transisi. Beberapa mungkin tidak ada di penampil
Transisi.
Tidak dapat mengurai rekaman aktivitas transisi lama, data mungkin tidak ada di penampil.
<filename>: <error>
Error lain yang tidak dipetakan. Laporkan bug Winscope dan lampirkan
trace Anda.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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*. |"]]
