dumpsys

dumpsys 是一种在 Android 设备上运行的工具,可提供有关系统服务的信息。您可以使用 Android 调试桥 (ADB) 从命令行调用 dumpsys,获取在连接的设备上运行的所有系统服务的诊断输出。此输出的内容通常比您想要的更多,因此您可以使用下文所述的命令行选项仅获取您感兴趣的系统服务的输出。本文还介绍了如何使用 dumpsys 完成常见的任务,例如检查输入、RAM、电池或网络诊断。

语法

使用 dumpsys 的一般语法如下:

     adb shell dumpsys [-t timeout] [--help | -l | --skip services | service [arguments] | -c | -h]
    

要获得连接设备的所有系统服务的诊断输出,只需运行 adb shell dumpsys。但是,这会输出比您通常想要的更多的信息。要使输出的内容更加可控,请通过在命令中添加服务来指定要检查的服务。例如,下面的命令会提供输入组件(例如触摸屏或内置键盘)的系统数据:

adb shell dumpsys input
    

如需查看可与 dumpsys 配合使用的系统服务的完整列表,请使用以下命令:

adb shell dumpsys -l
    

命令行选项

下表列出了使用 dumpsys 时的可用选项。

选项 说明
-t timeout 指定超时期限(秒)。如果未指定,默认值为 10 秒。
--help 输出 dumpsys 工具的帮助文本。
-l 输出可与 dumpsys 配合使用的系统服务的完整列表。
--skip services 指定您不想在输出中包含的服务。
service [arguments] 指定您要包含在输出中的服务。某些服务可能允许您传递可选参数。您可以通过将 -h 选项与服务名称一起传递来了解这些可选参数,如下所示:

    adb shell dumpsys procstats -h
        
-c 指定特定服务时,请附加此选项,以输出计算机可读取格式的数据。
-h 对于某些服务,请附加此选项以查看该服务的帮助文本和其他选项。

检查输入诊断

指定 input 服务(如下所示)可转储系统输入设备(例如键盘和触摸屏)的状态以及输入事件的处理。

adb shell dumpsys input
    

输出因连接的设备上搭载的 Android 版本而异。下面几部分介绍了您通常会看到的信息类型。

Event Hub 状态

以下是您在检查输入诊断的 Event Hub 状态时可能会看到的信息示例:

    INPUT MANAGER (dumpsys input)

    Event Hub State:
      BuiltInKeyboardId: -2
      Devices:
        -1: Virtual
          Classes: 0x40000023
          Path: 
          Descriptor: a718a782d34bc767f4689c232d64d527998ea7fd
          Location:
          ControllerNumber: 0
          UniqueId: 
          Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000
          KeyLayoutFile: /system/usr/keylayout/Generic.kl
          KeyCharacterMapFile: /system/usr/keychars/Virtual.kcm
          ConfigurationFile:
          HaveKeyboardLayoutOverlay: false
        1: msm8974-taiko-mtp-snd-card Headset Jack
          Classes: 0x00000080
          Path: /dev/input/event5
          Descriptor: c8e3782483b4837ead6602e20483c46ff801112c
          Location: ALSA
          ControllerNumber: 0
          UniqueId:
          Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000
          KeyLayoutFile:
          KeyCharacterMapFile:
          ConfigurationFile:
          HaveKeyboardLayoutOverlay: false
        2: msm8974-taiko-mtp-snd-card Button Jack
          Classes: 0x00000001
          Path: /dev/input/event4
          Descriptor: 96fe62b244c555351ec576b282232e787fb42bab
          Location: ALSA
          ControllerNumber: 0
          UniqueId:
          Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000
          KeyLayoutFile: /system/usr/keylayout/msm8974-taiko-mtp-snd-card_Button_Jack.kl
          KeyCharacterMapFile: /system/usr/keychars/msm8974-taiko-mtp-snd-card_Button_Jack.kcm
          ConfigurationFile:
          HaveKeyboardLayoutOverlay: false
        3: hs_detect
          Classes: 0x00000081
          Path: /dev/input/event3
          Descriptor: 485d69228e24f5e46da1598745890b214130dbc4
          Location:
          ControllerNumber: 0
          UniqueId:
          Identifier: bus=0x0000, vendor=0x0001, product=0x0001, version=0x0001
          KeyLayoutFile: /system/usr/keylayout/hs_detect.kl
          KeyCharacterMapFile: /system/usr/keychars/hs_detect.kcm
          ConfigurationFile:
          HaveKeyboardLayoutOverlay: false
    ...
    

Input Reader 状态

InputReader 负责对来自内核的输入事件进行解码。其状态转储会显示各输入设备的配置信息以及最近发生的状态变化,如按下按键或轻触触摸屏等操作。

