Как собирать трассировки с помощью Winscope

Запустите Winscope локально или получите доступ к нему с веб-сервера.

Вы можете записывать трассировки с помощью Winscope для локальной разработки и отладки. Winscope использует adb, который поддерживает подключение устройств через USB или Wi-Fi.

При запуске Winscope появляется экран Collect Traces (Сбор трассировок).

Подключение к устройству

Вы можете подключить устройства в Winscope, используя прокси-сервер Winscope или прокси-сервер веб-устройства. По умолчанию на главной странице Winscope показывается интерфейс настройки подключения Winscope Proxy.

Чтобы начать запись трассировок, выберите один из следующих способов подключения устройства.

Настройка прокси-сервера Winscope

Чтобы настроить Winscope Proxy, выполните следующие действия:

  1. В разделе Collect Traces (Сбор трассировок) на главной странице выберите Winscope Proxy (Прокси-сервер Winscope) в меню Select connection type (Выберите тип подключения):

    Как собирать трассировки с помощью Winscope Proxy

    Рисунок 1. Собирать трассировки с помощью Winscope Proxy.

  2. Запустите прокси-сервер Winscope ADB Connect, чтобы записывать трассировки прямо из браузера. Для этого выполните следующую команду:

    python3 $ANDROID_BUILD_TOP/development/tools/winscope/src/adb/winscope_proxy.py
    
  3. Запишите токен прокси-сервера Winscope, который появится в терминале после выполнения команды.

  4. После запуска прокси-сервера Winscope ADB Connect экран изменится следующим образом: Чтобы установить первоначальное подключение к прокси-серверу, введите токен прокси-сервера Winscope, полученный на шаге 3, и нажмите Подключиться.

    Подключиться к прокси-серверу Winscope

    Рисунок 2. Подключитесь к прокси-серверу Winscope.

Настройка прокси-сервера веб-устройства

Чтобы настроить прокси-сервер для веб-устройств, выполните следующие действия:

  1. В разделе Collect Traces (Сбор трассировок) на главной странице выберите Web Device Proxy (Прокси-сервер веб-устройства) в меню Select connection type (Выберите тип подключения):

    Как собирать трассировки с помощью Web Device Proxy

    Рисунок 3. Захватывайте трассировки с помощью прокси-сервера веб-устройства.

  2. Если на вашем компьютере нет демона Web Device Proxy, нажмите Установить или запустите установщик.

  3. В диалоговом окне разрешите источнику доступ к прокси-серверу веб-устройства.

    Как предоставить источнику доступ к WDP

    Рисунок 4. Авторизуйте источник.

  4. При первом подключении к каждому новому устройству нужно будет предоставить доступ. Если диалоговое окно не открылось автоматически, нажмите на значок lock_open рядом с устройством.

    wdp_unauth_device

    Рисунок 5. Авторизуйте устройство.

Дорожки

Чтобы собрать трассировки, выполните следующие действия:

  1. После подключения выберите цели и задайте настройки, чтобы начать процесс сбора данных. Затем нажмите Начать трассировку, чтобы начать запись:

    Как собирать трассировки в Winscope

    Рисунок 6. Соберите трассировки в Winscope.

  2. Чтобы остановить запись, нажмите Завершить трассировку:

    Как завершить трассировку в Winscope

    Рисунок 7. Завершите трассировку в Winscope.

Параметры трассировки

В этом разделе описаны варианты для каждого типа трассировки.

Запись видео с экрана

С помощью Winscope можно записывать экран нескольких дисплеев. Выберите дисплей из меню для записи видео с экрана. Если вы не выберете их, по умолчанию будет записан активный дисплей.

SurfaceFlinger

  • Размер буфера. Настройка размера кольцевого буфера в памяти для трассировки SurfaceFlinger. Чем больше буфер, тем больше данных можно собрать, но при этом увеличивается использование памяти.

  • Входные данные. Если поверхность содержит входные данные, отслеживает особенности окна ввода.

  • Композиция. Тип композиции и видимая область.

  • Метаданные. Отслеживает дополнительные метаданные поверхности, в том числе внеэкранные слои.

  • HWC. Отслеживает дополнительные неструктурированные метаданные Hardware Composer.

  • Буферы трассировки. Настраивает SurfaceFlinger для отслеживания всех изменений буфера на поверхности. По умолчанию SurfaceFlinger отслеживает новое состояние только при изменении геометрии.

  • Виртуальные дисплеи. Включает в трассировку слои виртуальных дисплеев.

WindowManager

  • Размер буфера. Позволяет настроить размер кольцевого буфера в памяти для трассировки Менеджера окон. Чем больше буфер, тем больше данных можно собрать, но при этом увеличивается использование памяти.
  • Тип трассировки. Определяет частоту сбора данных о состоянии:

    • frame. В этом режиме WindowManager сохраняет одно состояние на кадр, чтобы фиксировались только действительные состояния. Этот режим имеет наименьшие накладные расходы на производительность.
    • transaction: в этом режиме состояние WindowManager записывается при каждой фиксации транзакции. Вы можете зафиксировать несколько транзакций в одном кадре, что позволяет отлаживать промежуточные состояния WindowManager во время кадра. Однако в этом режиме производительность ниже, чем в режиме кадров.
  • Уровень трассировки. Определяет уровень детализации трассировки WindowManager:

    • verbose: включает все окна и информацию о конфигурации для каждого окна. Этот режим требует больше всего памяти и ресурсов.
    • debug: включает информацию обо всех окнах, но регистрирует только конфигурацию окна, если она содержит запрошенную конфигурацию переопределения.
    • critical – содержит ту же информацию, что и режим отладки, но только для видимых окон. Этот режим требует меньше всего памяти и ресурсов.

Дампы

Чтобы создать дамп состояния с помощью Winscope, на главной странице в разделе Collect Traces (Сбор трассировок) выберите вкладку Dump (Дамп) и нажмите Dump state (Дамп состояния).

Как создать дамп состояния в Winscope

Рисунок 8. Сохранение состояния в Winscope.

Настройка скриншотов

Winscope позволяет делать снимки экрана для нескольких дисплеев. Выберите дисплей, скриншот которого нужно сделать. Если ничего не выбрано, будет сделан скриншот активного экрана.