Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này mô tả cách tải dấu vết bằng giao diện người dùng Web Winscope.
Tải lên bằng giao diện người dùng web
Bạn có thể chạy Winscope cục bộ hoặc truy cập vào Winscope từ máy chủ web.
Để tải dấu vết đã thu thập trong Winscope, hãy sử dụng bảng điều khiển Tải dấu vết lên để tải dấu vết đã lưu lên. Nhấp vào Tải tệp khác lên để tải thêm dấu vết lên hoặc nhấp vào biểu tượng X để xoá dấu vết đã tải lên.
Hình 1. Tải dấu vết lên trong Winscope.
Nhấp vào Xem dấu vết để xem các dấu vết đã tải lên. Các thẻ cho từng dấu vết sẽ xuất hiện trên bảng điều khiển trên cùng của cửa sổ. Nếu tệp được tải lên chứa dấu vết liên quan, thì một chế độ xem nổi của dấu vết bản ghi màn hình hoặc ảnh chụp màn hình sẽ được phủ lên màn hình.
Winscope sử dụng thanh thông báo nhanh để hiển thị các vấn đề phát hiện được khi tải một dấu vết, chẳng hạn như khi một tệp dấu vết bị loại bỏ vì dữ liệu đã cũ. Danh sách sau đây bao gồm các cảnh báo hiện tại và ý nghĩa của chúng:
Nội dung
Mô tả
tệp lưu trữ bị hỏng
Không tải được tệp zip. Điều này thường xảy ra khi tệp zip trống (0
byte).
<filename>: bị loại bỏ vì dữ liệu đã cũ
Mọi dấu vết kết thúc quá 5 phút trước khi dấu vết tiếp theo bắt đầu sẽ bị loại bỏ.
<filename>: bị loại bỏ vì dữ liệu cũ hơn <time>
Dựa trên độ lệch thời gian khởi động hoặc độ lệch thời gian khởi động gần đây nhất được tìm thấy, mọi dấu vết có độ lệch lớn hơn 5 giây sẽ bị loại bỏ.
<filename>: bị ghi đè bởi một dấu vết khác thuộc loại <trace type>
Khi các dấu vết tương đương (ví dụ: dấu vết và tệp báo lỗi) tồn tại trong cùng một tệp, Winscope sẽ sử dụng các quy tắc sau:
Dấu vết Perfetto ghi đè các dấu vết cũ thuộc cùng loại.
Bản ghi màn hình sẽ ghi đè ảnh chụp màn hình.
<filename>: bị ghi đè bởi một dấu vết khác thuộc cùng loại
Khi các dấu vết cùng loại tồn tại trong cùng một tệp, Winscope sẽ sử dụng các quy tắc sau:
Dấu vết Perfetto ghi đè các dấu vết cũ thuộc cùng loại.
Dấu vết Perfetto lớn nhất sẽ ghi đè tất cả các dấu vết Perfetto khác.
Dấu vết ghi đè tệp báo lỗi cho WindowManager và SurfaceFlinger.
<filename>: định dạng không được hỗ trợ
Không thể phân tích cú pháp dấu vết cũ do proto không hợp lệ hoặc thiếu trình phân tích cú pháp Winscope.
Không tạo được trình phân tích cú pháp <parser_name>:
<error>
Winscope đã xác định được trình phân tích cú pháp dấu vết nhưng không thể phân tích cú pháp tệp.
Báo cáo lỗi Winscope và đính kèm dấu vết.
Không thể trực quan hoá tất cả dấu vết: Không khởi chạy được dữ liệu dòng thời gian.
Hãy thử xoá một số dấu vết.
Winscope không phân tích cú pháp được dữ liệu dòng thời gian từ dấu vết. Gửi lỗi Winscope và đính kèm dấu vết.
Đã xảy ra lỗi trong quá trình liên kết khung: <error>
Winscope không thể liên kết các trạng thái giữa các dấu vết khác nhau để điều hướng. Gửi lỗi Winscope và đính kèm dấu vết.
Thiếu giá trị vsync_id cho một hoặc nhiều mục trong
<table>
Không tải được dấu vết Perfetto do thiếu thông tin mã nhận dạng VSync.
Gửi lỗi Winscope và đính kèm dấu vết.
Phát hiện mã lớp SF trùng lặp <layerId> – thêm mã này vào hệ phân cấp dưới dạng Trùng lặp
Dấu vết SurfaceFlinger chứa hai lớp có cùng layerId.
Gửi lỗi SurfaceFlinger và đính kèm dấu vết.
Bản ghi màn hình có thể không đồng bộ hoá với các dấu vết khác.
Siêu dữ liệu chứa thời gian đơn điệu thay vì thời gian đã trôi qua
Tệp ghi màn hình đã cũ và sử dụng định dạng siêu dữ liệu cũ không thể đồng bộ hoá. Bản ghi màn hình từ các phiên bản Android mới hơn sẽ không gặp vấn đề này.
Không thể phân tích cú pháp tất cả các hiệu ứng chuyển đổi. Một số hiệu ứng có thể bị thiếu trong trình xem hiệu ứng chuyển đổi.
Không thể phân tích cú pháp dấu vết chuyển đổi cũ, dữ liệu có thể bị thiếu trong trình xem.
<filename>: <error>
Các lỗi khác chưa được liên kết. Báo cáo lỗi Winscope và đính kèm dấu vết.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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*. |"]]