以下示例显示了触摸屏的输出。注意有关设备分辨率和所用校准参数的信息。

    Input Reader State
    ...
      Device 6: Melfas MMSxxx Touchscreen
          IsExternal: false
          Sources: 0x00001002
          KeyboardType: 0
          Motion Ranges:
            X: source=0x00001002, min=0.000, max=719.001, flat=0.000, fuzz=0.999
            Y: source=0x00001002, min=0.000, max=1279.001, flat=0.000, fuzz=0.999
            PRESSURE: source=0x00001002, min=0.000, max=1.000, flat=0.000, fuzz=0.000
            SIZE: source=0x00001002, min=0.000, max=1.000, flat=0.000, fuzz=0.000
            TOUCH_MAJOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000
            TOUCH_MINOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000
            TOOL_MAJOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000
            TOOL_MINOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000
          Touch Input Mapper:
            Parameters:
              GestureMode: spots
              DeviceType: touchScreen
              AssociatedDisplay: id=0, isExternal=false
              OrientationAware: true
            Raw Touch Axes:
              X: min=0, max=720, flat=0, fuzz=0, resolution=0
              Y: min=0, max=1280, flat=0, fuzz=0, resolution=0
              Pressure: min=0, max=255, flat=0, fuzz=0, resolution=0
              TouchMajor: min=0, max=30, flat=0, fuzz=0, resolution=0
              TouchMinor: unknown range
              ToolMajor: unknown range
              ToolMinor: unknown range
              Orientation: unknown range
              Distance: unknown range
              TiltX: unknown range
              TiltY: unknown range
              TrackingId: min=0, max=65535, flat=0, fuzz=0, resolution=0
              Slot: min=0, max=9, flat=0, fuzz=0, resolution=0
            Calibration:
              touch.size.calibration: diameter
              touch.size.scale: 10.000
              touch.size.bias: 0.000
              touch.size.isSummed: false
              touch.pressure.calibration: amplitude
              touch.pressure.scale: 0.005
              touch.orientation.calibration: none
              touch.distance.calibration: none
            SurfaceWidth: 720px
            SurfaceHeight: 1280px
            SurfaceOrientation: 0
            Translation and Scaling Factors:
              XScale: 0.999
              YScale: 0.999
              XPrecision: 1.001
              YPrecision: 1.001
              GeometricScale: 0.999
              PressureScale: 0.005
              SizeScale: 0.033
              OrientationCenter: 0.000
              OrientationScale: 0.000
              DistanceScale: 0.000
              HaveTilt: false
              TiltXCenter: 0.000
              TiltXScale: 0.000
              TiltYCenter: 0.000
              TiltYScale: 0.000
            Last Button State: 0x00000000
            Last Raw Touch: pointerCount=0
            Last Cooked Touch: pointerCount=0
    

在 Input Reader 状态转储的结尾部分,会显示一些关于全局配置参数的信息,例如点按时间间隔。

    Configuration:
      ExcludedDeviceNames: []
      VirtualKeyQuietTime: 0.0ms
      PointerVelocityControlParameters: scale=1.000, lowThreshold=500.000, highThreshold=3000.000, acceleration=3.000
      WheelVelocityControlParameters: scale=1.000, lowThreshold=15.000, highThreshold=50.000, acceleration=4.000
      PointerGesture:
        Enabled: true
        QuietInterval: 100.0ms
        DragMinSwitchSpeed: 50.0px/s
        TapInterval: 150.0ms
        TapDragInterval: 300.0ms
        TapSlop: 20.0px
        MultitouchSettleInterval: 100.0ms
        MultitouchMinDistance: 15.0px
        SwipeTransitionAngleCosine: 0.3
        SwipeMaxWidthRatio: 0.2
        MovementSpeedRatio: 0.8
        ZoomSpeedRatio: 0.3
    

Input Dispatcher 状态

