جستجوی ردیابی

از SQL برای یافتن وضعیت‌های خاص در ردپاهای Winscope Perfetto استفاده کنید. نمای کلی جستجو در میانای کاربری Winscope به شما امکان می‌دهد پرسمان‌ها را اجرا کنید و نتایج جدول‌بندی‌شده را تجسم کنید:

شکل ۱. برگه نظاره‌گر جستجو.

بیننده جستجو به شما امکان می‌دهد پُرسمان‌های SQL سفارشی را روی ردهای Perfetto بنویسید و اجرا کنید. همچنین می‌توانید به پُرسمان‌های اخیر و ذخیره‌شده دسترسی داشته باشید. Winscope نماهای SQL تخصصی ارائه می‌دهد تا به شما در جستجوی ردگیری‌های SurfaceFlinger،‏ Transactions،‏ Transitions، و ViewCapture کمک کند.

برای همه نماها از قراردادهای زیر استفاده کنید:

• برای property و flat_property ستون:

  • نام‌های دارایی به‌صورت نگارش ماری است، برای مثال visible_region از LayerProto.

  • نماد نقطه نشان‌دهنده ویژگی‌های تودرتو است، برای مثال، visible_region.rect.

  • فیلدهای تکراری در property با کروشه متمایز می‌شوند:

    برای مثال، در دو نمونه از فیلد تکرارشونده visible_region.rect، فیلد top با visible_region.rect[0].top و visible_region.rect[1].top نشان داده می‌شود.

  • فیلدهای تکراری در flat_property قابل‌تشخیص نیستند:

    برای مثال، در دو نمونه از فیلد تکرارشونده visible_region.rect، فیلد top با visible_region.rect.top در هر دو نمونه نشان داده می‌شود.

• برای ستون‌های value و previous_value، مقادیر منطقی با 0 (False) یا 1 (True) نشان داده می‌شوند.

Winscope این نماها را با پیوستن داده‌ها از جدول‌های ردیابی خاص با جدول args Perfetto ایجاد می‌کند. می‌توانید مستقیماً این جدول‌ها را پُرسمان کنید. در جدول args، ستون‌های key، flat_key، و display_value به‌ترتیب مشابه ستون‌های نمای property، flat_property، و value هستند.

جدول args:

نماهای SurfaceFlinger SQL

داده‌های SurfaceFlinger proto از این قالب‌ها استفاده می‌کند:

• داده‌های لایه در قالب LayerProto است.
• داده‌های ریشه سلسله‌مراتب در قالب LayersSnapshotProto است.

برای جستجوی داده‌های لایه، از نمای sf_layer_search استفاده کنید. این نما شامل این ستون‌ها است:

برای جستجوی داده‌های ریشه سلسله‌مراتب، از نمای sf_hierarchy_root_search استفاده کنید. این نمای شامل این ستون‌ها است:

نمونه پُرسمان‌ها

• پیدا کردن همه قاب‌هایی که لایه IME در آن‌ها نمایان است:

  SELECT DISTINCT ts, layer_id, layer_name FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND is_visible=1
  

• پیدا کردن همه قاب‌هایی که لایه IME در آن‌ها محدوده صفحه معتبر دارد:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND property='screen_bounds.bottom'
    AND value<='24000'
  

• پیدا کردن همه قاب‌هایی که در آن‌ها لایه Taskbar color.a (آلفا) تغییر می‌کند:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'Taskbar%'
    AND property='color.a'
    AND value!=previous_value
  

• همه قاب‌هایی را پیدا کنید که کران پایین Wallpaper کمتر یا مساوی با ۲۴۰۰ است:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name LIKE 'Wallpaper%'
    AND property='bounds.bottom'
    AND cast_int!(value) <= 2400
  

• فهرست کردن همه دارایی‌ها برای نمایشگرها با پشته لایه معتبر:

  SELECT STATE.* FROM sf_hierarchy_root_search STATE_WITH_DISPLAY_ON
  INNER JOIN sf_hierarchy_root_search STATE
    ON STATE.state_id = STATE_WITH_DISPLAY_ON.state_id
    AND STATE_WITH_DISPLAY_ON.flat_property='displays.layer_stack'
    AND STATE_WITH_DISPLAY_ON.value!='4294967295'
    AND STATE.property LIKE CONCAT(
      SUBSTRING(
          STATE_WITH_DISPLAY_ON.property,
          0,
          instr(STATE_WITH_DISPLAY_ON.property, ']')
      ),
      '%'
    )
  

