تصحيح أخطاء رمز نظام التشغيل Android الأصلي

يلخِّص هذا القسم الأدوات المفيدة والأوامر ذات الصلة لتصحيح الأخطاء وتتبُّع وتحليل الأداء لرمز نظام Android الأساسي عند تطوير الميزات على مستوى النظام الأساسي.

ملاحظة: تنصح الصفحات في هذا القسم وغيرها من الأماكن ضمن هذا الموقع الإلكتروني باستخدام adb مع الوسيطة setprop لتصحيح أخطاء جوانب معيّنة من Android. في الإصدار 7.x من نظام التشغيل Android والإصدارات الأقدم، كان الحد الأقصى لعدد أحرف أسماء المواقع هو 32 حرفًا. وهذا يعني أنّه لإنشاء خاصيّة عرض ملء الشاشة باسم التطبيق، كان من الضروري اقتطاع الاسم ليناسب المساحة. في الإصدار 8.0 من نظام التشغيل Android والإصدارات الأحدث، يكون هذا القيد أكبر بكثير ولا يتطلّب اقتطاع المحتوى.

تتناول هذه الصفحة الأساسيات المتعلّقة بنُسخ بيانات الأعطال المتوفّرة في إخراج logcat. تتضمّن الصفحات الأخرى تفاصيل أكثر بكثير حول تشخيص الأعطال الأصلية، استكشاف خدمات النظام باستخدام dumpsys، وعرض استخدام الذاكرة الأصلية، الشبكة، وذاكرة الوصول العشوائي ، واستخدام AddressSanitizer لرصد أخطاء الذاكرة في الرمز الأصلي، وتقييم مشاكل الأداء (يشمل systrace)، واستخدام أداة تصحيح الأخطاء.

ملفات "تجميع الأعطال" و"العلامات المرجعية"

عند بدء تشغيل ملف قابل للتنفيذ مرتبط ديناميكيًا، يتم تسجيل عدة معالجات إشارات تؤدي في حال حدوث تعذّر إلى كتابة ملف تفريغ بيانات أساسي للتعذّر في logcat وملف قائمة تضمين أكثر تفصيلاً في /data/tombstones/. ملف السجلّ هو ملف يحتوي على بيانات إضافية عن العملية التي تعطّلت. على وجه الخصوص، يحتوي على أثر تسلسل استدعاء الدوالّ لكل سلاسل المعالجة في عملية الأعطال (وليس فقط سلسلة المعالجة التي رصدت العلامة)، وخريطة ذاكرة كاملة، وقائمة بجميع أوصاف الملفات المفتوحة.

قبل الإصدار 8.0 من Android، كان يتم التعامل مع الأعطال من خلال خدمتَي systemd debuggerd وdebuggerd64. في الإصدار 8.0 من Android والإصدارات الأحدث، يتم إنشاء crash_dump32 وcrash_dump64 حسب الحاجة.

لا يمكن إرفاق أداة تجميع الأعطال إلا إذا لم يكن هناك أي ملف آخر مُرفَقًا، ما يعني أنّ استخدام أدوات مثل strace أو lldb يمنع حدوث عمليات تجميع الأعطال.

مثال على الإخراج (بعد إزالة الطوابع الزمنية والمعلومات غير ذات الصلة):

*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
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 المجمَّع إلى رمز Java المُفترَض.

    #21 pc 00000000002ce44c  /system/framework/arm64/boot.oat (offset 0xdc000) (java.util.concurrent.FutureTask.run+204)

الإطار 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 هي الجهاز الافتراضي نفسه. هذه المرة، هو الرمز البرمجي الذي يبدأ تشغيل 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 رمز بدء سلسلة محادثات جديدة.