InputDispatcher 负责向应用发送输入事件。如下面的输出示例所示,其状态转储显示了有关哪个窗口被轻触、输入队列的状态以及是否正在进行 ANR 等信息。

    Input Dispatcher State:
      DispatchEnabled: 1
      DispatchFrozen: 0
      FocusedApplication: <null>
      FocusedWindow: name='Window{3fb06dc3 u0 StatusBar}'
      TouchStates: <no displays touched>
      Windows:
        0: name='Window{357bbbfe u0 SearchPanel}', displayId=0, paused=false, hasFocus=false, hasWallpaper=false, visible=false, canReceiveKeys=false, flags=0x01820100, type=0x000007e8, layer=211000, frame=[0,0][1080,1920], scale=1.000000, touchableRegion=[0,0][1080,1920], inputFeatures=0x00000000, ownerPid=22674, ownerUid=10020, dispatchingTimeout=5000.000ms
        1: name='Window{3b14c0ca u0 NavigationBar}', displayId=0, paused=false, hasFocus=false, hasWallpaper=false, visible=false, canReceiveKeys=false, flags=0x01840068, type=0x000007e3, layer=201000, frame=[0,1776][1080,1920], scale=1.000000, touchableRegion=[0,1776][1080,1920], inputFeatures=0x00000000, ownerPid=22674, ownerUid=10020, dispatchingTimeout=5000.000ms
        2: name='Window{2c7e849c u0 com.vito.lux}', displayId=0, paused=false, hasFocus=false, hasWallpaper=false, visible=true, canReceiveKeys=false, flags=0x0089031a, type=0x000007d6, layer=191000, frame=[-495,-147][1575,1923], scale=1.000000, touchableRegion=[-495,-147][1575,1923], inputFeatures=0x00000000, ownerPid=4697, ownerUid=10084, dispatchingTimeout=5000.000ms
        ...
      MonitoringChannels:
        0: 'WindowManager (server)'
      RecentQueue: length=10
        MotionEvent(deviceId=4, source=0x00001002, action=2, flags=0x00000000, metaState=0x00000000, buttonState=0x00000000, edgeFlags=0x00000000, xPrecision=1.0, yPrecision=1.0, displayId=0, pointers=[0: (335.0, 1465.0)]), policyFlags=0x62000000, age=217264.0ms
        MotionEvent(deviceId=4, source=0x00001002, action=1, flags=0x00000000, metaState=0x00000000, buttonState=0x00000000, edgeFlags=0x00000000, xPrecision=1.0, yPrecision=1.0, displayId=0, pointers=[0: (335.0, 1465.0)]), policyFlags=0x62000000, age=217255.7ms
        MotionEvent(deviceId=4, source=0x00001002, action=0, flags=0x00000000, metaState=0x00000000, buttonState=0x00000000, edgeFlags=0x00000000, xPrecision=1.0, yPrecision=1.0, displayId=0, pointers=[0: (330.0, 1283.0)]), policyFlags=0x62000000, age=216805.0ms
        ...
      PendingEvent: <none>
      InboundQueue: <empty>
      ReplacedKeys: <empty>
      Connections:
        0: channelName='WindowManager (server)', windowName='monitor', status=NORMAL, monitor=true, inputPublisherBlocked=false
          OutboundQueue: <empty>
          WaitQueue: <empty>
        1: channelName='278c1d65 KeyguardScrim (server)', windowName='Window{278c1d65 u0 KeyguardScrim}', status=NORMAL, monitor=false, inputPublisherBlocked=false
          OutboundQueue: <empty>
          WaitQueue: <empty>
        2: channelName='357bbbfe SearchPanel (server)', windowName='Window{357bbbfe u0 SearchPanel}', status=NORMAL, monitor=false, inputPublisherBlocked=false
          OutboundQueue: <empty>
          WaitQueue: <empty>
        ...
      AppSwitch: not pending
        7: channelName='2280455f com.google.android.gm/com.google.android.gm.ConversationListActivityGmail (server)', windowName='Window{2280455f u0 com.google.android.gm/com.google.android.gm.ConversationListActivityGmail}', status=NORMAL, monitor=false, inputPublisherBlocked=false
          OutboundQueue: <empty>
          WaitQueue: <empty>
        8: channelName='1a7be08a com.android.systemui/com.android.systemui.recents.RecentsActivity (server)', windowName='Window{1a7be08a u0 com.android.systemui/com.android.systemui.recents.RecentsActivity EXITING}', status=NORMAL, monitor=false, inputPublisherBlocked=false
          OutboundQueue: <empty>
          WaitQueue: <empty>
        9: channelName='3b14c0ca NavigationBar (server)', windowName='Window{3b14c0ca u0 NavigationBar}', status=NORMAL, monitor=false, inputPublisherBlocked=false
          OutboundQueue: <empty>
          WaitQueue: <empty>
        ...
      Configuration:
        KeyRepeatDelay: 50.0ms
        KeyRepeatTimeout: 500.0ms
    

要考虑的事项

下面列出了在检查 input 服务的各项输出时要考虑的事项:

Event Hub 状态:

  • 所有预期的输入设备是否都存在。
  • 每个输入设备是否都有适当的按键布局文件、按键字符映射文件和输入设备配置文件。如果这些文件缺失或包含语法错误,将无法加载。
  • 每个输入设备是否都已正确分类。Classes 字段中的位是否对应 EventHub.h 中的标记,如 INPUT_DEVICE_CLASS_TOUCH_MT
  • BuiltInKeyboardId 是否正确。若设备未配备内置键盘,则该 ID 必须为 -2,否则应为内置键盘的 ID。
    • 若发现 BuiltInKeyboardId 应该为 -2,但却不是,则说明可能缺少某个特殊功能小键盘的按键字符映射文件。特殊功能小键盘设备应具有仅包含 type SPECIAL_FUNCTION 行(即我们在前述 tuna-gpio-keykad.kcm 文件中看到的内容)的按键字符映射文件。

Input Reader 状态:

  • 所有的预期输入设备是否都存在。
  • 每个输入设备是否都已配置正确。特别注意检查触摸屏和操纵杆轴是否正确。

Input Dispatcher 状态:

  • 所有输入事件是否均按预期进行处理。
  • 轻触触摸屏的同时运行 dumpsys 后,TouchStates 行是否正确显示了您所轻触的窗口。

测试界面性能

如果指定 gfxinfo 服务,输出中会包含录制阶段所发生的动画帧的相关性能信息。以下命令使用 gfxinfo 收集指定软件包名称的界面性能数据:

    adb shell dumpsys gfxinfo package-name
    

您还可以包含 framestats 选项,以提供有关最近发生的帧的更加详细的帧时间信息,让您能够更准确地找到问题并解决,如下所示:

    adb shell dumpsys gfxinfo package-name framestats
    

要详细了解如何使用 gfxinfoframestats 将界面性能衡量集成到您的测试实践中,请转到测试界面性能

检查网络诊断