• پیدا کردن همه قاب‌هایی که اشاره تند به‌عقب در آن‌ها نمایان است

  SELECT DISTINCT STATE.ts FROM sf_layer_search STATE
    WHERE STATE.layer_name LIKE 'EdgeBackGestureHandler%'
  

جدول‌های داده‌ها

نماهای SurfaceFlinger بااستفاده از جدول‌های زیرین زیر ایجاد می‌شوند.

surfaceflinger_layers_snapshot:

surfaceflinger_layer:

نمای SQL تراکنش‌ها

داده‌های پروتو تراکنش‌ها از قالب TransactionTraceEntry استفاده می‌کند.

برای جستجوی داده‌های ردیابی «تراکنش‌ها»، از نمای transactions_search استفاده کنید. این نما شامل این ستون‌ها است:

پُرسمان‌های نمونه

• قاب را پیدا کنید که در آن تراکنشی اعمال شده است تا موقعیت لایه x را به -۵۴٫۰ تغییر دهد:

  SELECT ts, transaction_id, value FROM transactions_search
    WHERE flat_property='transactions.layer_changes.x'
    AND value='-54.0'
  

• فریمی را که لایه ImeContainer به آن اضافه شده است پیدا کنید:

  SELECT ts FROM transactions_search
    WHERE flat_property='added_layers.name'
    AND value='ImeContainer'
  

جدول‌های داده

نمای SQL «تراکنش‌ها» بااستفاده از جدول‌های زیرین زیر ایجاد می‌شود.

surfaceflinger_transactions:

android_surfaceflinger_transaction:

android_surfaceflinger_transaction_flag:

تراکنش‌های فردی براساس نوع تراکنش از قالب‌های مختلف پیام اولیه به جدول args اضافه می‌شوند:

• ‫LAYER_ADDED: قالب LayerCreationArgs
• LAYER_CHANGED: قالب LayerState
• DISPLAY_ADDED: قالب DisplayState
• DISPLAY_CHANGED: قالب DisplayState
• ‫LAYER_DESTROYED: بدون متغیر
• LAYER_HANDLE_DESTROYED: بدون متغیر
• ‫DISPLAY_REMOVED: بدون متغیر
• NOOP: بدون متغیر

نمای SQL انتقال‌ها

داده‌های نمونه اولیه انتقال‌ها از قالب ShellTransition استفاده می‌کند.

برای جستجوی داده‌های «انتقال‌ها»، از نمای transitions_search استفاده کنید. این نما شامل این ستون‌ها است:

پُرسمان‌های نمونه

خصوصیت‌های انتقال‌های انجام‌شده توسط DefaultMixedHandler را پیدا کنید:

  SELECT
    PROPS.ts,
    PROPS.transition_id,
    PROPS.property,
    PROPS.value
  FROM transitions_search HANDLER_MATCH
  INNER JOIN transitions_search PROPS
    ON HANDLER_MATCH.transition_id = PROPS.transition_id
  WHERE HANDLER_MATCH.property = 'handler'
    AND HANDLER_MATCH.value LIKE "%DefaultMixedHandler"
  ORDER BY PROPS.transition_id, PROPS.property

جدول‌های داده‌ها

نمای «گذارها» بااستفاده از جدول‌های زیرین زیر ایجاد می‌شود.

window_manager_shell_transitions:

window_manager_shell_transition_handlers:

android_window_manager_shell_transition_participants:

مشاهده نمای ViewCapture SQL

داده‌های ViewCapture proto از قالب View استفاده می‌کند.

برای جستجوی داده‌های ViewCapture، از نمای viewcapture_search استفاده کنید. این نما شامل این ستون‌ها است:

نمونه پُرسمان‌ها

همه وضعیت‌ها را وقتی SearchContainerView در جهت y حرکت می‌کند پیدا کنید:

  SELECT * FROM viewcapture_search
  WHERE class_name LIKE '%SearchContainerView'
    AND flat_property='translation_y'
    AND value!=previous_value

جدول‌های داده

نمای ViewCapture بااستفاده از جدول‌های زیرین زیر ایجاد شده است.

android_viewcapture:

android_viewcapture_view:

جدول SQL مربوط به ProtoLog

داده‌های ProtoLog proto از قالب ProtoLogMessage استفاده می‌کند. این نما شامل این ستون‌ها است:

نمونه پُرسمان‌ها

