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 الذي يعمل على الجهاز المتصل. توضّح الأقسام التالية نوع المعلومات التي تظهر لك عادةً.
حالة 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 ...
إدخال حالة القارئ
تتحمّل 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
كما هو مطلوب، يعني ذلك أنّ ملف ملفBuiltInKeyboardId
مفقود لتخطيط الأحرف الخاصة بمفاتيح لوحة المفاتيح الخاصة بالوظائف. يجب أن تحتوي لوحات المفاتيح الخاصة على ملفات لخرائط أحرف المفاتيح لا تحتوي إلا على الرمز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"}]
إحصاءات "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 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.
-
- معرّف القسم الذي يحدّد كيفية تفسير القيم اللاحقة في السطر
يوضّح الجدول التالي معرّفات الأقسام المختلفة التي قد تظهر لك:
معرّف القسم | الوصف | الحقول المتبقية |
---|---|---|
|
الإصدار |
|
|
UID |
" |
|
APK |
|
|
معالجة |
|
|
أداة استشعار |
" |
|
هزاز |
" |
|
واجهة |
" |
|
توقيت الولاية |
" |
|
قفل التنشيط |
|
|
المزامنة |
" |
|
الوظيفة |
" |
|
قفل التنشيط في النواة |
" |
|
سبب الاستيقاظ |
" |
|
الشبكة |
|
|
نشاط المستخدم |
" |
|
البطارية |
|
|
تفريغ البطارية |
|
|
مستوى البطارية |
" |
|
Wi-Fi |
|
|
شبكة Wi-Fi في جميع أنحاء العالم |
|
|
بلوتوث عالمي |
|
|
إعدادات متنوّعة |
|
|
الشبكة العالمية |
|
|
سطوع الشاشة |
|
|
وقت فحص الإشارة |
|
|
وقت قوة الإشارة |
|
|
عدد نقاط قوة الإشارة |
|
|
مدة اتصال البيانات |
|
|
عدد اتصالات البيانات |
|
|
وقت حالة شبكة Wi-Fi |
|
|
عدد حالات شبكة Wi-Fi |
|
|
وقت حالة طلب Wi-Fi |
|
|
عدد حالات طلب شبكة Wi-Fi |
|
|
وقت قوة إشارة Wi-Fi |
|
|
عدد نقاط قوة إشارة Wi-Fi |
|
|
وقت حالة البلوتوث |
|
|
عدد حالات البلوتوث |
|
|
ملخّص استخدام الطاقة |
|
|
عنصر استخدام الطاقة |
" |
|
خطوة التفريغ |
|
|
خطوة تحصيل الرسوم |
|
|
الوقت المتبقّي لتفريغ البطارية |
|
|
الوقت المتبقي لشحن البطارية |
|
ملاحظة: قبل الإصدار 6.0 من نظام Android، كان يتم تتبُّع استهلاك الطاقة في
الراديو اللاسلكي وشبكة الجوّال وWi-Fi ضمن فئة القسم m
(غير ذلك).
في الإصدار 6.0 من نظام التشغيل Android والإصدارات الأحدث، يتم قياس استهلاك الطاقة لهذه المكوّنات
في قسم pwi
(عنصر استهلاك الطاقة) باستخدام تصنيفات فردية
(wifi
وblue
وcell
) لكل مكوّن.
عرض عمليات تخصيص الذاكرة
يمكنك فحص استخدام تطبيقك للذاكرة بطريقتَين: على مدار فترة
زمنية باستخدام procstats
أو في وقت معيّن باستخدام meminfo
.
توضّح لك الأقسام التالية كيفية استخدام كلتا الطريقتَين.
procstats
تتيح لك أداة 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
meminfo
يمكنك تسجيل لقطة لكيفية تقسيم ذاكرة تطبيقك بين أنواع مختلفة من عمليات تخصيص ذاكرة الوصول العشوائي باستخدام العبارة التالية:
adb shell dumpsys meminfo [-d] package_name|pid
يطبع العلامة -d
المزيد من المعلومات ذات الصلة باستخدام الذاكرة في Dalvik وART.
تُطبع العلامة -h
جميع العلامات المتوافقة.
يسرد الإخراج جميع عمليات تخصيص الذاكرة الحالية لتطبيقك، ويتم قياسها بالكلمات اللاتينية كيلوبايت.
عند فحص هذه المعلومات، يجب أن تكون على دراية بالأنواع التالية من عمليات التوزيع:
- ذاكرة الوصول العشوائي الخاصة (النظيفة وغير النظيفة)
- هذه هي الذاكرة التي تستخدمها العملية فقط. هذه هي الجزء الأكبر من ذاكرة الوصول العشوائي التي يمكن للنظام استعادتها عند إنهاء عملية تطبيقك. بشكل عام، يتمثل الجزء الأكثر أهمية من ذلك في الذاكرة الخاصة التي تم تعديلها في ذاكرة الوصول العشوائي، والتي تُعدّ الأكثر تكلفة لأنّها لا تستخدم إلا في عملية التطبيق، ولأنّ المحتوى الخاص بها لا يتوفّر إلا في ذاكرة الوصول العشوائي، لذا لا يمكن نقله إلى مساحة التخزين، لأنّ نظام التشغيل Android لا يستخدم ميزة التبديل. إنّ جميع عمليات تخصيص الذاكرة العشوائية في Dalvik والذاكرة العشوائية الأصلية التي تجريها هي ذاكرة RAM خاصة متسخة. إنّ عمليات تخصيص Dalvik والبرامج الأصلية التي تشاركها مع عملية Zygote تتم مشاركتها في ذاكرة الوصول العشوائي غير الصالحة.
- حجم المجموعة النسبي (PSS)
- هذا مقياس لاستخدام ذاكرة الوصول العشوائي في تطبيقك، ويأخذ في الاعتبار مشاركة الصفحات في جميع العمليات. تساهم أي صفحات ذاكرة وصول عشوائي فريدة لعمليتك مباشرةً في قيمة PSS، في حين تساهم الصفحات التي تتم مشاركتها مع عمليات أخرى في قيمة PSS فقط بما يتناسب مع مقدار المشاركة. على سبيل المثال، تساهم صفحة مشترَكة بين عمليتَين بنصف حجمها في ملف PSS لكل عملية.
من سمات قياس PSS أنّه يمكنك جمع قيمة PSS على مستوى جميع العمليات لتحديد الذاكرة الفعلية التي تستخدمها جميع العمليات. وهذا يعني أنّه يمكن استخدام مقياس PSS لقياس حجم ذاكرة الوصول العشوائي الفعلي لعملية معيّنة وللمقارنة مع استخدام ذاكرة الوصول العشوائي للعمليات الأخرى وإجمالي ذاكرة الوصول العشوائي المتاحة.
على سبيل المثال، في ما يلي الإخراج لعملية "خرائط Google" على جهاز Nexus 5:
adb shell dumpsys meminfo -d com.google.android.apps.maps
ملاحظة: قد تختلف المعلومات التي تظهر لك قليلاً عن المعلومات المعروضة هنا، لأنّ بعض تفاصيل النتيجة تختلف من إصدار لآخر من منصّة الإعلان.
** 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 المؤقتة النفقات العامة لخدمة Dalvik، مثل compiling (JIT) وGC bookkeeping، في حين أنّ الإصدارات القديمة تعرض كل ذلك معًا ضمن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
- أي صفحات ذاكرة وصول عشوائي لم يتمكّن النظام من تصنيفها ضمن أحد العناصر الأخرى الأكثر تحديدًا في الوقت الحالي، يتضمّن هذا القسم بشكل أساسي عمليات تخصيص ذاكرة أساسية، ولا يمكن للّأداة تحديدها عند جمع هذه البيانات بسبب ميزة "تخصيص مساحة العناوين بشكل عشوائي" (ASLR). مثل حزمة Dalvik، يأخذ
Pss Total
لأجلUnknown
في الاعتبار المشاركة مع Zygote، وPrivate Dirty
هي ذاكرة وصول عشوائي غير معروفة مخصّصة لتطبيقك فقط. TOTAL
- إجمالي ذاكرة الوصول العشوائي (RAM) ذات الحجم النسبي (PSS) التي تستخدمها العملية هذا هو
مجموع جميع حقول PSS أعلاه. ويشير ذلك إلى إجمالي استهلاك الذاكرة في
عمليتك، والذي يمكن مقارنته مباشرةً بالعمليات الأخرى وإجمالي
ذاكرة الوصول العشوائي المتوفّرة.
Private Dirty
وPrivate Clean
هما إجمالي الاستقطاعات ضمن عملية المعالجة، والتي لا تتم مشاركتها مع العمليات الأخرى. عند إنهاء العملية، يتم إعادة كل ذاكرة الوصول العشوائي المخصّصة إليها إلى النظام. يمكن أيضًا إخراجPrivate Clean
من الذاكرة وإطلاقه قبل إتلاف العملية، ولكن يتم إطلاقPrivate Dirty
فقط عند إتلاف العملية.ذاكرة الوصول العشوائي غير النظيفة هي الصفحات التي تم تعديلها، لذا يجب أن تظل مخصّصة لذاكرة الوصول العشوائي لأنّه ليس هناك مساحة تخزين مؤقت. ذاكرة الوصول العشوائي (RAM) النظيفة هي الصفحات التي تم ربطها من ملف دائم، مثل التعليمات البرمجية التي يتم تنفيذها، ويمكن إخراجها من الذاكرة إذا لم يتم استخدامها لفترة.
ViewRootImpl
- عدد مشاهدات الجذر النشطة في عملية الربط يكون كل عرض جذر مرتبطًا بنافذة، ما يمكن أن يساعدك في تحديد تسرب الذاكرة الذي يشمل مربّعات الحوار أو النوافذ الأخرى.
AppContexts
وActivities
- عدد عناصر
Context
وActivity
التطبيق التي يتم عرضها حاليًا في عملية التنفيذ يمكن أن يساعدك ذلك في تحديد العناصرActivity
التي تم تسريبها والتي لا يمكن جمعها بسبب المراجع الثابتة عليها، وهو أمر شائع. غالبًا ما تتضمّن هذه العناصر العديد من عمليات تخصيص موارد أخرى مرتبطة بها، ما يجعلها طريقة جيدة لتتبُّع تسرُّب الذاكرة بشكل كبير.