指定 netstats 服务可提供自上次设备启动后收集的网络使用情况统计信息。要输出其他信息(例如详细的唯一用户 ID (UID) 信息),请包含 detail 选项,如下所示:

adb shell dumpsys netstats detail
    

输出因连接的设备上搭载的 Android 版本而异。下面几部分介绍了您通常会看到的信息类型。

活动接口和活动 UID 接口

以下示例输出列出了连接的设备的活动接口和活动 UID 接口。在大多数情况下,活动接口和活动 UID 接口的信息是相同的。

    Active interfaces:
      iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="Guest"}]
    Active UID interfaces:
      iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="Guest"}]
    

“Dev”和“Xt”统计信息

以下是 Dev 统计信息部分的示例输出:

    Dev stats:
      Pending bytes: 1798112
      History since boot:
      ident=[{type=WIFI, subType=COMBINED, networkId="Guest", metered=false}] uid=-1 set=ALL tag=0x0
        NetworkStatsHistory: bucketDuration=3600
          st=1497891600 rb=1220280 rp=1573 tb=309870 tp=1271 op=0
          st=1497895200 rb=29733 rp=145 tb=85354 tp=185 op=0
          st=1497898800 rb=46784 rp=162 tb=42531 tp=192 op=0
          st=1497902400 rb=27570 rp=111 tb=35990 tp=121 op=0
    Xt stats:
      Pending bytes: 1771782
      History since boot:
      ident=[{type=WIFI, subType=COMBINED, networkId="Guest", metered=false}] uid=-1 set=ALL tag=0x0
        NetworkStatsHistory: bucketDuration=3600
          st=1497891600 rb=1219598 rp=1557 tb=291628 tp=1255 op=0
          st=1497895200 rb=29623 rp=142 tb=82699 tp=182 op=0
          st=1497898800 rb=46684 rp=160 tb=39756 tp=191 op=0
          st=1497902400 rb=27528 rp=110 tb=34266 tp=120 op=0
    

UID 统计信息

以下是每个 UID 的详细统计信息的示例。

    UID stats:
      Pending bytes: 744
      Complete history:
      ident=[[type=MOBILE_SUPL, subType=COMBINED, subscriberId=311111...], [type=MOBILE, subType=COMBINED, subscriberId=311111...]] uid=10007  set=DEFAULT tag=0x0
        NetworkStatsHistory: bucketDuration=7200000
          bucketStart=1406167200000 activeTime=7200000 rxBytes=4666 rxPackets=7 txBytes=1597 txPackets=10 operations=0
      ident=[[type=WIFI, subType=COMBINED, networkId="MySSID"]] uid=10007  set=DEFAULT tag=0x0
        NetworkStatsHistory: bucketDuration=7200000
          bucketStart=1406138400000 activeTime=7200000 rxBytes=17086802 rxPackets=15387 txBytes=1214969 txPackets=8036 operations=28
          bucketStart=1406145600000 activeTime=7200000 rxBytes=2396424 rxPackets=2946 txBytes=464372 txPackets=2609 operations=70
          bucketStart=1406152800000 activeTime=7200000 rxBytes=200907 rxPackets=606 txBytes=187418 txPackets=739 operations=0
          bucketStart=1406160000000 activeTime=7200000 rxBytes=826017 rxPackets=1126 txBytes=267342 txPackets=1175 operations=35
    

要查找应用的 UID,请运行以下命令:adb shell dumpsys package your-package-name,然后查找标有 userId 的行。

例如,要查找应用“com.example.myapp”的网络使用情况,请运行以下命令:

    adb shell dumpsys package com.example.myapp | grep userId
    

输出的内容应类似于以下文本:

        userId=10007 gids=[3003, 1028, 1015]
    

使用上面的示例转储,查找包含 uid=10007 的行。有两个这样的行,第一个表示移动数据连接,第二个表示 WLAN 连接。在每一行下方,您可以看到每个两小时期限(bucketDuration 以毫秒为单位指定)的以下信息:

  • set=DEFAULT 表示前台网络使用情况,set=BACKGROUND 表示后台网络使用情况,set=ALL 表示这两种网络使用情况。
  • tag=0x0 表示与流量关联的套接字代码。
  • rxBytesrxPackets 表示在相应时间间隔内接收的字节数和数据包数。
  • txBytestxPackets 表示在相应时间间隔内发送(传输)的字节数和数据包数。

检查电池诊断

指定 batterystats 服务会生成关于设备电池使用情况的有趣统计数据,这些数据按唯一用户 ID (UID) 进行整理。要了解如何使用 dumpsys 在低电耗模式和应用待机模式下测试应用,请转到在低电耗模式和应用待机模式下进行测试

batterystats 的命令如下所示:

    adb shell dumpsys batterystats options
    

要查看 batterystats 可用的其他选项列表,请包含 -h 选项。以下示例会输出自设备上次充电后指定应用软件包的电池使用情况统计信息:

    adb shell dumpsys batterystats --charged package-name
    

输出通常包含以下内容:

  • 电池相关事件的历史记录
  • 设备的全局统计信息
  • 每个 UID 和系统组件的大致用电量
  • 单个应用的每个数据包占用的移动网络毫秒数
  • 系统 UID 汇总统计信息
  • 应用 UID 汇总统计信息

