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
:
الجدول 1. قائمة الخيارات المتاحة لخدمة 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
في ما يلي نموذج من الإحصاءات التفصيلية لكل معرِّف معرِّف:
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
بتنسيق 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.
- "معرّف القسم"، والذي يحدد كيفية تفسير القيم اللاحقة في السطر.
يوضّح الجدول التالي معرّفات الأقسام المختلفة التي قد تظهر لك:
الجدول 2. قائمة معرّفات الأقسام
معرّف القسم | الوصف | الحقول المتبقية |
---|---|---|
|
الإصدار |
|
|
المعرّف الفريد |
|
|
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
الاطّلاع على سلوك تطبيقك بمرور الوقت،
بما في ذلك مدة تشغيله في الخلفية وحجم الذاكرة التي يستخدمها
خلال تلك الفترة. وهو يساعدك في العثور سريعًا على نقاط الضعف والأخطاء في تطبيقك،
مثل تسرُّب الذاكرة، الذي يمكن أن يؤثر في أداء التطبيق، خاصةً عند تشغيله على أجهزة منخفضة الذاكرة. ويعرض تفريغ الحالة الخاص به إحصاءات حول وقت تشغيل كل تطبيق، وحجم المجموعة التناسبية (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.
تسرد النتيجة جميع التوزيعات الحالية لتطبيقك، ويتم قياسها بالكيلوبايت.
عند فحص هذه المعلومات، يجب أن تكون على دراية بأنواع التخصيص التالية:
- ذاكرة وصول عشوائي خاصة (نظيفة وغير نظيفة)
- هذه هي الذاكرة التي تستخدمها عمليتك فقط. هذه هي المساحة الإجمالية لذاكرة الوصول العشوائي التي يمكن للنظام استردادها عند تدمير عملية تطبيقك. بشكل عام، الجزء الأهم من ذلك هو ذاكرة الوصول العشوائي الخاصة غير النظيفة، وهي الأغلى تكلفة لأنها لا تستخدمها إلا من خلال عمليتك ومحتوياتها موجودة في ذاكرة الوصول العشوائي (RAM) فقط، لذلك لا يمكن نقلها إلى وحدة التخزين، لأن Android لا يستخدم خيار التبديل. جميع توزيعات Dalvik وتخصيصات كومة الذاكرة المؤقتة الأصلية التي تجريها هي ذاكرة وصول عشوائي خاصة غير نظيفة. Dalvik وعمليات التخصيص الأصلية التي تشاركها مع عملية Zygote عبارة عن ذاكرة وصول عشوائي (RAM) غير نظيفة.
- حجم المجموعة التناسبي (PSS)
- هذا قياس لاستخدام ذاكرة الوصول العشوائي في تطبيقك ويأخذ في الاعتبار مشاركة الصفحات في جميع العمليات. أي صفحات RAM خاصة بعمليتك تساهم بشكل مباشر في قيمة PSS الخاصة بها، في حين تساهم الصفحات التي تتم مشاركتها مع العمليات الأخرى في قيمة PSS فقط بما يتناسب مع حجم المشاركة. على سبيل المثال، تساهم الصفحة المشتركة بين عمليتين بنصف حجمها في PS لكل عملية.
من خصائص قياس 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
الخاصة بـUnknown
في الاعتبار المشاركة مع Zygote، وPrivate Dirty
هي ذاكرة وصول عشوائي غير معروفة مخصّصة لتطبيقك فقط. TOTAL
- إجمالي ذاكرة الوصول العشوائي (PSS) التي تستخدم حجم المجموعات التناسبية التي تستخدمها عمليتك. هذا هو مجموع
جميع حقول PSS فوقه. يشير إلى الحجم الإجمالي للذاكرة للعملية، والذي يمكن مقارنته مباشرة بالعمليات الأخرى وإجمالي ذاكرة الوصول العشوائي المتاحة.
Private Dirty
وPrivate Clean
هما إجمالي المبالغ المخصّصة ضمن عمليتك، ولا تتم مشاركتها مع عمليات أخرى. وعند تدمير العملية، يتم تحرير كل ذاكرة الوصول العشوائي (RAM) من هذه التوزيعات مرة أخرى إلى النظام. يمكن أيضًا تقسيمPrivate Clean
وإطلاقه قبل أن يتم إتلافه، ولكن لا يتم إصدارPrivate Dirty
إلا عند تدمير العملية.وذاكرة الوصول العشوائي غير النظيفة هي صفحات تم تعديلها وبالتالي يجب أن تظل ملتزمة بذاكرة الوصول العشوائي (RAM) نظرًا لعدم وجود تبديل. وذاكرة الوصول العشوائي النظيفة هي الصفحات التي تم ربطها من ملف دائم، أي يتم تنفيذ الرمز البرمجي مثلاً، ويمكن تقسيمها إلى صفحات إذا لم يتم استخدامها لفترة من الوقت.
ViewRootImpl
- عدد الملفات الشخصية الجذر النشطة في عمليتك. يرتبط كل عرض جذر بنافذة، لذا يمكن أن يساعدك ذلك في تحديد تسرب الذاكرة الذي يتضمن مربعات حوار أو نوافذ أخرى.
AppContexts
وActivities
- عدد عناصر التطبيق
Context
وActivity
الكائنات الموجودة حاليًا في عمليتك. ويساعدك ذلك في التعرّف سريعًا على عناصرActivity
التي تم تسريبها والتي لا يمكن جمعها مع البيانات غير المفيدة بسبب مراجع ثابتة لها، وهو أمر شائع. غالبًا ما تحتوي هذه الكائنات على العديد من التخصيصات الأخرى المرتبطة بها، مما يجعلها طريقة جيدة لتتبع تسرب الذاكرة الكبير.