এই বিভাগে, প্ল্যাটফর্ম-লেভেল ফিচার ডেভেলপ করার সময় নেটিভ Android প্ল্যাটফর্ম কোড ডিবাগ, ট্রেস ও প্রোফাইল করার জন্য প্রয়োজনীয় টুল ও সংশ্লিষ্ট কমান্ডের সারসংক্ষেপ দেওয়া হয়েছে।
মনে রাখবেন: এই সাইটের এই বিভাগ ও অন্যান্য জায়গায়
Android-এর নির্দিষ্ট কিছু দিক ডিবাগ করার জন্য setprop আর্গুমেন্টের সাথে
adb ব্যবহার করার সাজেশন দেওয়া হয়েছে।
Android 7.x ও এর আগের ভার্সনে, প্রপার্টির নামের দৈর্ঘ্য ৩২
অক্ষরের মধ্যে সীমাবদ্ধ ছিল। এর অর্থ হল, অ্যাপের নাম দিয়ে র্যাপ প্রপার্টি তৈরি করতে,
নামটি ছোট করে নিতে হবে। Android 8.0 এবং তার পরবর্তী যেকোনও ভার্সনে, এই
সীমা অনেক বেশি এবং ট্রাঙ্কেশন করার প্রয়োজন হয় না।
এই পৃষ্ঠায় logcat আউটপুটে পাওয়া ক্র্যাশ ডাম্প সংক্রান্ত প্রাথমিক তথ্য দেওয়া আছে।
অন্যান্য পৃষ্ঠায়
নেটিভ ক্র্যাশ ডায়াগনসিস করা,
dumpsys-এর মাধ্যমে সিস্টেম পরিষেবা এক্সপ্লোর করা,নেটিভ মেমরি,
নেটওয়ার্ক,
ও RAM
ব্যবহার দেখা, নেটিভ কোডে মেমরি
বাগ শনাক্ত করতে AddressSanitizer ব্যবহার করা,
পারফর্ম্যান্স সংক্রান্ত সমস্যা (এর মধ্যে
systrace) মূল্যায়ন করা এবং
ডিবাগার ব্যবহার করা সম্পর্কে আরও বিস্তারিত তথ্য দেওয়া আছে।
ক্র্যাশ ডাম্প ও টমস্টোন
ডায়নামিকালি লিঙ্ক করা এক্সিকিউটেবল শুরু হলে, বেশ কিছু সিগন্যাল হ্যান্ডলার রেজিস্টার করা হয়, যেগুলি ক্র্যাশ হওয়ার ক্ষেত্রে, logcat-এ লেখার জন্য একটি বেসিক ক্র্যাশ ডাম্প
এবং /data/tombstones/-এ লেখার জন্য আরও বিস্তারিত tombstone ফাইল তৈরি করে।
টুম্বস্টোন হল এমন একটি ফাইল যাতে ক্র্যাশ হওয়া প্রসেস সম্পর্কে অতিরিক্ত ডেটা থাকে। বিশেষ করে, এতে ক্র্যাশ হওয়া প্রসেসের সব থ্রেডের জন্য
স্ট্যাক ট্রেস (যে থ্রেড সিগন্যাল
ক্যাচ করেছে শুধু সেটি নয়), সম্পূর্ণ মেমরি ম্যাপ এবং সব ওপেন ফাইল ডেসক্রিপ্টরের তালিকা থাকে।
Android 8.0-এর আগে, ক্র্যাশগুলি
debuggerd এবং debuggerd64 ডেমনের মাধ্যমে ম্যানেজ করা হত। Android 8.0 ও তার পরবর্তী যেকোনও ভার্সনে,
প্রয়োজন অনুযায়ী 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 টুল ব্যবহার করতে পারবেন।
কমান্ড লাইন থেকে, stdout-এ সম্পূর্ণ টুম্বস্টোন ডাম্প করতে প্রসেস আইডি (PID) ব্যবহার করে debuggerd
ইনভোক করুন। প্রসেসের
প্রতিটি থ্রেডের জন্য শুধু স্ট্যাক পেতে, -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)
ফ্রেম #০০–#০৩ হল নেটিভ JNI কোড থেকে নেওয়া যা আলাদা .so ফাইলে এক্সট্র্যাক্ট করার পরিবর্তে ডিস্ক
স্পেস সেভ করার জন্য APK-তে আনকমপ্রেসড হিসেবে স্টোর করা হয়েছে। Android 9 ও এর পরের যেকোনও ভার্সনে, এই সাধারণ
Android-নির্দিষ্ট কেস সামলানোর জন্য স্ট্যাক আনউইন্ডারের এক্সট্র্যাক্ট করা .so ফাইলের প্রয়োজন হয় না।
ফ্রেম #০০–#০২-এ কোনও প্রতীক নাম নেই কারণ ডেভেলপার সেগুলি সরিয়ে দিয়েছেন।
ফ্রেম #০৩ থেকে দেখা যায় যে যেখানে প্রতীক উপলভ্য, সেখানে আনওয়াইন্ডার সেগুলি ব্যবহার করে।
#04 pc 0000000000117550 /data/dalvik-cache/arm64/system@priv-app@Velvet@Velvet.apk@classes.dex (offset 0x108000) (com.google.speech.recognizer.AbstractRecognizer.nativeRun+160)
ফ্রেম #০৪ হল সময়ের আগে কম্পাইল করা 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)
ফ্রেম #০৫–#১০ হল ART ইন্টারপ্রেটার প্রয়োগের অংশ।
Android 9-এর আগের রিলিজের স্ট্যাক আনউইন্ডার, ইন্টারপ্রেটর কোন কোড ইন্টারপ্রেট করছে তা ব্যাখ্যা করা ফ্রেম #11-এর প্রসঙ্গ
ছাড়াই এই ফ্রেমগুলি দেখাত। আপনি যদি ART ডিবাগ করেন,
তাহলে এই ফ্রেমগুলি কাজে লাগে। আপনি কোনও অ্যাপ ডিবাগ করলে, এগুলি উপেক্ষা করতে পারেন। কিছু টুল, যেমন
simpleperf, অটোমেটিক এইসব ফ্রেম বাদ দেয়।
#11 pc 00000000001992d6 /system/priv-app/Velvet/Velvet.apk (offset 0x26cf000) (com.google.speech.recognizer.AbstractRecognizer.run+18)
ফ্রেম #১১ হল জাভা কোড যা ব্যাখ্যা করা হচ্ছে।
#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)
ফ্রেম #১২–#১৬ হল ইন্টারপ্রেটার ইমপ্লিমেন্টেশন।
#17 pc 00000000002454a0 /system/priv-app/Velvet/Velvet.apk (offset 0x1322000) (com.google.android.apps.gsa.speech.e.c.c.call+28)
ফ্রেম #১৭ হল জাভা কোড যা ব্যাখ্যা করা হচ্ছে। এই Java পদ্ধতি ইন্টারপ্রেটার ফ্রেম #১২–#১৬-এর সাথে সম্পর্কিত।
#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)
ফ্রেম #১৮–#২০ হল VM, কম্পাইল করা Java কোড থেকে ইন্টারপ্রেটেড Java কোডে ট্রানজিশন করার কোড।
#21 pc 00000000002ce44c /system/framework/arm64/boot.oat (offset 0xdc000) (java.util.concurrent.FutureTask.run+204)
ফ্রেম #২১ হল কম্পাইল করা Java মেথড যা #১৭-এ Java মেথডকে কল করে।
#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)
ফ্রেম #২২–#২৭ হল ইন্টারপ্রেটার ইমপ্লিমেন্টেশন, যা ইন্টারপ্রেট করা কোড থেকে কম্পাইল করা পদ্ধতিতে মেথড ইনভোকেশন তৈরি করে।
#28 pc 00000000003ed69e /system/priv-app/Velvet/Velvet.apk (com.google.android.apps.gsa.shared.util.concurrent.b.e.run+22)
ফ্রেম #২৮ হল জাভা কোড যা ব্যাখ্যা করা হচ্ছে।
#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)
ফ্রেম #২৯–#৩১ হল কম্পাইল করা কোড এবং ইন্টারপ্রেট করা কোডের মধ্যে আরেকটি ট্রানজিশন।
#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)
ফ্রেম #৩২–#৩৪ হল কম্পাইল করা 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)
ফ্রেম #৩৫–#৪০ হল ইন্টারপ্রেটার।
#41 pc 00000000003ed8e0 /system/priv-app/Velvet/Velvet.apk (com.google.android.apps.gsa.shared.util.concurrent.b.i.run+20)
ফ্রেম #৪১ হল জাভা কোড যা ব্যাখ্যা করা হচ্ছে।
#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)
#৪২–#৪৯ ফ্রেম হল VM নিজেই। এইবার এটি হল সেই কোড যা নতুন থ্রেডে Java রান করা শুরু করে।
#50 pc 0000000000082e24 /system/lib64/libc.so (__pthread_start(void*)+36)
#51 pc 00000000000233bc /system/lib64/libc.so (__start_thread+68)
ফ্রেম #৫০–#৫১ হল কীভাবে সব থ্রেড শুরু হওয়া উচিত। এটি হল libc
নতুন থ্রেড শুরু করার কোড।