Устранение неполадок с AGI

В этой статье описывается, как устранять распространенные проблемы при использовании Android GPU Inspector (AGI) .

Сброс настроек AGI

AGI хранит свои настройки в файле ~/.agic. При удалении этого файла будут удалены все настройки AGI, включая список недавно открытых трассировок и результаты проверки устройств.

AGI не работает на некоторых устройствах

Убедитесь, что ваша система соответствует всем требованиям.

Также могут помочь следующие действия:

  • Остановите все программы, которые могут взаимодействовать с устройством через ADB, например Android Studio.

  • Включите параметр Stay awake (в разделе "Для разработчиков" на Android), чтобы предотвратить проблемы, возникающие при отключении экрана устройства в спящем режиме.

Системный профилировщик не сообщает о действиях графического процессора в играх с OpenGL ES

В настоящее время при трассировке приложения OpenGL ES поддерживаются только счетчики графического процессора. Информация о действиях графического процессора для приложений OpenGL ES находится в стадии активной разработки.

Профилировщик кадров не работает в некоторых играх с Vulkan

Прежде всего убедитесь, что в игре правильно используется Vulkan. Используйте уровень проверки Vulkan и убедитесь, что в игре не возникает ошибок или предупреждений.

Если есть ошибки проверки Vulkan, то профилировщик кадров AGI не будет работать.

Сбой игры при создании трассировки профилировщика кадров

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

Чтобы выявить эту проблему, вы можете проверить выходные данные logcat во время создания трассировки и проверить, запускается ли другой процесс:

# Clear the logcat output
adb logcat -c

## Use AGI to attempt to create a frame profile trace

Look at the logcat output to identify the processes that are running AGI. 

adb logcat | grep "this process name"
I GAPID   : gapii [gapii/cc/spy.cpp:109] this process name: com.example.mygame
I GAPID   : gapii [gapii/cc/spy.cpp:109] this process name: com.example.mygame:GameProcess

В большинстве игр есть только один процесс. В примере выше показано, как выглядит игра с несколькими процессами.

Игра запускается в основном процессе com.example.mygame, а затем создает новый процесс com.example.mygame:GameProcess. Если рендеринг игры происходит во втором процессе, укажите в AGI, что вы хотите отслеживать именно его. Для этого введите название процесса в поле Process name диалогового окна трассировки.

Сбой в игре после использования AGI

Если трассировка не завершается должным образом, AGI может оставить некоторые настройки Android в состоянии, которое может прервать последующие запуски приложения. К этим настройкам относятся:

  • Настройки, связанные со слоями Vulkan:

    • enable_gpu_debug_layers

    • gpu_debug_app

    • gpu_debug_layers

    • gpu_debug_layer_app

  • Настройки, связанные с ANGLE:

    • angle_debug_package

    • angle_gl_driver_selection_values

    • angle_gl_driver_selection_pkgs

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

# Vulkan layers
adb shell settings delete global enable_gpu_debug_layers
adb shell settings delete global gpu_debug_app
adb shell settings delete global gpu_debug_layers
adb shell settings delete global gpu_debug_layer_app
# ANGLE
adb shell settings delete global angle_debug_package
adb shell settings delete global angle_gl_driver_selection_values
adb shell settings delete global angle_gl_driver_selection_pkgs

При запуске игры через AGI во время создания трассировки профиля кадра она выглядит иначе

Чтобы создать трассировку профиля кадра, AGI перехватывает вызовы графического API, сделанные игрой, что может повлиять на рендеринг игры.

AGI записывает вызовы Vulkan. Для игр на базе OpenGL ES AGI использует ANGLE, чтобы преобразовать OpenGL ES в Vulkan. Если при запуске игры через AGI она выглядит иначе, чем обычно (например, некоторые цвета не соответствуют ожидаемым), вероятно, это ошибка в AGI или ANGLE. Вы можете помочь нам лучше понять основную причину проблемы, попробовав следующее.

Игры Vulkan: трассировка со всеми поддерживаемыми расширениями Vulkan

Параметр трассировки Include Unknown Extensions (Включить неизвестные расширения) определяет, должен ли AGI включать неподдерживаемые расширения Vulkan. Ознакомьтесь со списком поддерживаемых расширений.

Если ваше приложение использует расширение, которое не поддерживается AGI, вы можете столкнуться с нежелательным поведением, включая незначительные ошибки или сбои, при воспроизведении трассировки.

Попробуйте включить этот параметр, а затем запустите ещё одну трассировку профилировщика кадров. Если игра отображается правильно, когда этот параметр включен, возможно, она использует расширение Vulkan, которое не поддерживается AGI.

Игры OpenGL ES: запускать только с ANGLE

Вы можете запустить игру OpenGL ES с ANGLE, но без AGI, чтобы проверить, не связана ли проблема с рендерингом с ANGLE.

Если вы уже пытались создать трассировку профиля кадров для игры OpenGL ES, то AGI уже установил ANGLE на ваше устройство. Пакет ANGLE, используемый AGI, называется org.chromium.angle.agi.

Чтобы принудительно запустить игру на ANGLE, используйте следующие команды:

# Make sure that the AGI capture layer will be ignored
adb shell settings delete global enable_gpu_debug_layers
# Force the package com.example.mygame to use ANGLE
adb shell settings put global angle_debug_package org.chromium.angle.agi
adb shell settings put global angle_gl_driver_selection_values angle
adb shell settings put global angle_gl_driver_selection_pkgs com.example.mygame

Если после этого игра выглядит иначе, то, скорее всего, ошибка в ANGLE, а не в AGI. Если при таких настройках игра выглядит правильно, но при создании трассировки AGI – иначе, то, скорее всего, это ошибка в AGI.

Чтобы сообщить об ошибке в AGI, создайте запрос в GitHub.