از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
برای بارگیری ردیابی های گرفته شده در Winscope، از پانل آپلود ردیابی برای آپلود ردیابی های ذخیره شده استفاده کنید. برای آپلود ردپای بیشتر روی آپلود فایل دیگری یا برای حذف ردپای آپلود شده روی X کلیک کنید.
شکل 1. ردیابی را در Winscope بارگذاری کنید.
برای مشاهده ردپای آپلود شده روی View Traces کلیک کنید. برگه های هر ردیابی در پانل بالای پنجره ظاهر می شود. اگر فایل آپلود شده حاوی ردپای مربوطه باشد، یک نمای شناور از ردیابی صفحه یا اسکرین شات ضبط شده روی صفحه نمایش داده می شود.
Winscope از یک نوار اسنک برای نمایش مشکلاتی که هنگام بارگیری یک ردیابی پیدا می شود، استفاده می کند، مانند زمانی که یک فایل ردیابی به دلیل قدیمی بودن داده ها دور ریخته می شود. لیست زیر شامل اخطارهای فعلی و معانی آنها است:
پیام
توضیحات
آرشیو خراب
فایل فشرده بارگیری نشد. این معمولا زمانی اتفاق میافتد که زیپ خالی باشد (0 بایت).
<filename> : به دلیل قدیمی بودن داده ها کنار گذاشته شد
هر اثری که بیش از 5 دقیقه قبل از شروع ردیابی بعدی تمام شود، دور ریخته می شود.
<filename> : حذف شد زیرا دادهها قدیمیتر از <time> هستند
بر اساس جدیدترین آفست زمان یکنواخت یا بوت یافت شده، هر اثری با افست بیشتر از 5 ثانیه کنار گذاشته می شود.
<filename> : توسط رد دیگری از نوع <trace type> لغو می شود
هنگامی که ردیابی های معادل (به عنوان مثال، trace و dump) در یک فایل وجود دارد، Winscope از قوانین زیر استفاده می کند:
ردیابی Perfetto بر ردیابی های قدیمی از همان نوع غلبه می کند.
ضبط های صفحه نمایش تصاویر را لغو می کند.
<filename> : توسط رد دیگری از همان نوع لغو می شود
هنگامی که ردپایی از یک نوع در یک فایل وجود دارد، Winscope از قوانین زیر استفاده می کند:
ردیابی Perfetto بر ردیابی های قدیمی از همان نوع غلبه می کند.
بزرگترین ردیابی Perfetto بر تمام آثار Perfetto دیگر غلبه می کند.
Traces، Dump ها را برای WindowManager و SurfaceFlinger لغو می کند.
<filename> : فرمت پشتیبانی نشده
ردیابی قدیمی به دلیل وجود یک نسخه اولیه نامعتبر یا تجزیه کننده Winscope از دست رفته قابل تجزیه نیست.
تجزیه کننده <parser_name> ایجاد نشد: <error>
Winscope تجزیه کننده ردیابی را شناسایی کرد اما نتوانست فایل را تجزیه کند. یک باگ Winscope را ثبت کنید و ردیابی خود را پیوست کنید.
نمیتوان همه ردیابیها را تجسم کرد: دادههای جدول زمانی اولیهسازی نشد. سعی کنید برخی از آثار را حذف کنید.
Winscope نتوانست دادههای جدول زمانی را از ردیابی تجزیه کند. یک باگ Winscope را پر کنید و ردیابی خود را پیوست کنید .
خطایی در نگاشت فریم رخ داد: <error>
Winscope در ترسیم وضعیت های بین ردیابی های مختلف برای ناوبری شکست خورد. یک باگ Winscope را پر کنید و ردیابی خود را پیوست کنید .
مقدار vsync_id برای یک یا چند ورودی در <table> وجود ندارد
به دلیل گم شدن اطلاعات شناسه VSync، ردیابی Perfetto بارگیری نشد. یک باگ Winscope را پر کنید و ردیابی خود را پیوست کنید .
ID لایه SF تکراری <layerId> پیدا شد - اضافه کردن آن به عنوان تکراری به سلسله مراتب
ردیابی SurfaceFlinger شامل دو لایه با layerId یکسان است. یک باگ SurfaceFlinger را ثبت کنید و ردیابی خود را پیوست کنید .
ضبط صفحه ممکن است با ردیابی های دیگر همگام سازی نشود. فراداده به جای سپری شده، دارای زمان یکنواخت است
فایل ضبط صفحه قدیمی است و از فرمت ابرداده قدیمی استفاده میکند که قابل همگامسازی نیست. ضبط صفحه از نسخه های جدیدتر اندروید نباید این مشکل را داشته باشد.
نمی توان همه انتقال ها را تجزیه کرد. ممکن است برخی در بیننده Transitions وجود نداشته باشند.
نمیتوان ردیابی انتقالهای قدیمی را تجزیه کرد، ممکن است دادهها از بیننده وجود نداشته باشد.
<filename> : <error>
سایر خطاهای نقشه برداری نشده یک باگ Winscope را پر کنید و ردیابی خود را پیوست کنید .
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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*. |"]]