En este tema, se describe cómo realizar la generación de perfiles del sistema y la generación de perfiles de fotogramas en tu app para Android con el Inspector de GPU de Android (AGI).
Esta guía de inicio rápido está dirigida a los desarrolladores familiarizados con el desarrollo de gráficos en Android.
Requisitos de la computadora
La computadora que ejecute AGI debe cumplir con estos requisitos:
Se requiere uno de los siguientes sistemas operativos:
Windows: Windows 7 o versiones posteriores.
macOS: El Capitan (10.11) o una versión posterior
Linux: Se requiere el JDK de Java de 64 bits o JRE 8 (o posterior). Se recomienda usar Ubuntu Trusty Tahr (14.04 o versiones posteriores).
Descarga e instala AGI
Descarga e instala AGI para tu sistema operativo.
Requisitos de las apps para Android
En esta sección, se describen los requisitos de la app para Android de la que se genera el perfil:
Tu app para Android debe ser depurable. El atributo depurable en el manifiesto de Android de la app debe estar configurado en
true
. Este atributo habilita la instrumentación adecuada desde el controlador de gráficos. En el caso de las aplicaciones de Vulkan, este atributo permite que AGI agregue su propia capa de Vulkan cuando se inicia la aplicación.<application [...] android:debuggable="true">
Si tu app usa Vulkan de forma nativa, AGI también requiere lo siguiente:
Tu app debe tener habilitadas las capas de validación de Vulkan. Si no están habilitadas, puedes ejecutar los siguientes comandos para forzar la ejecución de tu app con las capas de validación que se incluyen en el APK de AGI (
com.google.android.gapid.<abi>
):app_package=<YOUR APP PACKAGE NAME HERE> abi=arm64v8a # Possible values: arm64v8a, armeabi-v7a, x86 adb shell settings put global enable_gpu_debug_layers 1 adb shell settings put global gpu_debug_app ${app_package} adb shell settings put global gpu_debug_layer_app com.google.android.gapid.${abi} adb shell settings put global gpu_debug_layers VK_LAYER_KHRONOS_validation
Cuando termines de generar perfiles, puedes inhabilitar estas capas de validación con los siguientes comandos:
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
Tu app no debe informar advertencias ni errores cuando se ejecuta con las capas de validación de Vulkan habilitadas. Se corrigió cualquier error de validación de Vulkan antes de la generación de perfiles
Si usas controladores de GPU beta, incluye los siguientes metadatos en la etiqueta
<application>
del manifiesto de Android:<meta-data android:name="com.android.graphics.developerdriver.enable" android:value="true" />
Requisitos de los dispositivos Android
AGI tiene los siguientes requisitos para dispositivos Android:
Un dispositivo Android compatible que ejecute Android 11 o una versión posterior
Un cable USB.
La depuración de adb debe estar habilitada y se debe poder acceder al dispositivo mediante adb. Si está la opción Instalar a través de USB, habilítala.
Validación de dispositivos
AGI requiere un controlador de GPU compatible. Para garantizar que proporcione datos de generación de perfiles válidos, AGI ejecuta una verificación de validación la primera vez que conectas un dispositivo nuevo, que tarda alrededor de diez segundos. Después de pasar la verificación, puedes usar el dispositivo para generar perfiles de las apps para Android.
No interrumpir el dispositivo mientras la validación esté en curso. Esto puede provocar que el dispositivo falle en la validación. Si un dispositivo no pasa la validación, pero está configurado correctamente, puedes reintentar la validación. Para ello, vuelve a seleccionar el dispositivo.
La validación es un paso único para un dispositivo, y los resultados se almacenan en caché para usar AGI en el futuro. Sin embargo, AGI volverá a ejecutar la validación si cambia la configuración del dispositivo, por ejemplo, si se actualizan el controlador de GPU o la versión de Android.
Si un dispositivo aparece como compatible, es posible que AGI apruebe la validación. Si el dispositivo no aparece en la lista, es probable que su controlador de GPU no sea compatible con AGI.
Si tu dispositivo es compatible, pero no pasa la validación
Asegúrate de cumplir con todos los requisitos de Android y los requisitos de la computadora que se describen en las secciones anteriores, y de que el dispositivo esté conectado correctamente a la computadora con un cable USB.
Si se cumplen todos los requisitos, informa un problema en nuestro repositorio de GitHub y describa el comportamiento.
Si tu dispositivo no es compatible
Estamos trabajando con nuestros socios OEM para agregar compatibilidad con más dispositivos. Puedes informar un problema en nuestro repositorio de GitHub a fin de solicitar asistencia para un dispositivo.
Cómo capturar datos de generación de perfiles
En las siguientes secciones, se describe cómo capturar datos de generación de perfiles y abrir el archivo de registro resultante para analizar los resultados.
Establece la configuración de Android
Antes de comenzar la generación de perfiles, debes establecer la configuración del dispositivo y la app para Android, que especifica la app y el dispositivo de los que se va a generar el perfil.
Conecta el dispositivo Android a la computadora con un cable USB.
Inicia AGI en tu computadora.
La primera vez que inicies AGI, aparecerá la pantalla de Bienvenida, que te solicitará la ruta de acceso al ejecutable de adb. AGI guarda esta configuración en el archivo
.agic
de tu carpetaHOME
. Si ya lo hiciste, puedes omitir este paso.Ingresa la ruta de acceso al ejecutable de adb en el campo Path to adb. Las casillas de verificación que aparecen después de este campo son opcionales.
Haz clic en Comenzar para mostrar la pantalla de inicio.
En la pantalla de inicio, haz clic en Capture a new trace. Se mostrará el diálogo Capture A New Trace. También puedes hacer clic en el botón Capture System Profile trace.
En la sección Dispositivo y tipo, selecciona el dispositivo Android del que quieras generar el perfil. Si no aparece en la lista Dispositivo, haz clic en la flecha de volver a cargar para actualizar la lista.
En la sección Application, selecciona la app de la que quieras generar perfiles. Si solo hay una actividad en el paquete, puedes seleccionar el paquete en lugar de la actividad.
AGI incluye una app de Vulkan de ejemplo. Para usar la app de ejemplo en lugar de la tuya, sigue estos pasos:
Haz clic en el botón ... junto al campo Application.
Se mostrará el diálogo Select an Application to Trace, que incluye una lista de apps que se pueden rastrear en el dispositivo seleccionado.
En el cuadro de texto Filtro, escribe
gapid
para mostrar solo las aplicaciones que contengangapid
en el nombre del paquete.Expande el paquete, selecciona com.google.android.gapid.VkSampleActivity y haz clic en OK.
Esta acción te regresará al diálogo Capture A New Trace, con el campo Application propagado por la app que seleccionaste.
En la sección Application, deja los otros campos vacíos.
Haz clic en OK.
Ya está todo listo para usar AGI a fin de realizar perfiles de sistemas y fotogramas.
Cómo generar perfiles de un sistema
Para generar el perfil de un sistema, sigue estos pasos:
En la pantalla de inicio de AGI, haz clic en Capture a new trace para mostrar el diálogo Capture System Profile.
En la lista Type, selecciona System profile.
En la sección Inicio y duración, configura Inicio a la(s) en Manual y Duración en
2
.En la sección Trace Options, haz clic en Configure. Se mostrará una lista de opciones de generación de perfiles.
Selecciona los datos de generación de perfiles que quieras capturar.
En la sección GPU, haz clic en Seleccionar.
Aparecerá una lista de contadores para seleccionar.
Haz clic en default para seleccionar el conjunto de contadores predeterminados y en OK para mostrar las opciones de generación de perfiles.
Haz clic en OK para volver al diálogo principal Capture System Profile.
En la sección Output, selecciona un Output Directory para almacenar los archivos de registro que se generan durante la generación de perfiles. El campo File Name debe completarse automáticamente, pero también puedes editarlo.
Haz clic en OK. Esto inicia la app seleccionada en el dispositivo Android y muestra una ventana emergente con el botón Start.
Haz clic en el botón Start para comenzar a capturar datos de generación de perfiles y espera unos segundos a que finalice el proceso.
Haz clic en Abrir seguimiento. La vista inicial que se muestra es similar a systrace.
Además de los datos disponibles en Systrace, AGI también muestra información de rendimiento de la GPU. Para obtener más información sobre la visualización de los datos de generación de perfiles del sistema, consulta Cómo ver un perfil del sistema AGI.
Para obtener información sobre parámetros de configuración adicionales, consulta las opciones de generación de perfiles del sistema.
Cómo generar un perfil de un marco
Para generar el perfil de un fotograma individual desde tu app, sigue estos pasos:
En la pantalla de inicio de AGI, haz clic en Capture a new trace para mostrar el diálogo Capture A New Trace. También puedes hacer clic en el botón Capture Frame Profile trace.
En la lista Type, selecciona Vulkan o OpenGL on ANGLE según la API de gráficos que use tu app. Asegúrate de elegir la correcta. De lo contrario, AGI no capturará ningún comando gráfico.
En la sección Inicio y duración, configura Inicio a la(s) en Manual. Si hiciste clic en el botón Capture Frame Profile trace, este paso ya se completó.
En la sección Salida, selecciona un Directorio de salida para almacenar los archivos de seguimiento. El campo File Name se debería completar automáticamente, pero también puedes editarlo.
Opcional: Algunas apps generan un proceso diferente que realiza todo el procesamiento de gráficos. Para capturar ese proceso, especifica el nombre.
Haz clic en OK. Esto inicia la app en el dispositivo Android y muestra una ventana emergente con el botón Start.
Haz clic en el botón Start y espera unos segundos para que se complete la generación de perfiles.
Haz clic en Open Trace (Abrir seguimiento) para ver los datos de la generación de perfiles. Para obtener información sobre cada panel de la IU del Generador de perfiles de fotogramas, consulta la descripción general de la generación de perfiles de fotogramas.
Para obtener información sobre configuraciones adicionales, consulta las opciones de generación de perfiles de fotogramas.