Los volcados de WindowManager proporcionan una instantánea de WindowManager en un momento específico. Los seguimientos de WindowManager incluyen una secuencia cronológica de estados que proporcionan estadísticas valiosas sobre por qué aparece una ventana en la pantalla, su configuración o la de su actividad, tarea, pantalla o cualquier otro elemento de la jerarquía de WindowManager. Esta información es útil para solucionar problemas, como por qué no se ve mi app o experimenté parpadeos mientras cambiaba de app.
El visor de WindowManager de Winscope muestra esta información para los seguimientos y volcados.
Consulta WindowManager para obtener más información sobre la recopilación de seguimientos.
Figura 1: Análisis de seguimiento de WindowManager
El lado izquierdo de la pantalla muestra una vista en 3D de las ventanas. La vista de rectángulos considera los límites de la ventana, el orden en Z y la opacidad.
El segmento central de la pestaña muestra la jerarquía de ventanas. Además de las relaciones de jerarquía entre ventanas, actividades y tareas, esta vista también incluye la siguiente información:
- V: Identifica las ventanas visibles.
El lado derecho de la pantalla muestra un volcado de proto de todas las propiedades disponibles. Para obtener más información sobre las funciones de la sección de volcado de proto, consulta Propiedades.
Traducción de @IntDef
La traducción de @IntDef es una propiedad clave del panel de propiedades de WindowManager.
@IntDef indica que el elemento anotado de tipo entero representa un tipo lógico y que su valor debe ser una de las constantes con nombre explícito.
@IntDef se usa dentro de la base de código de Android en lugar de enums para mitigar el impacto en la memoria y el rendimiento.
El siguiente es un ejemplo del uso de @IntDef:
/**
* The modes to control how root task is moved to the front when calling {@link Task#reparent}.
*/
@Retention(RetentionPolicy.SOURCE)
@IntDef({
REPARENT_MOVE_ROOT_TASK_TO_FRONT,
REPARENT_KEEP_ROOT_TASK_AT_FRONT,
REPARENT_LEAVE_ROOT_TASK_IN_PLACE
})
@interface ReparentMoveRootTaskMode {}
// Moves the root task to the front if it was not at the front
static final int REPARENT_MOVE_ROOT_TASK_TO_FRONT = 0;
// Only moves the root task to the front if it was focused or frontmost already
static final int REPARENT_KEEP_ROOT_TASK_AT_FRONT = 1;
// Do not move the root task as a part of reparenting
static final int REPARENT_LEAVE_ROOT_TASK_IN_PLACE = 2;
Las marcas se almacenan como números enteros, en lugar de usar valores legibles por humanos, lo que puede ser difícil de interpretar. Winscope
transfiere estas marcas a valores legibles por humanos con definiciones de @IntDef.
Durante las compilaciones, Winscope recopila un diccionario de valores @IntDef y usa esta lista para decodificar instancias de @IntDef en un formato legible por humanos durante el tiempo de ejecución. Por ejemplo, una actividad con activityType de 2 se traduce a activityType de ACTIVITY_TYPE_HOME. De manera similar, una ventana con flags=2173763840 se traduce en Winscope de la siguiente manera:
flags=FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS | FLAG_HARDWARE_ACCELERATED |
FLAG_SPLIT_TOUCH | FLAG_SHOW_WALLPAPER | FLAG_LAYOUT_INSET_DECOR |
FLAG_LAYOUT_IN_SCREEN
Si Winscope no traduce correctamente una instancia de @IntDef, sigue los pasos que se indican en Cómo actualizar la asignación de @IntDef para actualizar la lista de instancias de @IntDef que conoce Winscope.