اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضِّح هذه الصفحة كيفية تحميل عمليات التتبُّع باستخدام واجهة مستخدم الويب في Winscope.
التحميل باستخدام واجهة مستخدِم الويب
يمكنك تشغيل Winscope على الجهاز أو الوصول إليه من خادم ويب.
لتحميل السجلّات التي تم تسجيلها في Winscope، استخدِم لوحة تحميل السجلّات لتحميل السجلّات المحفوظة. انقر على تحميل ملف آخر لتحميل المزيد من عمليات التتبّع أو
انقر على X لإزالة عمليات التتبّع المحمَّلة.
الشكل 1: تحميل عمليات التتبّع في Winscope
انقر على عرض عمليات التتبّع لعرض عمليات التتبّع التي تم تحميلها. تظهر علامات التبويب لكل عملية تتبُّع في اللوحة العلوية من النافذة. إذا كان الملف الذي تم تحميله يحتوي على
التتبّعات ذات الصلة، يتم عرض عرض عائم للشاشة أو لقطة شاشة للتتبّع
على الشاشة.
يستخدم Winscope شريط إعلام منبثق لعرض المشاكل التي يتم رصدها عند تحميل أحد عمليات التتبّع، مثل
عند تجاهل ملف تتبّع لأنّ البيانات قديمة. تتضمّن القائمة التالية
التحذيرات الحالية ومعانيها:
رسالة
الوصف
أرشيف تالف
تعذّر تحميل ملف zip. يحدث ذلك عادةً عندما يكون ملف zip فارغًا (0
بايت).
<filename>: تم تجاهله لأنّ البيانات قديمة
يتم تجاهل أي عمليات تتبُّع تنتهي قبل أكثر من 5 دقائق من بدء عملية التتبُّع التالية.
<filename>: تم تجاهلها لأنّ البيانات أقدم من
<time>
استنادًا إلى آخر رصد لمقياس مونوتوني أو وقت التمهيد، يتم تجاهل أيّ مسارات
بمقياس مونوتوني أكبر من 5 ثوانٍ.
<filename>: تم استبداله بمسار آخر من النوع
<trace type>
عندما تتوفّر عمليات تتبُّع مماثلة (مثل التتبُّع وتفريغ الذاكرة) فيملف
نفسه، يستخدم Winscope القواعد التالية:
تلغي عمليات تتبُّع Perfetto عمليات التتبُّع القديمة من النوع نفسه.
تُلغي تسجيلات الشاشة لقطات الشاشة.
<filename>: تم إلغاؤه من خلال تتبع آخر من النوع
نفسه
عندما تتوفّر آثار من النوع نفسه في الملف نفسه، يستخدم Winscope
القواعد التالية:
تلغي عمليات تتبُّع Perfetto عمليات التتبُّع القديمة من النوع نفسه.
تلغي عملية تتبُّع Perfetto الأكبر جميع عمليات تتبُّع Perfetto الأخرى.
تلغي عمليات التتبُّع عمليات تفريغ الذاكرة لـ WindowManager و
SurfaceFlinger.
<filename>: تنسيق غير متوافق
لا يمكن تحليل التتبُّع القديم بسبب ملف proto غير صالح أو عدم توفّر معالج
Winscope.
تعذّر إنشاء معالج <parser_name>:
<error>
رصد Winscope محلل التتبّع ولكن تعذّر عليه تحليل الملف.
قدِّم تقرير خطأ في Winscope وأرفق المسار.
تعذُّر عرض جميع عمليات التتبّع: تعذّر إعداد بيانات المخطط الزمني.
جرِّب إزالة بعض العناصر.
تعذّر على Winscope تحليل بيانات المخطط الزمني من عملية التتبّع. قدِّم بلاغًا عن خطأ في
Winscope وأرفِق عملية التتبُّع.
حدث خطأ في ربط الإطارات: <error>
تعذّر على Winscope ربط الحالات بين عمليات التتبّع المختلفة للتنقل. قدِّم تقريرًا عن خطأ في Winscope وأرفق المسار.
قيمة vsync_id غير متوفّرة لإدخال واحد أو أكثر في
<table>
تعذّر تحميل تتبع Perfetto بسبب عدم توفّر معلومات معرّف VSync.
قدِّم تقريرًا عن خطأ في Winscope وأرفق المسار.
تم العثور على معرّف طبقة SF المكرّر <layerId>، وسيتمّ إضافته
بصفته مكرّرًا إلى التسلسل الهرمي
يحتوي تتبع SurfaceFlinger على طبقتَين بقيمة layerId نفسها.
قدِّم خطأً في SurfaceFlinger وأرفِق عملية التتبُّع.
قد لا تتم مزامنة تسجيل الشاشة مع عمليات التتبّع الأخرى.
تحتوي البيانات الوصفية على وقت أحادي بدلاً من الوقت المنقضي
ملف تسجيل الشاشة قديم ويستخدم تنسيق بيانات وصفية قديمًا
لا يمكن مزامنته. من المفترض ألا تحدث هذه المشكلة في تسجيلات الشاشة التي يتم إنشاؤها باستخدام إصدارات Android الأحدث.
تعذُّر تحليل جميع عمليات النقل قد تكون بعض العناصر غير متوفّرة في "مُشغّل الانتقالات".
تعذّر تحليل تتبع الانتقالات القديمة، وقد تكون البيانات مفقودة من
المشاهد.
<filename>: <error>
الأخطاء الأخرى غير المُحدَّدة قدِّم خطأ في Winscope وأرفق
تتبُّع.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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*. |"]]