孤舟蓑笠翁，独钓寒江雪

Android实用技巧之adb命令：dumpsys命令的使用

发表于 | 分类于 | | 阅读次数
介绍dumpsys的使用

dumpsys概述

Android提供的dumpsys工具可以用于查看手机中的应用程序和系统服务信息与状态，能够熟练使用dumpsys工具以及对它的输出内容进行理解是Android开发人员的必备技能，使用它我们不仅能够对方便的获取一些当前的平台的一些信息，而且能够对Android性能优化、Bug分析与调试带来很大的帮助。
手机连接电脑后可以直接命令行执行adb shell dumpsy查看所有支持的Service，但是这样输出的太多，可以通过adb shell dumpsys -l 或者 dumpsys | grep "DUMP OF SERVICE" 仅显示主要的Service的信息。
adb shell dumpsys -h可以查看帮助信息。
关于这个命令的使用方法在这里做一下记录，以备使用。
关于adb shell dumpsy 命令的源码分析请参考我的博客Android 深入理解 dumpsys 。

dumpsys支持的所有命令

输入：

1
adb shell dumpsys -l

可以查看当前支持的所有系统服务列表：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
DockObserver
GuiExtService
SurfaceFlinger
access_control
accessibility
account
activity
......
meminfo
mount
move_window
netpolicy
netstats
network_management
network_score
networkmanagement_service_flyme
notification
package
permission
persistent_data_block
power
pppoe
......
trust
uimode
updatelock
usagestats
usb
user
vibrator
voiceinteraction
wallpaper
webviewupdate
wifi
wifip2p
wifiscanner
window

输入 adb shell dumpsys 命令可以输出所有的系统服务信息。

具体命令如何查看帮助

从上面可以看出可以查看的Service非常多，adb shell dumpsys -l所列举的服务都可以直接通过 dumpsys + <service> 查看相关信息，具体每一个如何使用有一种通用的查看帮助的办法。
查看每一个命令的使用帮助，以下以activity为例演示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
$ adb shell dumpsys activity -h

Activity manager dump options:
  [-a] [-c] [-h] [cmd] ...
  cmd may be one of:
    a[ctivities]: activity stack state
    b[roadcasts] [PACKAGE_NAME] [history [-s]]: broadcast state
    i[ntents] [PACKAGE_NAME]: pending intent state
    p[rocesses] [PACKAGE_NAME]: process state
    o[om]: out of memory management
    prov[iders] [COMP_SPEC ...]: content provider state
    provider [COMP_SPEC]: provider client-side state
    s[ervices] [COMP_SPEC ...]: service state
    service [COMP_SPEC]: service client-side state
    package [PACKAGE_NAME]: all state related to given package
    all: dump all activities
    top: dump the top activity
  cmd may also be a COMP_SPEC to dump activities.
  COMP_SPEC may be a component name (com.foo/.myApp),
    a partial substring in a component name, a
    hex object identifier.
  -a: include all available server state.
  -c: include client state.

这样就可以清楚每个命名的使用方法以及对应输出内容的信息查看方法。
以window为例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
$ adb shell dumpsys window -h

