dumpsys
— это инструмент, который работает на устройствах Android и предоставляет информацию о системных службах. Вызовите dumpsys
из командной строки с помощью Android Debug Bridge (ADB), чтобы получить диагностические данные для всех системных служб, работающих на подключенном устройстве.
Этот вывод обычно более подробный, чем вам хотелось бы, поэтому используйте параметры командной строки на этой странице, чтобы получить вывод только для тех системных служб, которые вам нужны. На этой странице также описывается, как использовать dumpsys
для выполнения общих задач, таких как проверка входных данных, оперативной памяти, батареи или диагностика сети.
Синтаксис
Общий синтаксис использования 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 | Укажите services , которые вы не хотите включать в выходные данные. |
service [ arguments ] | Укажите service , который вы хотите вывести. Некоторые службы могут позволять вам передавать необязательные arguments . Чтобы узнать об этих необязательных аргументах, передайте параметр -h службе: adb shell dumpsys procstats -h |
-c | При указании определенных служб добавьте эту опцию для вывода данных в удобном для машины формате. |
-h | Для некоторых служб добавьте эту опцию, чтобы увидеть текст справки и дополнительные параметры для этой службы. |
Проверьте входную диагностику
Указание службы input
, как показано в следующей команде, выводит состояние системных устройств ввода, таких как клавиатуры и сенсорные экраны, а также обработку событий ввода.
adb shell dumpsys input
Результат зависит от версии Android, работающей на подключенном устройстве. В следующих разделах описывается тип информации, которую вы обычно видите.
Состояние концентратора событий
Ниже приведен пример того, что вы можете увидеть при проверке состояния концентратора событий входной диагностики:
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 ...
Состояние входного считывателя
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
В конце дампа состояния считывателя ввода содержится некоторая информация о глобальных параметрах конфигурации, таких как интервал касания:
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
Состояние входного диспетчера
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
:
Состояние концентратора событий:
- Все ожидаемые устройства ввода присутствуют.
- Каждое устройство ввода имеет соответствующий файл раскладки клавиш, файл карты символов клавиш и файл конфигурации устройства ввода. Если файлы отсутствуют или содержат синтаксические ошибки, они не загружаются.
- Каждое устройство ввода классифицировано правильно. Биты в поле
Classes
соответствуют флагам вEventHub.h
, напримерINPUT_DEVICE_CLASS_TOUCH_MT
. -
BuiltInKeyboardId
верен. Если устройство не имеет встроенной клавиатуры, то идентификатор должен быть-2
. В противном случае это должен быть идентификатор встроенной клавиатуры. - Если вы заметили, что
BuiltInKeyboardId
не равно-2
а должно быть так, значит, вам не хватает файла сопоставления символов для специальной функциональной клавиатуры. Устройства с клавиатурой со специальными функциями должны иметь файлы сопоставления символов клавиш, содержащие толькоtype SPECIAL_FUNCTION
.
Состояние входного считывателя:
- Все ожидаемые устройства ввода присутствуют.
- Каждое устройство ввода настроено правильно. В частности, проверьте правильность осей сенсорного экрана и джойстика.
Состояние входного диспетчера:
- Все входные события обрабатываются ожидаемым образом.
- После прикосновения к сенсорному экрану и одновременного запуска
dumpsys
строкаTouchStates
правильно идентифицирует окно, к которому вы прикасаетесь.
Тестирование производительности пользовательского интерфейса
Указание службы gfxinfo
обеспечивает вывод информации о производительности, относящейся к кадрам анимации, возникающим на этапе записи. Следующая команда использует gfxinfo
для сбора данных о производительности пользовательского интерфейса для указанного имени пакета:
adb shell dumpsys gfxinfo package-name
Вы также можете включить опцию framestats
, чтобы предоставить еще более подробную информацию о синхронизации последних кадров, чтобы вы могли более точно отслеживать и устранять проблемы:
adb shell dumpsys gfxinfo package-name framestats
Чтобы узнать больше об использовании gfxinfo
и framestats
для интеграции измерений производительности пользовательского интерфейса в ваши методы тестирования, см. раздел «Написание Macrobenchmark» .
Проверьте диагностику сети
Указание службы netstats
предоставляет статистику использования сети, собранную с момента загрузки предыдущего устройства. Чтобы вывести дополнительную информацию, например подробную информацию об уникальном идентификаторе пользователя (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 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
. Таких линий две: первая указывает на мобильное соединение, а вторая — на соединение Wi-Fi. Под каждой строкой вы можете увидеть следующую информацию для каждого двухчасового окна, которое bucketDuration
указывает в миллисекундах:
-
set=DEFAULT
указывает на активное использование сети, аset=BACKGROUND
указывает на фоновое использование.set=ALL
подразумевает и то, и другое. -
tag=0x0
указывает тег сокета, связанный с трафиком. -
rxBytes
иrxPackets
представляют полученные байты и полученные пакеты в соответствующем интервале времени. -
txBytes
иtxPackets
представляют собой отправленные (переданные) байты и отправленные пакеты в соответствующем временном интервале.
Проверьте диагностику аккумулятора
При указании службы batterystats
создаются статистические данные об использовании батареи на устройстве, организованные по уникальному идентификатору пользователя (UID). Чтобы узнать, как использовать dumpsys
для проверки приложения на режимы Doze и App Standby, см. раздел Тестирование с помощью Doze и App Standby .
Команда для batterystats
выглядит следующим образом:
adb shell dumpsys batterystats options
Чтобы просмотреть список дополнительных опций, доступных для batterystats
, включите опцию -h
. В следующем примере выводятся статистика использования батареи для указанного пакета приложения с момента последней зарядки устройства:
adb shell dumpsys batterystats --charged package-name
Вывод обычно включает в себя следующее:
- История событий, связанных с аккумулятором
- Глобальная статистика по устройству
- Приблизительное энергопотребление на каждый UID и системный компонент
- Миллисекунды мобильного приложения на пакет
- Агрегированная статистика по UID системы
- Агрегированная статистика UID приложения
Чтобы узнать больше об использовании batterystats
и создании HTML-визуализации выходных данных, что упрощает понимание и диагностику проблем, связанных с батареей, прочтите Профиль использования батареи с помощью Batterystats и Battery Historian .
Проверьте машино-ориентированный вывод
Вы можете сгенерировать выходные данные batterystats
в машиночитаемом формате CSV, используя следующую команду:
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 или на уровне системы. Данные отбираются для включения на основании их полезности для анализа производительности батареи. Каждая строка представляет наблюдение со следующими элементами:
- Целое число-заполнитель
- Идентификатор пользователя, связанный с наблюдением
- Режим агрегирования:
-
i
для информации, не привязанной к статусу заряженного/незаряженного. -
l
для--charged
(использование с момента последней зарядки). -
u
для--unplugged
(использование с момента последнего отключения). Устарело в Android 5.1.1.
-
- Идентификатор раздела, определяющий, как интерпретировать последующие значения в строке.
В следующей таблице описаны различные идентификаторы разделов, которые вы можете увидеть:
Идентификатор раздела | Описание | Остальные поля |
---|---|---|
| Версия | |
| UID | |
| АПК | |
| Процесс | |
| Датчик | |
| Вибратор | |
| передний план | |
| Государственное время | |
| Блокировка пробуждения | |
| Синхронизировать | |
| Работа | |
| Блокировка пробуждения ядра | |
| Причина пробуждения | |
| Сеть | |
| Активность пользователя | |
| Батарея | |
| Разряд батареи | |
| Уровень заряда батареи | |
| Wi-Fi | |
| Глобальный Wi-Fi | |
| Глобальный Bluetooth | |
| Разное | |
| Глобальная сеть | |
| Яркость экрана | |
| Время сканирования сигнала | |
| Время силы сигнала | |
| Подсчет мощности сигнала | |
| Время подключения данных | |
| Количество подключений к данным | |
| Время состояния Wi-Fi | |
| Подсчет состояний Wi-Fi | |
| Время состояния соискателя Wi-Fi | |
| Число состояний соискателя Wi-Fi | |
| Время силы сигнала Wi-Fi | |
| Подсчет уровня сигнала Wi-Fi | |
| Время состояния Bluetooth | |
| Подсчет состояний Bluetooth | |
| Сводка по энергопотреблению | |
| Энергетический предмет | |
| Шаг разряда | |
| Шаг зарядки | |
| Оставшееся время разряда | |
| Оставшееся время зарядки | |
Примечание . До версии Android 6.0 энергопотребление Bluetooth, сотовой связи и Wi-Fi отслеживалось в категории раздела m
(Разное). В Android 6.0 и более поздних версиях энергопотребление этих компонентов отслеживается в разделе pwi
(Power Use Item) с отдельными метками ( wifi
, blue
, cell
) для каждого компонента.
Просмотр распределения памяти
Вы можете проверить использование памяти вашим приложением одним из двух способов: за определенный период времени с помощью procstats
или в определенный момент времени с помощью meminfo
. В следующих разделах показано, как использовать оба метода.
прокстаты
procstats
позволяет увидеть, как ваше приложение ведет себя с течением времени, в том числе, как долго оно работает в фоновом режиме и сколько памяти оно использует в это время. Это помогает вам быстро обнаружить неэффективность и неправильное поведение вашего приложения, например утечки памяти, которые могут повлиять на его работу, особенно при работе на устройствах с низким объемом памяти. Его дамп состояния отображает статистику о времени выполнения каждого приложения, размере пропорционального набора (PSS), размере уникального набора (USS) и размере постоянного набора (RSS).
Чтобы получить статистику использования памяти приложения за последние три часа в удобочитаемом формате, выполните следующую команду:
adb shell dumpsys procstats --hours 3
Как показано в следующем примере, выходные данные отображают процент времени, в течение которого приложение работало, а также PSS, USS и RSS в виде minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS/minRSS-avgRSS-maxRSS
по количеству выборок.
AGGREGATED OVER LAST 3 HOURS: * com.android.systemui / u0a37 / v28: TOTAL: 100% (15MB-16MB-17MB/7.7MB-8.7MB-9.4MB/7.7MB-9.6MB-84MB over 178) Persistent: 100% (15MB-16MB-17MB/7.7MB-8.7MB-9.4MB/7.7MB-9.6MB-84MB over 178) * com.android.se / 1068 / v28: TOTAL: 100% (2.8MB-2.9MB-2.9MB/300KB-301KB-304KB/304KB-22MB-33MB over 3) Persistent: 100% (2.8MB-2.9MB-2.9MB/300KB-301KB-304KB/304KB-22MB-33MB over 3) * com.google.android.gms.persistent / u0a7 / v19056073: TOTAL: 100% (37MB-38MB-40MB/27MB-28MB-29MB/124MB-125MB-126MB over 2) Imp Fg: 100% (37MB-38MB-40MB/27MB-28MB-29MB/124MB-125MB-126MB over 2) ... * com.android.gallery3d / u0a62 / v40030: TOTAL: 0.01% Receiver: 0.01% (Cached): 54% (6.4MB-6.5MB-6.9MB/4.4MB-4.4MB-4.4MB/4.4MB-26MB-68MB over 6) * com.google.android.tvlauncher / u0a30 / v1010900130: TOTAL: 0.01% Receiver: 0.01% (Cached): 91% (5.8MB-13MB-14MB/3.5MB-10MB-12MB/12MB-33MB-78MB over 6) * com.android.vending:instant_app_installer / u0a16 / v81633968: TOTAL: 0.01% Receiver: 0.01% (Cached): 100% (14MB-15MB-16MB/3.8MB-4.2MB-5.1MB/3.8MB-30MB-95MB over 7) ... 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
меминфо
Вы можете записать снимок того, как память вашего приложения распределяется между различными типами распределения ОЗУ, с помощью следующей команды:
adb shell dumpsys meminfo package_name|pid [-d]
Флаг -d
выводит дополнительную информацию, связанную с использованием памяти Dalvik и ART.
В выходных данных перечислены все текущие выделения вашего приложения, измеренные в килобайтах.
При проверке этой информации вы должны быть знакомы со следующими типами распределения:
- Частная (чистая и грязная) оперативная память
- Это память, которая используется только вашим процессом. Это основная часть оперативной памяти, которую система может освободить, когда процесс вашего приложения будет уничтожен. Как правило, наиболее важной частью является частная «грязная» оперативная память, которая является самой дорогой, поскольку она используется только вашим процессом и поскольку ее содержимое существует только в оперативной памяти, поэтому ее нельзя выгрузить в хранилище, поскольку Android не использует менять. Все выделения кучи, которые вы выполняете в Dalvik и в собственном коде, представляют собой частную «грязную» оперативную память. Dalvik и собственные ресурсы, которые вы разделяете с процессом Zygote, представляют собой общую грязную оперативную память.
- Пропорциональный размер набора (PSS)
- Это показатель использования оперативной памяти вашего приложения, который учитывает совместное использование страниц между процессами. Любые страницы оперативной памяти, уникальные для вашего процесса, напрямую влияют на его значение PSS, в то время как страницы, которые используются совместно с другими процессами, вносят вклад в значение PSS только пропорционально объему совместного использования. Например, страница, совместно используемая двумя процессами, вносит половину своего размера в PSS каждого процесса.
Особенностью измерения PSS является то, что вы можете сложить PSS для всех процессов, чтобы определить фактический объем памяти, используемый всеми процессами. Это означает, что PSS является хорошим показателем фактического веса ОЗУ процесса и для сравнения с использованием ОЗУ другими процессами и общим объемом доступной ОЗУ.
Например, ниже приведены выходные данные процесса Map на устройстве 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
Вот старый dumpsys
Dalvik приложения Gmail:
** 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 Total
и Private Dirty
. В некоторых случаях столбцы Private Clean
и Heap Alloc
также предоставляют интересные данные.
Ниже представлена дополнительная информация о различных распределениях памяти, которые вам следует соблюдать:
-
Dalvik Heap
- Оперативная память, используемая выделениями Dalvik в вашем приложении.
Pss Total
включает все распределения Zygote, взвешенные по их совместному использованию между процессами, как описано в определении PSS.Private Dirty
число — это фактический объем оперативной памяти, выделенный только для «кучи» вашего приложения, состоящий из ваших собственных выделений и любых страниц распределения Zygote, которые были изменены после отделения процесса вашего приложения от Zygote.Примечание. В новых версиях платформы, имеющих раздел
Dalvik Other
, числаPss Total
иPrivate Dirty
для Dalvik Heap не включают накладные расходы Dalvik, такие как своевременная компиляция (JIT) и GC-бухгалтерия, тогда как в более старых версиях список все это объединено подDalvik
.Heap Alloc
— это объем памяти, который Dalvik и собственные распределители кучи отслеживают для вашего приложения. Это значение больше, чемPss Total
иPrivate Dirty
поскольку ваш процесс был ответвлен от Zygote и включает в себя выделения, которые ваш процесс разделяет со всеми остальными. -
.so mmap
и.dex mmap
- ОЗУ используется для отображаемого кода
.so
(собственный) и.dex
(Dalvik или ART).Pss Total
включает код платформы, общий для всех приложений.Private Clean
— это собственный код вашего приложения. Как правило, фактический отображаемый размер больше. Здесь ОЗУ — это только то, что в данный момент должно находиться в ОЗУ для кода, выполняемого приложением. Однако файл.so mmap
имеет большую частную ошибку, вызванную исправлениями в собственном коде при загрузке по конечному адресу. -
.oat mmap
- Это объем оперативной памяти, используемый образом кода. Он основан на предварительно загруженных классах, обычно используемых несколькими приложениями. Это изображение используется всеми приложениями и не зависит от конкретных приложений.
-
.art mmap
- Это объем оперативной памяти, используемый образом кучи. Он основан на предварительно загруженных классах, обычно используемых несколькими приложениями. Это изображение используется всеми приложениями и не зависит от конкретных приложений. Несмотря на то, что изображение ART содержит экземпляры
Object
, они не учитываются при определении размера кучи. -
.Heap
(только с флагом-d
) - Это объем кучи памяти вашего приложения. Это исключает объекты на изображении и пространства больших объектов, но включает пространство зиготы и неподвижное пространство.
-
.LOS
(только с флагом-d
) - Это объем оперативной памяти, используемый пространством больших объектов ART. Сюда входят крупные объекты-зиготы. Большие объекты — это все примитивные массивы размером более 12 КБ.
-
.GC
(только с флагом-d
) - Это накладные расходы на вывоз мусора. Нет никакого способа уменьшить эти накладные расходы.
-
.JITCache
(только с флагом-d
) - Это объем памяти, используемый JIT-данными и кэшами кода. Обычно это ноль, поскольку все приложения компилируются во время установки.
-
.Zygote
(только с флагом-d
) - Это объем памяти, используемый пространством зиготы. Пространство Zygote создается во время запуска устройства и никогда не выделяется.
-
.NonMoving
(только с флагом-d
) - Это объем оперативной памяти, используемый недвижимым пространством ART. Неподвижное пространство содержит специальные неподвижные объекты, такие как поля и методы. Вы можете уменьшить этот раздел, используя меньше полей и методов в своем приложении.
-
.IndirectRef
(только с флагом-d
) - Это объем оперативной памяти, используемый таблицами косвенной ссылки ART. Обычно эта сумма невелика, но если она слишком велика, ее можно уменьшить, уменьшив количество используемых локальных и глобальных ссылок JNI.
-
Unknown
- Любые страницы ОЗУ, которые система не смогла отнести к одному из более конкретных элементов. В настоящее время он содержит в основном собственные выделения, которые не могут быть идентифицированы инструментом при сборе этих данных из-за рандомизации макета адресного пространства (ASLR). Как и в случае с кучей Dalvik,
Pss Total
forUnknown
учитывает совместное использование с Zygote, аPrivate Dirty
— это неизвестная оперативная память, выделенная только для вашего приложения. -
TOTAL
- Общий объем оперативной памяти пропорционального набора (PSS), используемый вашим процессом. Это сумма всех полей PSS над ним. Он указывает общий вес памяти вашего процесса, который можно напрямую сравнить с другими процессами и общим объемом доступной оперативной памяти.
Private Dirty
иPrivate Clean
— это общие распределения внутри вашего процесса, которые не используются другими процессами. Когда ваш процесс уничтожается, вся оперативная память из этих выделений возвращается обратно в систему.Private Clean
также можно выгрузить и освободить до уничтожения процесса, ноPrivate Dirty
высвобождается только после уничтожения процесса.Грязная оперативная память — это страницы, которые были изменены и поэтому должны оставаться в оперативной памяти, поскольку обмен не выполняется. Чистая ОЗУ — это страницы, которые были сопоставлены из постоянного файла, например исполняемого кода, и могут быть выгружены, если не используются какое-то время.
-
ViewRootImpl
- Количество корневых представлений, активных в вашем процессе. Каждое корневое представление связано с окном, поэтому это может помочь вам выявить утечки памяти, связанные с диалоговыми окнами или другими окнами.
-
AppContexts
иActivities
- Количество объектов
Context
иActivity
приложения, которые в настоящее время находятся в вашем процессе. Это может помочь вам быстро идентифицировать просочившиеся объектыActivity
, которые невозможно утилизировать из-за статических ссылок на них, что является обычным явлением. С этими объектами часто связано множество других выделений, что делает их хорошим способом отслеживания крупных утечек памяти.