Guía de inicio rápido del Inspector de GPU para Android

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:

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:

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.

  1. Conecta el dispositivo Android a la computadora con un cable USB.

  2. 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 carpeta HOME. Si ya lo hiciste, puedes omitir este paso.

    Pantalla de bienvenida
    Figura 1: Pantalla de bienvenida
  3. 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.

  4. Haz clic en Comenzar para mostrar la pantalla de inicio.

    Pantalla de inicio de AGI
    Figura 2: Pantalla de inicio principal del Inspector de GPU de Android.
  5. 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.

    Cómo capturar un diálogo de seguimiento nuevo
    Figura 3: Diálogo "Capture a New Trace"
  6. 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.

  7. 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:

    1. 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.

    2. En el cuadro de texto Filtro, escribe gapid para mostrar solo las aplicaciones que contengan gapid en el nombre del paquete.

    3. 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.

  8. En la sección Application, deja los otros campos vacíos.

  9. 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:

  1. En la pantalla de inicio de AGI, haz clic en Capture a new trace para mostrar el diálogo Capture System Profile.

  2. En la lista Type, selecciona System profile.

  3. En la sección Inicio y duración, configura Inicio a la(s) en Manual y Duración en 2.

  4. En la sección Trace Options, haz clic en Configure. Se mostrará una lista de opciones de generación de perfiles.

    Diálogo de captura de configuración
    Figura 4: Las opciones de generación de perfiles del diálogo Capture System Profile.
  5. Selecciona los datos de generación de perfiles que quieras capturar.

  6. En la sección GPU, haz clic en Seleccionar.

    Aparecerá una lista de contadores para seleccionar.

    Configuración del contador
    Figura 5: Selección de contadores
  7. Haz clic en default para seleccionar el conjunto de contadores predeterminados y en OK para mostrar las opciones de generación de perfiles.

  8. Haz clic en OK para volver al diálogo principal Capture System Profile.

  9. 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.

  10. Haz clic en OK. Esto inicia la app seleccionada en el dispositivo Android y muestra una ventana emergente con el botón Start.

  11. 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.

  12. Haz clic en Abrir seguimiento. La vista inicial que se muestra es similar a systrace.

    Seguimiento del perfil del sistema
    Figura 6: IU del Generador de perfiles del sistema.

    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:

  1. 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.

  2. 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.

  3. 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ó.

  4. 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.

  5. Opcional: Algunas apps generan un proceso diferente que realiza todo el procesamiento de gráficos. Para capturar ese proceso, especifica el nombre.

  6. Haz clic en OK. Esto inicia la app en el dispositivo Android y muestra una ventana emergente con el botón Start.

  7. Haz clic en el botón Start y espera unos segundos para que se complete la generación de perfiles.

  8. 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.