要详细了解如何使用 batterystats 生成 HTML 格式的可视化输出内容,以便于您理解和诊断电池相关问题,请参阅使用 Batterystats 和 Battery Historian 分析电池用量

检查计算机可读格式的输出

您可以使用以下命令以计算机可读的 CSV 格式生成 batterystats 输出:

adb shell dumpsys batterystats --checkin
    

以下是您应该会看到的输出内容示例:

    9,0,i,vers,11,116,K,L
    9,0,i,uid,1000,android
    9,0,i,uid,1000,com.android.providers.settings
    9,0,i,uid,1000,com.android.inputdevices
    9,0,i,uid,1000,com.android.server.telecom
    ...
    9,0,i,dsd,1820451,97,s-,p-
    9,0,i,dsd,3517481,98,s-,p-
    9,0,l,bt,0,8548446,1000983,8566645,1019182,1418672206045,8541652,994188
    9,0,l,gn,0,0,666932,495312,0,0,2104,1444
    9,0,l,m,6794,0,8548446,8548446,0,0,0,666932,495312,0,697728,0,0,0,5797,0,0
    ...
    

电池用量检测可以基于 UID 进行,也可以在系统级别进行;是否包含某项数据是根据其对于分析电池性能的作用决定的。每一行代表一项包含以下元素的检测信息:

  • 一个虚拟整数
  • 与检测相关的用户 ID
  • 聚合模式:
    • “i”表示不与已充电/未充电状态关联的信息。
    • “l”表示已充电(自上次充电后的使用情况)。
    • “u”表示已拔下电源(自上次拔下电源后的使用情况)。在 Android 5.1.1 中已弃用。
  • 区段标识符,用于确定如何解译行中的后续值。

下表介绍了您可能会看到的各个区段标识符:

区段标识符 说明 其余字段

vers

版本

签入版本、parcel 版本、启动平台版本、结束平台版本

uid

UID

uid、软件包名称

apk

APK

唤醒、APK、服务、开始时间、启动、发布

pr

进程

进程、用户、系统、前台、启动

sr

传感器

传感器编号、时间、计数

vib

振动器

时间、计数

fg

前台

时间、计数

st

状态时间

前台、活动、正在运行

wl

唤醒锁

唤醒锁定、完整时间、“f”、完整计数、部分时间、“p”、部分计数、窗口时间、“w”、窗口计数

sy

同步

同步、时间、计数

jb

作业

作业、时间、计数

kwl

内核唤醒锁定

内核唤醒锁定、时间、计数

wr

唤醒原因

唤醒原因、时间、计数

nt

网络

移动字节 RX、移动字节 TX、WLAN 字节 RX、WLAN 字节 TX、移动数据包 RX、移动数据包 TX、WLAN 数据包 RX、WLAN 数据包 TX、移动设备活动时间、移动设备活动计数

ua

用户活动

其他、按钮、轻触

bt

电池

开始计数、电池实时、电池正常运行时间、总实时、总正常运行时间、开始时钟时间、电池屏幕关闭实时、电池屏幕关闭正常运行时间

dc

电池电量消耗

低、高、屏幕开启、屏幕关闭

lv

电量

开始电量、当前电量

wfl

WLAN

完整 WLAN 锁定时间、WLAN 扫描时间、WLAN 运行时间、WLAN 扫描计数、WLAN 闲置时间、WLAN 接收时间、WLAN 传输时间

gwfl

全局 WLAN

WLAN 开启时间、WLAN 运行时间、WLAN 闲置时间、WLAN 接收时间、WLAN 传输时间、WLAN 功率(毫安时)

gble

全局蓝牙

BT 闲置时间、BT 接收时间、BT 传输时间、BT 功率(毫安时)

m

其他

屏幕开启时间、手机开机时间、完整唤醒锁定总时间、部分唤醒锁定总时间、移动无线装置运行时间、移动无线装置运行调整时间、交互时间、节能模式启用时间、连接更改、设备闲置模式启用时间、设备闲置模式启用计数、设备闲置时间、设备闲置计数、移动无线装置活动计数、移动无线装置活动未知时间

gn

全局网络

移动 RX 总字节数、移动 TX 总字节数、WLAN RX 总字节数、WLAN TX 总字节数、移动 RX 总数据包数、移动 TX 总数据包数、WLAN RX 总数据包数、WLAN TX 总数据包数

br

屏幕亮度

黑暗、昏暗、中等、柔光、明亮

sst

信号扫描时间

信号扫描时间

sgt

信号强度时间

无、差、一般、良好、强

sgc

信号强度计数

无、差、一般、良好、强

dct

数据连接时间

无、GPRS、EDGE、UMTS、CDMA、EVDO_0、EVDO_A、1xRTT、HSDPA、HSUPA、HSPA、IDEN、EVDO_B、LTE、EHRPD、HSPAP、其他

dcc

数据连接计数

无、GPRS、EDGE、UMTS、CDMA、EVDO_0、EVDO_A、1xRTT、HSDPA、HSUPA、HSPA、IDEN、EVDO_B、LTE、EHRPD、HSPAP、其他

wst

WLAN 状态时间