• پیدا کردن همه گزارش‌های دارای پیام حاوی transition:

  SELECT ts, message, location FROM protolog
    WHERE message LIKE '%transition%'
  

• همه گزارش‌هایی را که حاوی شناسه‌های تراکنش معتبر است پیدا کنید:

  CREATE PERFETTO VIEW valid_tx_ids AS
    SELECT DISTINCT transaction_id FROM transactions_search
    WHERE transaction_id IS NOT NULL AND transaction_id != '0';
  
  SELECT TRANS.transaction_id, message FROM valid_tx_ids TRANS
  INNER JOIN protolog LOGS
    ON LOGS.message LIKE CONCAT('%', TRANS.transaction_id, '%');
  

نمای WindowManager SQL

داده‌های WindowManager proto از قالب WindowManagerServiceDumpProto سلسله‌مراتبی استفاده می‌کند. می‌توانید ویژگی‌های هر محفظه WindowManager را جستجو کنید، ازجمله:

• DisplayContentProto
• DisplayAreaProto
• TaskProto
• ActivityRecordProto
• WindowTokenProto
• WindowStateProto
• TaskFragmentProto
• WindowContainerProto

برای جستجوی داده‌های WindowManager، از نمای wm_search استفاده کنید. این نما شامل این ستون‌ها است:

نمونه پُرسمان‌ها

• همه ایالت‌هایی را که LauncherActivity در آن‌ها نمایان است پیدا کنید:

  SELECT DISTINCT ts, title, token FROM wm_search
    WHERE title like '%LauncherActivity%'
    AND is_visible=1
  

• همه ایالت‌هایی را که سطح Wallpaper در آن‌ها درحال حرکت است پیدا کنید:

  SELECT ts, value, previous_value FROM wm_search
    WHERE title like '%Wallpaper%'
    AND property like '%surface_position%'
    AND value != previous_value
  

جدول‌های داده

نمای WindowManager بااستفاده از جدول‌های زیرین زیر ایجاد می‌شود.

android_windowmanager:

android_windowmanager_windowcontainer:

اجرای پُرسمان‌ها

می‌توانید بااستفاده از پانل جستجوی سراسری در سمت چپ نمایشگر جستجو، پرسمان‌های جستجو را اجرا کنید.

وقتی برای اولین‌بار با پانل جستجوی سراسری تعامل برقرار می‌کنید، جستجوی ردگیری مقداردهی اولیه می‌شود و Winscope نماهای SQL کمکی را ایجاد می‌کند. این کار چند ثانیه طول می‌کشد. تا زمانی که جستجوی ردیابی درحال مقداردهی اولیه است، خط زمان دردسترس نیست.

برای شروع یک پُرسمان، پُرسمانی را در چارگوش جستجو بنویسید و روی اجرای پُرسمان جستجو کلیک کنید یا کلید Enter را روی صفحه‌کلید فشار دهید تا اجرا شود.

پس‌از اتمام، جدول نتایج در پانل میانی نشان داده می‌شود. پرسمان شما در زیر چارگوش جستجو نشان داده می‌شود و فیلدی برای ذخیره کردن پرسمان بین جلسه‌ها وجود دارد.

با کلیک کردن روی برگه ذخیره‌شده در پانل سمت راست، می‌توانید به پُرسمان‌های ذخیره‌شده دسترسی پیدا کنید، و با کلیک کردن روی برگه اخیر، می‌توانید به پُرسمان‌هایی که اخیراً اجرا شده‌اند دسترسی پیدا کنید:

شکل ۲. جستجوی پانل سمت راست نمایشگر.

نتایج

همه پُرسمان‌ها نتایج جدول‌بندی‌شده را برمی‌گردانند که در نمای پیمایشی با رفتار تعاملی مشابه با نمایشگرهای ردیابی مبتنی بر گزارش، مانند «تراکنش‌ها» و ProtoLog، نشان داده می‌شود:

شکل ۳. نتایج جستجوی بیننده.

اگر جدول حاصل حاوی ستون ts باشد، مقادیر آن ستون به‌عنوان مُهر زمان تفسیر می‌شوند و به‌عنوان ردیف جدیدی از ورودی‌ها به رونهاد خط زمان اضافه می‌شوند. روی این ردیف کلیک کنید و از کلیدهای راست‌بر و چپ‌بر برای پیمایش بین ورودی‌ها استفاده کنید:

شکل ۴. جستجوی خط زمان.