يلخص هذا القسم الأدوات المفيدة والأوامر ذات الصلة لتصحيح الأخطاء وتعقبها وتوصيف رمز نظام Android الأساسي عند تطوير ميزات على مستوى النظام الأساسي.
ملاحظة: توصي الصفحات الموجودة في هذا القسم وفي أي مكان آخر داخل هذا الموقع باستخدام adb
جنبًا إلى جنب مع وسيطة setprop
لتصحيح بعض جوانب Android. في الإصدار Android 7.x والإصدارات الأقدم ، كان الحد الأقصى للطول لأسماء الخصائص هو 32 حرفًا. هذا يعني أنه لإنشاء خاصية التفاف باسم التطبيق ، كان من الضروري اقتطاع الاسم ليلائم. في Android 8.0 والإصدارات الأحدث ، يكون هذا الحد أكبر بكثير ولا يجب اقتطاعه.
تغطي هذه الصفحة الأساسيات المحيطة بتفريغ الأعطال الموجودة في إخراج logcat. تحتوي الصفحات الأخرى على مزيد من التفاصيل حول تشخيص الأعطال الأصلية ، واستكشاف خدمات النظام باستخدام dumpsys
، وعرض الذاكرة الأصلية ، والشبكة ، واستخدام ذاكرة الوصول العشوائي ، واستخدام AddressSanitizer لاكتشاف أخطاء الذاكرة في التعليمات البرمجية الأصلية ، وتقييم مشكلات الأداء (بما في ذلك النظام ) ، واستخدام مصححات الأخطاء .
مقالب الأعطال وشواهد القبور
عند بدء تشغيل ملف تنفيذي مرتبط ديناميكيًا ، يتم تسجيل العديد من معالجات الإشارة والتي ، في حالة حدوث عطل ، تتسبب في كتابة تفريغ تعطل أساسي إلى logcat وملف علامة مميزة أكثر تفصيلاً ليتم كتابتها إلى /data/tombstones/
. علامة القبر عبارة عن ملف يحتوي على بيانات إضافية حول العملية المعطلة. على وجه الخصوص ، يحتوي على تتبعات مكدس لجميع الخيوط في عملية التعطل (وليس فقط الخيط الذي التقط الإشارة) ، وخريطة ذاكرة كاملة ، وقائمة بجميع واصفات الملفات المفتوحة.
قبل الإصدار Android 8.0 ، تم التعامل مع الأعطال بواسطة شيطان debuggerd
و debuggerd64
. في نظام التشغيل Android 8.0 والإصدارات الأحدث ، يتم إنتاج كل من كراش crash_dump32
و crash_dump64
حسب الحاجة.
من الممكن أن يتم إرفاق شاحنة lldb
strace
حدوث تفريغ الأعطال.
مثال الناتج (مع إزالة الطوابع الزمنية والمعلومات الدخيلة):
*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** Build fingerprint: 'Android/aosp_angler/angler:7.1.1/NYC/enh12211018:eng/test-keys' Revision: '0' ABI: 'arm' pid: 17946, tid: 17949, name: crasher >>> crasher <<< signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xc r0 0000000c r1 00000000 r2 00000000 r3 00000000 r4 00000000 r5 0000000c r6 eccdd920 r7 00000078 r8 0000461a r9 ffc78c19 sl ab209441 fp fffff924 ip ed01b834 sp eccdd800 lr ecfa9a1f pc ecfd693e cpsr 600e0030 backtrace: #00 pc 0004793e /system/lib/libc.so (pthread_mutex_lock+1) #01 pc 0001aa1b /system/lib/libc.so (readdir+10) #02 pc 00001b91 /system/xbin/crasher (readdir_null+20) #03 pc 0000184b /system/xbin/crasher (do_action+978) #04 pc 00001459 /system/xbin/crasher (thread_callback+24) #05 pc 00047317 /system/lib/libc.so (_ZL15__pthread_startPv+22) #06 pc 0001a7e5 /system/lib/libc.so (__start_thread+34) Tombstone written to: /data/tombstones/tombstone_06
يعطي السطر الأخير من الإخراج موقع شاهد القبر الكامل على القرص.
إذا كان لديك الثنائيات غير المجمعة المتاحة ، يمكنك الحصول على استرخاء أكثر تفصيلاً بمعلومات رقم السطر عن طريق لصق المكدس في development/scripts/stack
:
development/scripts/stack
نصيحة: للراحة ، إذا قمت بتشغيل lunch
، فإن stack
موجود بالفعل على $PATH
الخاص بك ، لذلك لا تحتاج إلى توفير المسار الكامل.
مثال على الإخراج (بناءً على إخراج logcat أعلاه):
Reading native crash info from stdin 03-02 23:53:49.477 17951 17951 F DEBUG : *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** 03-02 23:53:49.477 17951 17951 F DEBUG : Build fingerprint: 'Android/aosp_angler/angler:7.1.1/NYC/enh12211018:eng/test-keys' 03-02 23:53:49.477 17951 17951 F DEBUG : Revision: '0' 03-02 23:53:49.477 17951 17951 F DEBUG : ABI: 'arm' 03-02 23:53:49.478 17951 17951 F DEBUG : pid: 17946, tid: 17949, name: crasher >>> crasher <<< 03-02 23:53:49.478 17951 17951 F DEBUG : signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xc 03-02 23:53:49.478 17951 17951 F DEBUG : r0 0000000c r1 00000000 r2 00000000 r3 00000000 03-02 23:53:49.478 17951 17951 F DEBUG : r4 00000000 r5 0000000c r6 eccdd920 r7 00000078 03-02 23:53:49.478 17951 17951 F DEBUG : r8 0000461a r9 ffc78c19 sl ab209441 fp fffff924 03-02 23:53:49.478 17951 17951 F DEBUG : ip ed01b834 sp eccdd800 lr ecfa9a1f pc ecfd693e cpsr 600e0030 03-02 23:53:49.491 17951 17951 F DEBUG : 03-02 23:53:49.491 17951 17951 F DEBUG : backtrace: 03-02 23:53:49.492 17951 17951 F DEBUG : #00 pc 0004793e /system/lib/libc.so (pthread_mutex_lock+1) 03-02 23:53:49.492 17951 17951 F DEBUG : #01 pc 0001aa1b /system/lib/libc.so (readdir+10) 03-02 23:53:49.492 17951 17951 F DEBUG : #02 pc 00001b91 /system/xbin/crasher (readdir_null+20) 03-02 23:53:49.492 17951 17951 F DEBUG : #03 pc 0000184b /system/xbin/crasher (do_action+978) 03-02 23:53:49.492 17951 17951 F DEBUG : #04 pc 00001459 /system/xbin/crasher (thread_callback+24) 03-02 23:53:49.492 17951 17951 F DEBUG : #05 pc 00047317 /system/lib/libc.so (_ZL15__pthread_startPv+22) 03-02 23:53:49.492 17951 17951 F DEBUG : #06 pc 0001a7e5 /system/lib/libc.so (__start_thread+34) 03-02 23:53:49.492 17951 17951 F DEBUG : Tombstone written to: /data/tombstones/tombstone_06 Reading symbols from /huge-ssd/aosp-arm64/out/target/product/angler/symbols Revision: '0' pid: 17946, tid: 17949, name: crasher >>> crasher <<< signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 0xc r0 0000000c r1 00000000 r2 00000000 r3 00000000 r4 00000000 r5 0000000c r6 eccdd920 r7 00000078 r8 0000461a r9 ffc78c19 sl ab209441 fp fffff924 ip ed01b834 sp eccdd800 lr ecfa9a1f pc ecfd693e cpsr 600e0030 Using arm toolchain from: /huge-ssd/aosp-arm64/prebuilts/gcc/linux-x86/arm/arm-linux-androideabi-4.9/bin/ Stack Trace: RELADDR FUNCTION FILE:LINE 0004793e pthread_mutex_lock+2 bionic/libc/bionic/pthread_mutex.cpp:515 v------> ScopedPthreadMutexLocker bionic/libc/private/ScopedPthreadMutexLocker.h:27 0001aa1b readdir+10 bionic/libc/bionic/dirent.cpp:120 00001b91 readdir_null+20 system/core/debuggerd/crasher.cpp:131 0000184b do_action+978 system/core/debuggerd/crasher.cpp:228 00001459 thread_callback+24 system/core/debuggerd/crasher.cpp:90 00047317 __pthread_start(void*)+22 bionic/libc/bionic/pthread_create.cpp:202 (discriminator 1) 0001a7e5 __start_thread+34 bionic/libc/bionic/clone.cpp:46 (discriminator 1)
يمكنك استخدام stack
على شاهد قبر كامل. مثال:
stack < FS/data/tombstones/tombstone_05
يكون هذا مفيدًا إذا كنت قد قمت للتو بفك ضغط تقرير خطأ في الدليل الحالي. لمزيد من المعلومات حول تشخيص الأعطال الأصلية وشواهد القبور ، راجع تشخيص الأعطال الأصلية .
الحصول على تتبع مكدس / علامة مميزة من عملية قيد التشغيل
يمكنك استخدام أداة debuggerd
للحصول على تفريغ مكدس من عملية قيد التشغيل. من سطر الأوامر ، استدعاء debuggerd
باستخدام معرف عملية (PID) لتفريغ علامة كاملة إلى stdout
. للحصول على المكدس فقط لكل مؤشر ترابط في العملية ، قم بتضمين العلامة -b
أو --backtrace
.
فهم استرخاء معقد
عندما يتعطل أحد التطبيقات ، يميل المكدس إلى أن يكون معقدًا جدًا. يوضح المثال التفصيلي التالي العديد من التعقيدات:
#00 pc 00000000007e6918 /system/priv-app/Velvet/Velvet.apk (offset 0x346b000) #01 pc 00000000001845cc /system/priv-app/Velvet/Velvet.apk (offset 0x346b000) #02 pc 00000000001847e4 /system/priv-app/Velvet/Velvet.apk (offset 0x346b000) #03 pc 00000000001805c0 /system/priv-app/Velvet/Velvet.apk (offset 0x346b000) (Java_com_google_speech_recognizer_AbstractRecognizer_nativeRun+176)
الإطارات # 00– # 03 هي من كود JNI الأصلي الذي تم تخزينه غير مضغوط في APK لتوفير مساحة على القرص بدلاً من استخراجه في ملف .so
منفصل. لا يحتاج برنامج فك المكدس في Android 9 والإصدارات الأحدث إلى ملف .so
المستخرج للتعامل مع هذه الحالة الشائعة الخاصة بنظام Android.
لا تحتوي الإطارات # 00– # 02 على أسماء رموز لأن المطور قد نزعها.
يوضح الإطار # 03 أنه حيثما تتوفر الرموز ، يستخدمها برنامج فك اللفة.
#04 pc 0000000000117550 /data/dalvik-cache/arm64/system@priv-app@Velvet@Velvet.apk@classes.dex (offset 0x108000) (com.google.speech.recognizer.AbstractRecognizer.nativeRun+160)
الإطار # 04 هو كود Java تم تجميعه مسبقًا. كان من الممكن أن يتوقف برنامج فك اللفة القديم هنا ، غير قادر على الاسترخاء عبر Java.
#05 pc 0000000000559f88 /system/lib64/libart.so (art_quick_invoke_stub+584) #06 pc 00000000000ced40 /system/lib64/libart.so (art::ArtMethod::Invoke(art::Thread*, unsigned int*, unsigned int, art::JValue*, char const*)+200) #07 pc 0000000000280cf0 /system/lib64/libart.so (art::interpreter::ArtInterpreterToCompiledCodeBridge(art::Thread*, art::ArtMethod*, art::ShadowFrame*, unsigned short, art::JValue*)+344) #08 pc 000000000027acac /system/lib64/libart.so (bool art::interpreter::DoCall<false, false>(art::ArtMethod*, art::Thread*, art::ShadowFrame&, art::Instruction const*, unsigned short, art::JValue*)+948) #09 pc 000000000052abc0 /system/lib64/libart.so (MterpInvokeDirect+296) #10 pc 000000000054c614 /system/lib64/libart.so (ExecuteMterpImpl+14484)
الإطارات # 05– # 10 مأخوذة من تطبيق مترجم ART. قد يعرض فك المكدس في الإصدارات الأقل من Android 9 هذه الإطارات بدون سياق الإطار رقم 11 الذي يوضح الكود الذي كان المترجم يفسره. هذه الإطارات مفيدة إذا كنت تقوم بتصحيح أخطاء ART نفسها. إذا كنت تقوم بتصحيح أخطاء تطبيق ما ، فيمكنك تجاهلها. بعض الأدوات ، مثل simpleperf
، تحذف هذه الإطارات تلقائيًا.
#11 pc 00000000001992d6 /system/priv-app/Velvet/Velvet.apk (offset 0x26cf000) (com.google.speech.recognizer.AbstractRecognizer.run+18)
الإطار # 11 هو كود Java الذي يتم تفسيره.
#12 pc 00000000002547a8 /system/lib64/libart.so (_ZN3art11interpreterL7ExecuteEPNS_6ThreadERKNS_20CodeItemDataAccessorERNS_11ShadowFrameENS_6JValueEb.llvm.780698333+496) #13 pc 000000000025a328 /system/lib64/libart.so (art::interpreter::ArtInterpreterToInterpreterBridge(art::Thread*, art::CodeItemDataAccessor const&, art::ShadowFrame*, art::JValue*)+216) #14 pc 000000000027ac90 /system/lib64/libart.so (bool art::interpreter::DoCall<false, false>(art::ArtMethod*, art::Thread*, art::ShadowFrame&, art::Instruction const*, unsigned short, art::JValue*)+920) #15 pc 0000000000529880 /system/lib64/libart.so (MterpInvokeVirtual+584) #16 pc 000000000054c514 /system/lib64/libart.so (ExecuteMterpImpl+14228)
الإطارات # 12– # 16 هي تطبيق المترجم الفوري نفسه.
#17 pc 00000000002454a0 /system/priv-app/Velvet/Velvet.apk (offset 0x1322000) (com.google.android.apps.gsa.speech.e.c.c.call+28)
الإطار رقم 17 هو كود Java الذي يتم تفسيره. تتوافق طريقة Java هذه مع إطارات المترجم رقم 12– # 16.
#18 pc 00000000002547a8 /system/lib64/libart.so (_ZN3art11interpreterL7ExecuteEPNS_6ThreadERKNS_20CodeItemDataAccessorERNS_11ShadowFrameENS_6JValueEb.llvm.780698333+496) #19 pc 0000000000519fd8 /system/lib64/libart.so (artQuickToInterpreterBridge+1032) #20 pc 00000000005630fc /system/lib64/libart.so (art_quick_to_interpreter_bridge+92)
الإطارات # 18– # 20 هي الجهاز الظاهري نفسه ، رمز للانتقال من كود Java المترجم إلى كود Java المفسر.
#21 pc 00000000002ce44c /system/framework/arm64/boot.oat (offset 0xdc000) (java.util.concurrent.FutureTask.run+204)
Frame # 21 هي طريقة Java المترجمة التي تستدعي طريقة Java في رقم 17.
#22 pc 0000000000559f88 /system/lib64/libart.so (art_quick_invoke_stub+584) #23 pc 00000000000ced40 /system/lib64/libart.so (art::ArtMethod::Invoke(art::Thread*, unsigned int*, unsigned int, art::JValue*, char const*)+200) #24 pc 0000000000280cf0 /system/lib64/libart.so (art::interpreter::ArtInterpreterToCompiledCodeBridge(art::Thread*, art::ArtMethod*, art::ShadowFrame*, unsigned short, art::JValue*)+344) #25 pc 000000000027acac /system/lib64/libart.so (bool art::interpreter::DoCall<false, false>(art::ArtMethod*, art::Thread*, art::ShadowFrame&, art::Instruction const*, unsigned short, art::JValue*)+948) #26 pc 0000000000529880 /system/lib64/libart.so (MterpInvokeVirtual+584) #27 pc 000000000054c514 /system/lib64/libart.so (ExecuteMterpImpl+14228)
الإطارات # 22- # 27 هي تنفيذ المترجم ، مما يجعل استدعاء الطريقة من التعليمات البرمجية المفسرة إلى الطريقة المترجمة.
#28 pc 00000000003ed69e /system/priv-app/Velvet/Velvet.apk (com.google.android.apps.gsa.shared.util.concurrent.b.e.run+22)
الإطار رقم 28 هو كود Java الذي يتم تفسيره.
#29 pc 00000000002547a8 /system/lib64/libart.so (_ZN3art11interpreterL7ExecuteEPNS_6ThreadERKNS_20CodeItemDataAccessorERNS_11ShadowFrameENS_6JValueEb.llvm.780698333+496) #30 pc 0000000000519fd8 /system/lib64/libart.so (artQuickToInterpreterBridge+1032) #31 pc 00000000005630fc /system/lib64/libart.so (art_quick_to_interpreter_bridge+92)
الإطارات # 29– # 31 هي انتقال آخر بين التعليمات البرمجية المترجمة والتعليمات البرمجية المفسرة.
#32 pc 0000000000329284 /system/framework/arm64/boot.oat (offset 0xdc000) (java.util.concurrent.ThreadPoolExecutor.runWorker+996) #33 pc 00000000003262a0 /system/framework/arm64/boot.oat (offset 0xdc000) (java.util.concurrent.ThreadPoolExecutor$Worker.run+64) #34 pc 00000000002037e8 /system/framework/arm64/boot.oat (offset 0xdc000) (java.lang.Thread.run+72)
الإطارات # 32– # 34 يتم تجميع إطارات Java التي تنادي بعضها البعض مباشرة. في هذه الحالة ، يكون مكدس الاستدعاءات الأصلي هو نفسه مكدس استدعاء Java.
#35 pc 0000000000559f88 /system/lib64/libart.so (art_quick_invoke_stub+584) #36 pc 00000000000ced40 /system/lib64/libart.so (art::ArtMethod::Invoke(art::Thread*, unsigned int*, unsigned int, art::JValue*, char const*)+200) #37 pc 0000000000280cf0 /system/lib64/libart.so (art::interpreter::ArtInterpreterToCompiledCodeBridge(art::Thread*, art::ArtMethod*, art::ShadowFrame*, unsigned short, art::JValue*)+344) #38 pc 000000000027acac /system/lib64/libart.so (bool art::interpreter::DoCall<false, false>(art::ArtMethod*, art::Thread*, art::ShadowFrame&, art::Instruction const*, unsigned short, art::JValue*)+948) #39 pc 0000000000529f10 /system/lib64/libart.so (MterpInvokeSuper+1408) #40 pc 000000000054c594 /system/lib64/libart.so (ExecuteMterpImpl+14356)
الإطارات # 35- # 40 هي المترجم الفوري نفسه.
#41 pc 00000000003ed8e0 /system/priv-app/Velvet/Velvet.apk (com.google.android.apps.gsa.shared.util.concurrent.b.i.run+20)
الإطار رقم 41 هو كود Java الذي يتم تفسيره.
#42 pc 00000000002547a8 /system/lib64/libart.so (_ZN3art11interpreterL7ExecuteEPNS_6ThreadERKNS_20CodeItemDataAccessorERNS_11ShadowFrameENS_6JValueEb.llvm.780698333+496) #43 pc 0000000000519fd8 /system/lib64/libart.so (artQuickToInterpreterBridge+1032) #44 pc 00000000005630fc /system/lib64/libart.so (art_quick_to_interpreter_bridge+92) #45 pc 0000000000559f88 /system/lib64/libart.so (art_quick_invoke_stub+584) #46 pc 00000000000ced40 /system/lib64/libart.so (art::ArtMethod::Invoke(art::Thread*, unsigned int*, unsigned int, art::JValue*, char const*)+200) #47 pc 0000000000460d18 /system/lib64/libart.so (art::(anonymous namespace)::InvokeWithArgArray(art::ScopedObjectAccessAlreadyRunnable const&, art::ArtMethod*, art::(anonymous namespace)::ArgArray*, art::JValue*, char const*)+104) #48 pc 0000000000461de0 /system/lib64/libart.so (art::InvokeVirtualOrInterfaceWithJValues(art::ScopedObjectAccessAlreadyRunnable const&, _jobject*, _jmethodID*, jvalue*)+424) #49 pc 000000000048ccb0 /system/lib64/libart.so (art::Thread::CreateCallback(void*)+1120)
الإطارات # 42– # 49 هي VM نفسها. هذه المرة هو الرمز الذي يبدأ تشغيل Java على سلسلة محادثات جديدة.
#50 pc 0000000000082e24 /system/lib64/libc.so (__pthread_start(void*)+36) #51 pc 00000000000233bc /system/lib64/libc.so (__start_thread+68)
الإطارات # 50– # 51 هي الطريقة التي يجب أن تبدأ بها كل سلاسل الرسائل. هذا هو رمز بدء مؤشر ترابط libc
الجديد.