关闭、关闭扫描、无网络、断开连接、已连接 STA、已连接 P2P、已连接 STA P2P、软 AP

wsc

WLAN 状态计数

关闭、关闭扫描、无网络、断开连接、已连接 STA、已连接 P2P、已连接 STA P2P、软 AP

wsst

WLAN 客户端状态时间

无效、已断开连接、接口已停用、不活动、正在扫描、正在进行身份验证、正在关联、已关联、四步握手、组握手、已完成、休眠、未初始化

wssc

WLAN 客户端状态计数

无效、已断开连接、接口已停用、不活动、正在扫描、正在进行身份验证、正在关联、已关联、四步握手、组握手、已完成、休眠、未初始化

wsgt

WLAN 信号强度时间

无、差、一般、良好、强

wsgc

WLAN 信号强度计数

无、差、一般、良好、强

bst

蓝牙状态时间

不活动、低、中、高

bsc

蓝牙状态计数

不活动、低、中、高

pws

耗电量汇总

电池容量、计算的用电量、最低耗电量、最高耗电量

pwi

耗电项

标签、毫安时

dsd

耗电步骤

时长、级别、屏幕、节电

csd

充电步骤

时长、级别、屏幕、节电

dtr

耗电剩余时间

电池剩余时间

ctr

充电剩余时间

充电剩余时间

注意:对于 Android 6.0 之前的版本,蓝牙无线电、移动网络无线电以及 WLAN 的耗电量在 m(“其他”)区段类别中进行跟踪。在 Android 6.0 及更高版本中,这些组件的耗电量在 pwi(“耗电项”)区段进行跟踪,其中每个组件均使用单独的标签(wifi、blue、cell)。

查看内存分配

您可以通过两种方法检查应用的内存占用情况:使用 procstats 检查一段时间内的占用情况,或使用 meminfo 检查特定时间点的占用情况。以下几部分将介绍如何使用这两种方法。

procstats

procstats 可以让您了解应用在一段时间内的表现,包括应用在后台运行的时长以及在该期间内的内存占用情况。它可以帮助您快速找到应用中的低效环节和不当行为(例如内存泄漏),这些问题可能会影响应用的表现,特别是在低内存设备上运行时。其状态转储会显示每个应用的运行时间、实际使用的物理内存(比例分配共享库占用的内存,PSS)和进程独自占用的物理内存(不包含共享库占用的内存,USS)等统计信息。

要获取过去三小时内应用的内存占用情况统计信息(以可读性良好的格式显示),请运行以下命令:

adb shell dumpsys procstats --hours 3

从下面的示例中可以看出,输出会显示应用运行时间的百分比,以及 PSS 和 USS(minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS over 样本数)。

    AGGREGATED OVER LAST 3 HOURS:
      * com.android.systemui / u0a20 / v22:
               TOTAL: 100% (109MB-126MB-159MB/108MB-125MB-157MB over 18)
          Persistent: 100% (109MB-126MB-159MB/108MB-125MB-157MB over 18)
      * com.android.nfc / 1027 / v22:
               TOTAL: 100% (17MB-17MB-17MB/16MB-16MB-16MB over 18)
          Persistent: 100% (17MB-17MB-17MB/16MB-16MB-16MB over 18)
      * android.process.acore / u0a4 / v22:
               TOTAL: 100% (14MB-15MB-15MB/14MB-14MB-14MB over 20)
              Imp Fg: 100% (14MB-15MB-15MB/14MB-14MB-14MB over 20)
      ...
      * com.coulombtech / u0a106 / v26:
               TOTAL: 0.01%
            Receiver: 0.01%
            (Cached): 21% (4.9MB-5.0MB-5.2MB/3.8MB-3.9MB-4.1MB over 2)
      * com.softcoil.mms / u0a86 / v32:
               TOTAL: 0.01%
            (Cached): 0.25%
      * com.udemy.android / u0a91 / v38:
               TOTAL: 0.01%
            Receiver: 0.01%
            (Cached): 0.75% (9.8MB-9.8MB-9.8MB/8.5MB-8.5MB-8.5MB over 1)
      ...
    Run time Stats:
      SOff/Norm: +32m52s226ms
      SOn /Norm: +2h10m8s364ms
           Mod : +17s930ms
          TOTAL: +2h43m18s520ms

    Memory usage:
      Kernel : 265MB (38 samples)
      Native : 73MB (38 samples)
      Persist: 262MB (90 samples)
      Top    : 190MB (325 samples)
      ImpFg  : 204MB (569 samples)
      ImpBg  : 754KB (345 samples)
      Service: 93MB (1912 samples)
      Receivr: 227KB (1169 samples)
      Home   : 66MB (12 samples)
      LastAct: 30MB (255 samples)
      CchAct : 220MB (450 samples)
      CchCAct: 193MB (71 samples)
      CchEmty: 182MB (652 samples)
      Cached : 58MB (38 samples)
      Free   : 60MB (38 samples)
      TOTAL  : 1.9GB
      ServRst: 50KB (278 samples)

              Start time: 2015-04-08 13:44:18
      Total elapsed time: +2h43m18s521ms (partial) libart.so
    

meminfo