Window manager dump options:
  [-a] [-h] [cmd] ...
  cmd may be one of:
    i[input]: input subsystem state
    p[policy]: policy state
    s[essions]: active sessions
    surfaces: active surfaces (debugging enabled only)
    d[isplays]: active display contents
    t[okens]: token list
    w[indows]: window list
  cmd may also be a NAME to dump windows.  NAME may
    be a partial substring in a window name, a
    Window hex object identifier, or
    "all" for all windows, or
    "visible" for the visible windows.
  -a: include all available server state.
  -d list                     list the all of debug zones
  -d enable  <zone zone ...>  enable the debug zone
  -d disable <zone zone ...>  disable the debug zone
  zone usage : 
    0  : DEBUG
    1  : DEBUG_FOCUS
    2  : DEBUG_ANIM
    3  : DEBUG_LAYOUT
    4  : DEBUG_RESIZE
    5  : DEBUG_LAYERS
    6  : DEBUG_INPUT
    7  : DEBUG_INPUT_METHOD
    8  : DEBUG_VISIBILITY
    9  : DEBUG_WINDOW_MOVEMENT
    10 : DEBUG_ORIENTATION
    11 : DEBUG_CONFIGURATION
    12 : DEBUG_APP_TRANSITIONS
    13 : DEBUG_STARTING_WINDOW
    14 : DEBUG_REORDER
    15 : DEBUG_WALLPAPER
    16 : DEBUG_WALLPAPER_LIGHT
    17 : SHOW_TRANSCATIONS
    18 : HIDE_STACK_CRAWLS
    19 : PROFILE_ORIENTATION
    20 : DEBUG_TASK_MOVEMENT
    21 : DEBUG_ADD_REMOVE
    22 : DEBUG_TOKEN_MOVEMENT
    23 : DEBUG_APP_ORIENTATION
    24 : DEBUG_DRAG
    25 : DEBUG_SCREEN_ON
    26 : DEBUG_SCREENSHOT
    27 : DEBUG_BOOT
    28 : SHOW_SURFACE_ALLOC
    29 : SHOW_LIGHT_TRANSACTIONS
    30 : DEBUG_LAYOUT_REPEATS
    31 : DEBUG_SURFACE_TRACE
    32 : DEBUG_WINDOW_TRACE
    33 : DEBUG_WINDOW
    34 : DEBUG_STACK
    35 : DEBUG_DIM_LAYER
    36 : DEBUG_KEYGUARD

比如adb shell dumpsys window -d enable 10就是打开DEBUG_ORIENTATION，这样就把代码中的关于屏幕方向旋转相关的Log打印出来。

一些常用命令解释

adb shell dumpsys meminfo

adb shell dumpsys meminfo 可以查看所有进程的状态以及内存使用情况。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
Total PSS by process:
    202,378K: system (pid 4445)
    179,488K: com.android.systemui (pid 7652)
    173,235K: com.tencent.mobileqq (pid 16677)
    105,190K: com.meizu.flyme.launcher (pid 15816 / activities)
     ......

Total PSS by OOM adjustment:
    327,674K: Native
         50,669K: cp_diskserver (pid 4442)
         13,723K: zygote64 (pid 3810)
         13,075K: zygote (pid 3811)
          ......
    202,378K: System
        202,378K: system (pid 4445)
    526,574K: Persistent
        179,488K: com.android.systemui (pid 7652)
         88,026K: com.meizu.alphame (pid 9146)
         58,639K: com.android.phone (pid 7783)
         ......
    166,859K: Foreground
        105,190K: com.meizu.flyme.launcher (pid 15816 / activities)
         61,669K: com.meizu.pps (pid 11982)
     80,402K: Visible
         20,963K: com.meizu.location (pid 8966)
         20,503K: com.meizu.account (pid 10212)
         ......
     86,811K: Perceptible
         67,316K: com.sohu.inputmethod.sogou.meizu (pid 9464)
         11,960K: com.flyme.telecom.usagedata.service (pid 11673)
          7,535K: com.activate.activatephone (pid 10345)
    173,235K: A Services
        173,235K: com.tencent.mobileqq (pid 16677)
    237,936K: B Services
         79,993K: com.tencent.mobileqq:tool (pid 17459)
         63,700K: com.meizu.safe (pid 11857)
         ......
    449,036K: Cached
         88,853K: com.tencent.mobileqq:mini (pid 17116)
         88,717K: com.unisoc.mstore (pid 13017 / activities)
         72,290K: com.tencent.mobileqq:mini3 (pid 17315)
         36,305K: com.android.webview:sandboxed_process0:org.chromium.content.app.SandboxedProcessService0:0 (pid 17261)
         34,550K: com.meizu.connectivitysettings (pid 12548 / activities)
         29,053K: com.android.settings (pid 20980)
         ......

