WindowManager

WindowManager 转储提供了特定时间的 WindowManager 快照。WindowManager 跟踪记录具有按时间顺序排列的状态，以便提供有价值的信息，让用户了解窗口为何显示在屏幕上、窗口配置、activity、任务、显示或 WindowManager 层次结构中的任何其他元素。这些信息对于排查问题（例如“为什么我的应用不可见”或“我在应用之间切换时遇到闪烁问题”）非常有用。

Winscope 的 WindowManager 查看器会针对跟踪记录和转储显示此信息。

如需详细了解跟踪记录收集，请参阅 WindowManager。

windowmanager

图 1. WindowManager 跟踪记录分析。

屏幕左侧显示的是窗口的 3D 视图。矩形视图会考虑窗口边界、Z 轴顺序和不透明度。

该标签页的中心部分显示窗口层次结构。除了窗口、activity 和任务之间的父子关系之外，此视图还包含以下信息：

  • V：标识可见窗口。

屏幕右侧显示所有可用属性的 Proto 转储。如需详细了解 proto 转储部分的内容，请参阅属性。

@IntDef 转换

@IntDef 转换是 WindowManager 属性面板的关键属性。@IntDef 表示带注解的整数类型元素代表逻辑类型，并且其值必须是明确命名的常量之一。我们在 Android 代码库中使用 @IntDef 而不是枚举来缓解内存和性能影响。

以下示例展示了 @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;

标志存储为整数，而不是使用人类可读的值，这可能会很难解读。Winscope 会使用 @IntDef 定义将这些标志转换为人类可读的值。在编译期间，Winscope 会收集一个 @IntDef 值字典，并使用此列表在运行时将 @IntDef 实例解码为人类可读的格式。例如，activityType 为 2 的 activity 会转换为 activityType 为 ACTIVITY_TYPE_HOME。同样，具有 flags=2173763840 的窗口在 Winscope 中会转换为：

flags=FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS | FLAG_HARDWARE_ACCELERATED | FLAG_SPLIT_TOUCH | FLAG_SHOW_WALLPAPER | FLAG_LAYOUT_INSET_DECOR | FLAG_LAYOUT_IN_SCREEN

如果 Winscope 无法正确转换 @IntDef 实例，请按照更新 @IntDef 映射中的步骤更新 Winscope 已知的 @IntDef 实例列表。