您可以使用以下命令记录应用内存在不同类型的 RAM 分配之间的划分情况:

    adb shell dumpsys meminfo package_name|pid [-d]
    

-d 标记会输出更多与 Dalvik 和 ART 内存占用情况相关的信息。

输出列出了应用当前的所有分配,以千字节为单位。

检查此信息时,您应熟悉以下分配类型:

私有(干净和脏)RAM
这是仅由您的进程使用的内存。这是您的应用进程销毁后系统可以回收的 RAM 容量。通常情况下,最重要的部分是私有脏 RAM,它的开销最大,因为只有您的进程使用它,而且其内容仅存在于 RAM 中,所以无法通过分页机制映射到硬盘(因为 Android 不使用交换)。您进行的所有 Dalvik 和原生堆分配都将是私有脏 RAM;您与 Zygote 进程共享的 Dalvik 和原生分配则是共享脏 RAM。
实际使用的物理内存(比例分配共享库占用的内存,PSS)
这是对应用 RAM 占用情况的衡量,考虑了在进程之间共享 RAM 页的情况。您的进程独占的 RAM 页会直接计入其 PSS 值,而与其他进程共享的 RAM 页则仅会按相应比例计入 PSS 值。例如,两个进程之间共享的 RAM 页会将其一半的大小分别计入这两个进程的 PSS 中。

PSS 衡量的一个优点是,您可以将所有进程的 PSS 加起来确定所有进程占用的实际内存。这表示 PSS 是一种理想的方式,可用来衡量进程的实际 RAM 占用比重,以及相对于其他进程和可用的总 RAM 而言,对 RAM 的占用情况。

例如,下面是 Nexus 5 设备上地图进程的输出。此处的信息较多,但下面列出了探讨要点。

adb shell dumpsys meminfo com.google.android.apps.maps -d

注意:您看到的信息可能会与此处显示的内容稍有不同,因为输出中的某些详细信息在不同平台版本上会有所不同。

    ** MEMINFO in pid 18227 [com.google.android.apps.maps] **
                       Pss  Private  Private  Swapped     Heap     Heap     Heap
                     Total    Dirty    Clean    Dirty     Size    Alloc     Free
                    ------   ------   ------   ------   ------   ------   ------
      Native Heap    10468    10408        0        0    20480    14462     6017
      Dalvik Heap    34340    33816        0        0    62436    53883     8553
     Dalvik Other      972      972        0        0
            Stack     1144     1144        0        0
          Gfx dev    35300    35300        0        0
        Other dev        5        0        4        0
         .so mmap     1943      504      188        0
        .apk mmap      598        0      136        0
        .ttf mmap      134        0       68        0
        .dex mmap     3908        0     3904        0
        .oat mmap     1344        0       56        0
        .art mmap     2037     1784       28        0
       Other mmap       30        4        0        0
       EGL mtrack    73072    73072        0        0
        GL mtrack    51044    51044        0        0
          Unknown      185      184        0        0
            TOTAL   216524   208232     4384        0    82916    68345    14570

     Dalvik Details
            .Heap     6568     6568        0        0
             .LOS    24771    24404        0        0
              .GC      500      500        0        0
        .JITCache      428      428        0        0
          .Zygote     1093      936        0        0
       .NonMoving     1908     1908        0        0
     .IndirectRef       44       44        0        0

     Objects
                   Views:       90         ViewRootImpl:        1
             AppContexts:        4           Activities:        1
                  Assets:        2        AssetManagers:        2
           Local Binders:       21        Proxy Binders:       28
           Parcel memory:       18         Parcel count:       74
        Death Recipients:        2      OpenSSL Sockets:        2
    

下面是 Gmail 应用的 Dalvik 上一个较旧版本的 dumpsys:

    ** MEMINFO in pid 9953 [com.google.android.gm] **
                     Pss     Pss  Shared Private  Shared Private    Heap    Heap    Heap
                   Total   Clean   Dirty   Dirty   Clean   Clean    Size   Alloc    Free
                  ------  ------  ------  ------  ------  ------  ------  ------  ------
      Native Heap      0       0       0       0       0       0    7800    7637(6)  126
      Dalvik Heap   5110(3)    0    4136    4988(3)    0       0    9168    8958(6)  210
     Dalvik Other   2850       0    2684    2772       0       0
            Stack     36       0       8      36       0       0
           Cursor    136       0       0     136       0       0
           Ashmem     12       0      28       0       0       0
        Other dev    380       0      24     376       0       4
         .so mmap   5443(5) 1996    2584    2664(5) 5788    1996(5)
        .apk mmap    235      32       0       0    1252      32
        .ttf mmap     36      12       0       0      88      12
        .dex mmap   3019(5) 2148       0       0    8936    2148(5)
       Other mmap    107       0       8       8     324      68
          Unknown   6994(4)    0     252    6992(4)    0       0
            TOTAL  24358(1) 4188    9724   17972(2)16388    4260(2)16968   16595     336

     Objects
                   Views:    426         ViewRootImpl:        3(8)
             AppContexts:      6(7)        Activities:        2(7)
                  Assets:      2        AssetManagers:        2
           Local Binders:     64        Proxy Binders:       34
        Death Recipients:      0
         OpenSSL Sockets:      1

     SQL
             MEMORY_USED:   1739
      PAGECACHE_OVERFLOW:   1164          MALLOC_SIZE:       62
    

