Android层级分布

adb shell dumpsys window w 命令输出内容解读指南

adb shell dumpsys window w 实际上是 adb shell dumpsys window windows 的简写形式(w 是 windows 的缩写)。这个命令会输出设备上所有窗口的详细信息,是调试窗口相关问题的利器。

📌 命令输出的典型结构

执行命令后,你会看到类似这样的输出:

ini 复制代码
WINDOW MANAGER WINDOWS (dumpsys window windows)
  Window #11: com.example.app/.MainActivity (u0)
    mDisplayId=0 mSession=Session{e6589e5 12345:u0a123}
    mOwnerUid=10123 mPackage= com.example.app
    mAppToken=AppWindowToken{12345 token=Token{12345 ActivityRecord{12345 u0 com.example.app/.MainActivity t12345}}}
    mAttrs=WM.LayoutParams{(0,0)(fillxfill)m=WM.LayoutParams{...}}
    mLayer=10000 mBaseLayer=10000
    mFrame=Rect(0,0 - 1080,1920)
    mSurface=Surface(name=com.example.app/com.example.app.MainActivity)
    mDrawState=HAS_DRAWN
    mShowing=true
    mSurfaceShown=true
    mSurface=Surface(name=com.example.app/com.example.app.MainActivity)
    mVisible=true
    mCurrentFocus=Window{12345 u0 com.example.app/.MainActivity}
    mFocusedApp=AppWindowToken{12345 token=Token{12345 ActivityRecord{12345 u0 com.example.app/.MainActivity t12345}}}

🔍 逐项解读

1. 窗口标识信息

bash 复制代码
Window #11: com.example.app/.MainActivity (u0)
  • #11:窗口的序号
  • com.example.app/.MainActivity:窗口所属的应用包名和Activity类
  • (u0):用户ID(通常为0表示主用户)

2. 窗口基础信息

ini 复制代码
mDisplayId=0 mSession=Session{e6589e5 12345:u0a123}
  • mDisplayId=0:显示ID(0表示主屏幕)
  • mSession:会话ID,标识窗口所属的会话

3. 窗口属性

ini 复制代码
mAttrs=WM.LayoutParams{(0,0)(fillxfill)m=WM.LayoutParams{...}}
  • 窗口的布局参数,包括位置(0,0)、尺寸(fillxfill)等

4. 窗口层级

ini 复制代码
mLayer=10000 mBaseLayer=10000
  • mLayer:窗口的层级(值越大,越在上层)
  • mBaseLayer:窗口的基础层级

5. 窗口尺寸

ini 复制代码
mFrame=Rect(0,0 - 1080,1920)
  • 窗口的矩形区域(左上角坐标(0,0)到右下角坐标(1080,1920))

6. 窗口状态

ini 复制代码
mDrawState=HAS_DRAWN
mSurfaceShown=true
mVisible=true
  • mDrawState:窗口绘制状态
    • HAS_DRAWN:窗口已绘制(是显示状态的必要条件)
    • NOT_DRAWN:窗口未绘制
  • mSurfaceShown:表面是否可见(true表示可见)
  • mVisible:窗口是否可见(true表示可见)

7. 焦点信息(关键!)

ini 复制代码
mCurrentFocus=Window{12345 u0 com.example.app/.MainActivity}
mFocusedApp=AppWindowToken{12345 token=Token{12345 ActivityRecord{12345 u0 com.example.app/.MainActivity t12345}}}
  • mCurrentFocus:当前有焦点的窗口(可能是一个视图,不一定是Activity)
  • mFocusedApp:当前有焦点的应用(总是关联到一个ActivityRecord)

📌 重要区别:当焦点切换到没有Activity的视图(如系统UI部分)时,mCurrentFocus会显示该视图,但mFocusedApp仍显示上一个Activity。

8. 应用信息

ini 复制代码
mAppToken=AppWindowToken{12345 token=Token{12345 ActivityRecord{12345 u0 com.example.app/.MainActivity t12345}}}
  • mAppToken:应用窗口令牌,标识应用的窗口
  • t12345:任务ID,标识Activity所在的任务

💡 实用场景

1. 查找当前焦点Activity

bash 复制代码
adb shell dumpsys window windows | grep -E 'mCurrentFocus|mFocusedApp'

输出示例:

ini 复制代码
mCurrentFocus=Window{12345 u0 com.example.app/.MainActivity}
mFocusedApp=AppWindowToken{12345 token=Token{12345 ActivityRecord{12345 u0 com.example.app/.MainActivity t12345}}}

这表示当前有焦点的Activity是com.example.app/.MainActivity

2. 查看窗口层级关系

bash 复制代码
adb shell dumpsys window windows | grep -E 'mLayer|mDrawState'

通过比较mLayer值,可以知道哪个窗口在最上层

3. 检查窗口是否可见

bash 复制代码
adb shell dumpsys window windows | grep -E 'mSurfaceShown|mVisible'

如果mSurfaceShown=true且mVisible=true,则窗口可见

4. 检查刘海屏/显示区域

bash 复制代码
adb shell dumpsys window | grep -i cutout

输出示例:

ini 复制代码
DisplayCutout: (left=0, top=0, right=0, bottom=0) 

这表示没有刘海屏,如果显示有值,则表示有刘海屏区域

📝 总结

adb shell dumpsys window w 命令的输出包含了设备上所有窗口的详细信息,是调试窗口问题(如布局异常、焦点问题、层级问题)的关键工具。

重点看以下字段:

  • mCurrentFocus 和 mFocusedApp:判断当前焦点
  • mLayer:判断窗口层级
  • mDrawState 和 mSurfaceShown:判断窗口是否已绘制并可见
  • mFrame:窗口的尺寸和位置

在实际工作中,通常会配合grep命令来过滤关键信息,例如:

bash 复制代码
adb shell dumpsys window windows | grep -E 'mCurrentFocus|mFocusedApp|mLayer|mDrawState'

这样可以快速获取你关心的信息,避免被大量输出淹没。

希望这个解读对你有帮助!如果你有具体的输出内容需要解读,也可以提供出来,我可以帮你分析。

相关推荐
FungLeo4 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks4 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
booboosui12 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
雨白1 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m1 天前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui1 天前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149062 天前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭2 天前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1232 天前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c