dumpsys
هي أداة تعمل على أجهزة Android وتوفّر معلومات حول
خدمات النظام. يمكنك الاتصال بـ dumpsys
من سطر الأوامر باستخدام
Android Debug Bridge (ADB)
للحصول على نتائج تشخيصية لجميع خدمات النظام التي تعمل على جهاز متصل.
عادةً ما يكون هذا الناتج مُطوَّلاً أكثر مما تريد، لذا استخدِم خيارات سطر الأوامر في هذه الصفحة للحصول على مخرجات لخدمات النظام التي تريدها فقط. توضّح هذه الصفحة أيضًا طريقة استخدام 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
:
Option | الوصف |
---|---|
-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
لدمج قياسات أداء واجهة المستخدم في ممارسات الاختبار، يمكنك الاطّلاع على كتابة مقياس أداء ماكرو.
فحص بيانات تشخيص الشبكة
يؤدي تحديد خدمة 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"}]
إحصاءات "التطوير" و"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 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
للعثور على المعرّف الفريد لتطبيقك، شغِّل الأمر التالي: 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
في اختبار تطبيقك من أجل القيلولة وتطبيقات وضع الاستعداد، اطّلِع على مقالة
الاختبار باستخدام القيلولة وتطبيقات وضع الاستعداد.
في ما يلي أمر batterystats
:
adb shell dumpsys batterystats options
للاطّلاع على قائمة بالخيارات الإضافية المتاحة لـ "batterystats
"، يجب تضمين
الخيار -h
. يعرض المثال التالي إحصاءات استخدام البطارية لحزمة تطبيق محددة منذ آخر مرة تم فيها شحن الجهاز:
adb shell dumpsys batterystats --charged package-name
تتضمن المخرجات عادةً ما يلي:
- سجلّ الأحداث المتعلّقة بالبطارية
- إحصاءات عامة للجهاز
- الاستخدام التقريبي للطاقة لكل المعرّف الفريد ومكوِّن النظام
- مللي ثانية لكل تطبيق على الأجهزة الجوّالة لكل حزمة
- الإحصاءات المجمّعة للرقم التعريفي الفريد للنظام
- الإحصاءات المجمّعة للمعرّف الفريد للتطبيق
لمعرفة مزيد من المعلومات حول استخدام 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 ...
قد تكون ملاحظات استخدام البطارية حسب المعرّف الفريد أو على مستوى النظام. يتم اختيار البيانات لتضمينها بناءً على فائدتها في تحليل أداء البطارية. يمثل كل صف ملاحظة، مع العناصر التالية:
- عدد صحيح للعنصر النائب
- رقم تعريف المستخدم المرتبط بالملاحظة
- وضع التجميع:
i
للاطّلاع على معلومات غير مرتبطة بحالة تحصيل الرسوم/تحصيل الرسومl
مقابل--charged
(الاستخدام منذ آخر عملية شحن)u
لمدة--unplugged
(الاستخدام منذ آخر مرة تم فيها توصيل الجهاز بمصدر طاقة). تم إيقافها نهائيًا في Android 5.1.1.
- معرّف القسم الذي يحدد كيفية تفسير القيم اللاحقة في السطر.
يوضّح الجدول التالي معرّفات الأقسام المختلفة التي قد تظهر لك:
معرّف القسم | الوصف | الحقول المتبقية |
---|---|---|
|
الإصدار |
|
|
المعرّف الفريد |
|
|
APK |
|
|
معالجة |
|
|
أداة استشعار |
|
|
هزاز |
|
|
واجهة |
|
|
توقيت الولاية |
|
|
قفل التنشيط |
|
|
المزامنة |
|
|
المهمة |
|
|
قفل ويك نواة |
|
|
سبب الاستيقاظ |
|
|
الشبكة |
|
|
نشاط المستخدم |
|
|
البطارية |
|
|
تفريغ البطارية |
|
|
مستوى البطارية |
|
|
Wi-Fi |
|
|
شبكة Wi-Fi عالمية |
|
|
البلوتوث العام |
|
|
ميزات متنوّعة |
|
|
الشبكة العالمية |
|
|
سطوع الشاشة |
|
|
مدة البحث عن الإشارة |
|
|
وقت قوة الإشارة |
|
|
عدد قوة الإشارة |
|
|
وقت اتصال البيانات |
|
|
عدد اتصالات البيانات |
|
|
توقيت حالة Wi-Fi |
|
|
عدد حالات Wi-Fi |
|
|
توقيت ولاية Wi-Fi |
|
|
عدد حالات طلب اتصال Wi-Fi |
|
|
مدة قوة إشارة Wi-Fi |
|
|
عدد قوة إشارة Wi-Fi |
|
|
وقت حالة البلوتوث |
|
|
عدد حالات البلوتوث |
|
|
ملخّص استخدام الطاقة |
|
|
عنصر استخدام الطاقة |
|
|
خطوة التفريغ |
|
|
خطوة الشحن |
|
|
الوقت المتبقي للتفريغ |
|
|
وقت الشحن المتبقي |
|
ملاحظة: قبل الإصدار 6.0 من نظام التشغيل Android، كان يتم تتبُّع استخدام الطاقة
لراديو البلوتوث وراديو الجوّال وشبكة Wi-Fi في فئة القسم m
(متنوع). في الإصدار Android 6.0 والإصدارات الأحدث، يتم تتبُّع استهلاك هذه المكوّنات
في القسم pwi
(عنصر استخدام الطاقة) من خلال تصنيفات فردية
(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 وتخصيصات وحدات الذاكرة المؤقتة الأصلية التي تجريها عبارة عن ذاكرة وصول عشوائي خاصة غير نظيفة. تتم مشاركة ذاكرة الوصول العشوائي غير النظيفة والتوزيعات الأصلية التي تشاركها مع عملية Zygote.
- حجم المجموعة التناسبي (PSS)
- يتم قياس استخدام ذاكرة الوصول العشوائي في تطبيقك، ويراعي مشاركة الصفحات في مختلف العمليات. تساهم أي صفحات RAM خاصة بعمليتك بشكل مباشر في قيمة PSS الخاصة بها، في حين تساهم الصفحات التي تتم مشاركتها مع عمليات أخرى في قيمة PSS فقط بما يتناسب مع حجم المشاركة. على سبيل المثال، تساهم الصفحة المشتركة بين عمليتَين في نصف حجمها في نظام PSS لكل عملية.
من سمات قياس PSS أنه يمكنك جمع بيانات PSS عبر جميع العمليات لتحديد الذاكرة الفعلية التي تستخدمها جميع العمليات. وهذا يعني أن PSS هو مقياس جيد لوزن ذاكرة الوصول العشوائي الفعلي للعملية وللمقارنة مع استخدام ذاكرة الوصول العشوائي (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
إليك نسخة قديمة من 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
هو رمز التطبيق الخاص بك. وبشكلٍ عام، يكون الحجم الفعلي المرتبط أكبر من ذلك. إنّ ذاكرة الوصول العشوائي (RAM) هنا هي فقط ما تحتاج إليه حاليًا في ذاكرة الوصول العشوائي للرموز البرمجية التي تم تنفيذها بواسطة التطبيق. ومع ذلك، تحتوي.so mmap
على أخطاء خاصة بشكل كبير، وذلك بسبب إصلاحات في الرمز الأصلي عند تحميلها في عنوانها النهائي. .oat mmap
- هذا هو مقدار ذاكرة الوصول العشوائي التي تستخدمها صورة الرمز. يستند إلى الفئات المحملة مسبقًا والتي يشيع استخدامها في العديد من التطبيقات. تتم مشاركة هذه الصورة بين كل التطبيقات ولا تتأثر بتطبيقات معيّنة.
.art mmap
- هذا هو مقدار ذاكرة الوصول العشوائي التي تستخدمها الصورة في كومة الذاكرة المؤقتة. يستند إلى الفئات المحملة مسبقًا
والتي يشيع استخدامها في العديد من التطبيقات. تتم مشاركة هذه الصورة بين كل التطبيقات
ولا تتأثر بتطبيقات معيّنة. على الرغم من أنّ صورة ART تحتوي على
Object
مثيل، لا يتم احتسابها ضمن حجم كومة الذاكرة المؤقتة. .Heap
(مع علامة-d
فقط)- هذه هي مقدار كومة الذاكرة المؤقتة لتطبيقك. ويستثني ذلك العناصر في الصورة ومساحات العناصر الكبيرة، بما في ذلك مساحة Zygote والمساحة غير المتحركة.
.LOS
(مع علامة-d
فقط)- هذا هو مقدار ذاكرة الوصول العشوائي التي تستخدمها مساحة الكائن الكبيرة ART. وهذا يشمل كائنات Zygote الكبيرة. الكائنات الكبيرة هي جميع مخصصات الصفائف الأولية التي يزيد حجمها عن 12 كيلوبايت.
.GC
(مع علامة-d
فقط)- هذه هي التكلفة العامة لجمع البيانات المهملة. لا توجد طريقة لتقليل هذا النفقات العامة.
.JITCache
(مع علامة-d
فقط)- هذه هي مقدار الذاكرة التي تستخدمها بيانات التجميع أثناء التشغيل (JIT) وذاكرة التخزين المؤقت للرموز. ويكون هذا عادةً صفرًا، لأنّه يتم تجميع جميع التطبيقات وقت التثبيت.
.Zygote
(مع علامة-d
فقط)- هذا هو مقدار الذاكرة الذي تستخدمه مساحة Zygote. يتم إنشاء مساحة Zygote أثناء بدء تشغيل الجهاز ولا يتم تخصيصها مطلقًا.
.NonMoving
(مع علامة-d
فقط)- هذا هو مقدار ذاكرة الوصول العشوائي الذي تستخدمه المساحة غير المتحركة في ART. تحتوي المساحة غير المتحركة على عناصر خاصة غير قابلة للنقل مثل الحقول والطرق. ويمكنك تقليل هذا القسم باستخدام عدد أقل من الحقول والطرق في تطبيقك.
.IndirectRef
(مع علامة-d
فقط)- هذه هي مقدار ذاكرة الوصول العشوائي التي تستخدمها الجداول المرجعية غير المباشرة لـ ART. عادةً ما يكون هذا المبلغ صغيرًا، ولكن إذا كان مرتفعًا جدًا، قد تتمكن من تقليله عن طريق تقليل عدد مراجع JNI المحلية والعالمية المستخدمة.
Unknown
- أي صفحات ذاكرة وصول عشوائي (RAM) لم يتمكن النظام من تصنيفها ضمن عنصر من العناصر الأخرى الأكثر تحديدًا وفي الوقت الحالي، تحتوي هذه البيانات في الغالب على تخصيصات أصلية، والتي لا يمكن للأداة التعرّف عليها عند جمع هذه البيانات بسبب الترتيب العشوائي لتخطيط مساحة العنوان (ASLR). مثل كومة الذاكرة Dalvik، تأخذ
Pss Total
forUnknown
في الاعتبار المشاركة مع Zygote، وPrivate Dirty
هي ذاكرة وصول عشوائي غير معروفة ومخصصة لتطبيقك فقط. TOTAL
- إجمالي ذاكرة الوصول العشوائي (PSS) ذات الحجم التناسبي المستخدمة في العملية: هذا هو مجموع
جميع حقول PSS أعلاها. حيث يشير إلى الوزن الإجمالي للذاكرة للعملية، والذي يمكن مقارنته مباشرةً بالعمليات الأخرى وإجمالي ذاكرة الوصول العشوائي المتاحة.
Private Dirty
وPrivate Clean
هما إجمالي التخصيصات ضمن عمليتك، ولا تتم مشاركتها مع العمليات الأخرى. وعند إتلاف العملية، تتم إعادة كل ذاكرة الوصول العشوائي (RAM) من هذه التوزيعات إلى النظام مرة أخرى. يمكن أيضًا نشرPrivate Clean
في صفحات وإطلاقه قبل أن يتم تدمير العملية، ولكن يتم إصدارPrivate Dirty
فقط بعد تدمير العمليات.ذاكرة الوصول العشوائي المتسخة هي صفحات تم تعديلها وبالتالي يجب أن تظل ملتزمة بذاكرة الوصول العشوائي (RAM) نظرًا لعدم وجود تبديل. ذاكرة الوصول العشوائي النظيفة هي الصفحات التي تم ربطها من ملف دائم، مثل تنفيذ الرمز البرمجي، ويمكن تقسيمها إلى صفحات إذا لم يتم استخدامها لفترة من الوقت.
ViewRootImpl
- عدد الملفات الشخصية الجذر النشطة في عمليتك. يرتبط كل عرض جذر بنافذة، لذا يمكن أن يساعدك ذلك في تحديد تسرب الذاكرة الذي يتضمن مربعات حوار أو نوافذ أخرى.
AppContexts
وActivities
- عدد عناصر التطبيق
Context
وActivity
الكائنات المتوفّرة حاليًا في عمليتك. ويمكن أن يساعدك ذلك في التعرّف بسرعة على عناصرActivity
المسرّبة والتي لا يمكن جمعها مع البيانات غير المرغوب فيها بسبب وجود مراجع ثابتة عليها، وهو أمر شائع. غالبًا ما تحتوي هذه الكائنات على العديد من التخصيصات الأخرى المرتبطة بها، مما يجعلها طريقة جيدة لتتبع تسربات الذاكرة الكبيرة.