Запустите Winscope локально или получите доступ к нему с веб-сервера.
Вы можете записывать трассировки с помощью Winscope для локальной разработки и отладки. Winscope использует adb, который поддерживает подключение устройств через USB или Wi-Fi.
При запуске Winscope появляется экран Collect Traces (Сбор трассировок).
Подключение к устройству
Вы можете подключить устройства в Winscope, используя прокси-сервер Winscope или прокси-сервер веб-устройства. По умолчанию на главной странице Winscope показывается интерфейс настройки подключения Winscope Proxy.
Чтобы начать запись трассировок, выберите один из следующих способов подключения устройства.
Настройка прокси-сервера Winscope
Чтобы настроить Winscope Proxy, выполните следующие действия:
В разделе Collect Traces (Сбор трассировок) на главной странице выберите Winscope Proxy (Прокси-сервер Winscope) в меню Select connection type (Выберите тип подключения):
Рисунок 1. Собирать трассировки с помощью Winscope Proxy.
Запустите прокси-сервер Winscope ADB Connect, чтобы записывать трассировки прямо из браузера. Для этого выполните следующую команду:
python3 $ANDROID_BUILD_TOP/development/tools/winscope/src/adb/winscope_proxy.pyЗапишите токен прокси-сервера Winscope, который появится в терминале после выполнения команды.
После запуска прокси-сервера Winscope ADB Connect экран изменится следующим образом: Чтобы установить первоначальное подключение к прокси-серверу, введите токен прокси-сервера Winscope, полученный на шаге 3, и нажмите Подключиться.
Рисунок 2. Подключитесь к прокси-серверу Winscope.
Настройка прокси-сервера веб-устройства
Чтобы настроить прокси-сервер для веб-устройств, выполните следующие действия:
В разделе Collect Traces (Сбор трассировок) на главной странице выберите Web Device Proxy (Прокси-сервер веб-устройства) в меню Select connection type (Выберите тип подключения):
Рисунок 3. Захватывайте трассировки с помощью прокси-сервера веб-устройства.
Если на вашем компьютере нет демона Web Device Proxy, нажмите Установить или запустите установщик.
В диалоговом окне разрешите источнику доступ к прокси-серверу веб-устройства.
Рисунок 4. Авторизуйте источник.
При первом подключении к каждому новому устройству нужно будет предоставить доступ. Если диалоговое окно не открылось автоматически, нажмите на значок
lock_openрядом с устройством.
Рисунок 5. Авторизуйте устройство.
Дорожки
Чтобы собрать трассировки, выполните следующие действия:
После подключения выберите цели и задайте настройки, чтобы начать процесс сбора данных. Затем нажмите Начать трассировку, чтобы начать запись:
Рисунок 6. Соберите трассировки в 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 (Дамп состояния).
Рисунок 8. Сохранение состояния в Winscope.
Настройка скриншотов
Winscope позволяет делать снимки экрана для нескольких дисплеев. Выберите дисплей, скриншот которого нужно сделать. Если ничего не выбрано, будет сделан скриншот активного экрана.