一般情况下,仅需关注 Pss TotalPrivate Dirty 列。在某些情况下,Private CleanHeap Alloc 列提供的数据也值得关注。下面列出了关于不同的内存分配(各行)您需要关注的其他信息:

Dalvik Heap
您应用中的 Dalvik 分配所占用的 RAM。Pss Total 包括所有 Zygote 分配(如上述 PSS 定义中所述,通过进程之间共享的内存容量来衡量)。Private Dirty 值是仅分配给您的应用堆的实际 RAM,包含了您自己的分配和任何 Zygote 分配页,这些分配页在从 Zygote 派生您的应用进程以来已被修改。

注意:在包含 Dalvik Other 区段的更高平台版本上,Dalvik 堆的 Pss TotalPrivate Dirty 数值不包括 Dalvik 开销(例如即时编译 (JIT) 和垃圾回收记录),而更低的版本会在 Dalvik 中将其一并列出。

Heap Alloc 是 Dalvik 和原生堆分配器为您的应用记录的内存占用量。此值大于 Pss TotalPrivate Dirty,这是因为您的进程是从 Zygote 派生的,且包含您的进程与所有其他进程共享的分配。

.so mmap.dex mmap
映射的 .so(原生)和 .dex(Dalvik 或 ART)代码占用的 RAM。Pss Total 值包括应用之间共享的平台代码;Private Clean 是您的应用自己的代码。通常,实际映射的内存容量要大得多。此处的 RAM 只是应用已执行的代码当前需要占用的 RAM。但 .so mmap 具有较大容量的私有脏 RAM,这是因为在将其加载到最终地址时对原生代码进行了修复。
.oat mmap
这是代码映像占用的 RAM 容量,根据由多个应用共用的预加载类计算。此映像在所有应用之间共享,不受特定应用影响。
.art mmap
这是堆映像占用的 RAM 容量,根据由多个应用共用的预加载类计算。此映像在所有应用之间共享,不受特定应用影响。尽管 ART 映像包含 Object 实例,但它不会计入您的堆占用空间。
.Heap(仅带有 -d 标记)
这是应用堆所占用的内存容量,其中不包括映像中的对象和大型对象空间,但包括 zygote 空间和非移动空间。
.LOS(仅带有 -d 标记)
这是由 ART 大型对象空间占用的 RAM 容量,其中包括 zygote 大型对象。大型对象是所有大于 12KB 的原语数组分配。
.GC(仅带有 -d 标记)
这是垃圾回收的开销成本。没有什么办法能够真正减少这一开销。
.JITCache(仅带有 -d 标记)
这是 JIT 数据和代码缓存占用的内存容量。通常情况下,该值为 0,因为所有应用都会在安装时编译。
.Zygote(仅带有 -d 标记)
这是 zygote 空间占用的内存容量。zygote 空间在设备启动过程创建且永远不会被分配。
.NonMoving(仅带有 -d 标记)
这是由 ART 非移动空间占用的 RAM 容量。非移动空间包含特殊的不可移动对象,例如字段和方法。您可以通过在应用中减少使用字段和方法来减小这部分空间。
.IndirectRef(仅带有 -d 标记)
这是由 ART 间接引用表占用的 RAM 容量。通常此容量较小,但如果很高,可以通过减少使用的本地和全局 JNI 引用数量来减小此容量。
Unknown
系统无法将其分类到其他更具体的一个项中的任何 RAM 页。当前,此类 RAM 页主要包含原生分配,由于地址空间布局随机化 (ASLR),工具在收集此数据时无法识别这些分配。与 Dalvik 堆相同,Unknown 的 Pss Total 考虑了与 Zygote 共享的容量,且 Private Dirty 是仅由您的应用占用的未知 RAM。
TOTAL
您的进程占用的 PSS RAM 总容量,等于上述所有 PSS 字段的总和。该值表示了您的进程占用的内存容量占总体内存容量的比重,可以直接与其他进程和可用的总 RAM 进行比较。

Private DirtyPrivate Clean 合起来就是您进程中的总分配,这些分配未与其他进程共享。这些分配(尤其是 Private Dirty)的容量等于进程销毁后将释放到系统中的 RAM 容量。脏 RAM 页由于已被修改过,因此必须保留在 RAM 中(因为没有交换);干净 RAM 页是从某个持久性文件(例如正在执行的代码)映射而来的,因此如果暂时不使用,可以将其换出 RAM。

ViewRootImpl
您的进程中当前处于活动状态的根视图数量。每个根视图都与一个窗口关联,因此该值有助于您确定与对话框或其他窗口有关的内存泄漏。

AppContextsActivities
您的进程中当前处于活动状态的应用 ContextActivity 对象数量。该值可以帮助您快速确定发生泄漏的 Activity 对象,这些对象由于存在对其的静态引用(比较常见)而无法进行垃圾回收。这些对象往往关联了许多其他分配,因此是查找大型内存泄漏的理想工具。

注意ViewDrawable 对象也会保留对其源 Activity 的引用,因此保留 ViewDrawable 对象也会导致您的应用泄漏 Activity