Total PSS by category:
    463,112K: Native
    279,133K: Dalvik
    274,881K: .dex mmap
    129,232K: .oat mmap
    129,077K: .so mmap
    126,178K: .apk mmap
     82,387K: .art mmap
     63,061K: Unknown
     46,392K: Dalvik Other
     42,611K: .jar mmap
     34,939K: Other mmap
      2,356K: Stack
      1,310K: .ttf mmap
        890K: Ashmem
        759K: Other dev
          4K: Cursor
          0K: Gfx dev
          0K: EGL mtrack
          0K: GL mtrack
          0K: Other mtrack

Total RAM: 5,863,228K (status normal)
 Free RAM: 3,291,536K (  449,036K cached pss + 2,783,596K cached kernel +    58,904K free)
 Used RAM: 2,650,829K (1,801,869K used pss +   848,960K kernel)
 Lost RAM:   339,034K
     ZRAM:   156,412K physical used for   606,720K in swap (3,635,196K total swap)
   Tuning: 256 (large 512), oom   483,840K, restore limit   107,520K (high-end-gfx)

meminfo $package_name or $pid 使用程序的包名或者进程id显示内存信息比如浏览器：adb shell dumpsys meminfo com.android.browser

adb shell dumpsys activity

用来显示ams的一些信息，包括任务栈，activity信息，进程信息等。

  • adb shell dumpsys activity -h：帮助
  • adb shell dumpsys activity <包名>：查看给定包名的activity信息，包括 View Hierarchy 等
  • adb shell dumpsys activity top：查看当前应用的 activity 信息
  • adb shell dumpsys activity a[ctivities]：只查看activity栈
  • adb shell dumpsys activity r[recents]：最近任务activity状态
  • adb shell dumpsys activity package <包名>：查看该进程的所有信息，包括：dumpsys activity settings,dumpsys activity allowed-associations,dumpsys activity intents,dumpsys activity broadcasts,dumpsys activity broadcast-stats,dumpsys activity providers,dumpsys activity services,dumpsys activity recents,dumpsys activity lastanr,dumpsys activity starter,dumpsys activity activities,dumpsys activity exit-info,dumpsys activity processes,dumpsys activity users等信息内容
  • adb shell dumpsys activity p[rocesses] <包名>：查看该包名的进程状态，包括进程间依赖等

所有上面的命令还可以添加下面的参数来定制输出结果：

WHAT may also be a COMP_SPEC to dump activities.
COMP_SPEC may be a component name (com.foo/.myApp),
a partial substring in a component name, a
hex object identifier.
-a: include all available server state.
-c: include client state.
-p: limit output to given package.
–checkin: output checkin format, resetting data.
–C: output checkin format, not resetting data.
–proto: output dump in protocol buffer format.
–autofill: dump just the autofill-related state of an activity

其他

  • adb shell dumpsys SurfaceFlinger： 查看UI绘制的各个层级信息
  • adb shell dumpsys window： 显示键盘，窗口和它们的关系
  • adb shell dumpsys package <包名>： 查看该包的具体信息
  • adb shell dumpsys statusbar： 显示状态栏相关信息
  • adb shell dumpsys usagestats： 每个应用的启动次数和时间
  • adb shell dumpsys battery： 电池信息
  • adb shell dumpsys diskstats： 磁盘相关信息
  • adb shell dumpsys alarm： 显示Alarm信息
  • adb shell dumpsys wifi： 显示wifi信息
  • adb shell dumpsys user：查看当前的用户情况
  • adb shell dumpsys dbinfo <包名>：查看指定包名应用的数据库存储信息（包括存储的SQL语句）
  • adb shell dumpsys settings：可以查看settingsProvider里面的所有设置项以及最近修改过的设置项。用这个命令来查看设置中的设置项的字段名称非常快捷，设置中修改一下然后执行命令。或者对比一下两次的操作结果。
  • adb shell dumpsys notification： 查看通知的信息

参考资料

http://www.open-open.com/lib/view/open1405061994872.html
https://source.android.com/devices/tech/input/dumpsys.html