Bu bölümde, platform düzeyinde özellikler geliştirirken yerel Android platform kodunda hata ayıklama, izleme ve profil oluşturma için yararlı araçlar ve ilgili komutlar özetlenmiştir.
Not: Bu bölümdeki ve bu sitenin diğer bölümlerindeki sayfalarda, Android'in belirli özelliklerinde hata ayıklama için adb parametresinin setprop bağımsız değişkeniyle birlikte kullanılması önerilir.
Android 7.x ve önceki sürümlerde mülk adlarının uzunluğu 32 karakterle sınırlıydı. Bu, uygulamanın adıyla bir sarmalayıcı mülkü oluşturmak için adın sığacak şekilde kısaltılması gerektiği anlamına geliyordu. Android 8.0 ve sonraki sürümlerde bu sınır çok daha yüksektir ve kısaltma gerektirmez.
Bu sayfada, logcat çıkışında bulunan kilitlenme dökümleriyle ilgili temel bilgiler ele alınmaktadır.
Diğer sayfalarda yerel kilitlenmelerin teşhisi,
dumpsys ile sistem hizmetlerini keşfetme, yerel bellek, ağ ve RAM kullanımını görüntüleme, yerel koddaki bellek hatalarını tespit etmek için AddressSanitizer kullanma, performans sorunlarını değerlendirme (systrace dahildir) ve hata ayıklayıcıları kullanma hakkında çok daha fazla ayrıntı yer alır.
Kilitlenme dökümleri ve mezar taşları
Dinamik olarak bağlanmış bir yürütülebilir dosya başladığında, kilitlenme durumunda logcat'e temel bir kilitlenme dökümü ve /data/tombstones/'ye daha ayrıntılı bir mezar taşı dosyası yazılmasını sağlayan çeşitli sinyal işleyicileri kaydedilir.
Mezar taşı, kilitlenen işlemle ilgili ek veriler içeren bir dosyadır. Özellikle, kilitlenme sürecindeki tüm iş parçacıklarının (yalnızca sinyali yakalayan iş parçacığı değil) yığın izlemelerini, tam bir bellek haritasını ve tüm açık dosya tanımlayıcılarının listesini içerir.
Android 8.0'dan önce kilitlenmeler debuggerd ve debuggerd64 daemon'ları tarafından ele alınıyordu. Android 8.0 ve sonraki sürümlerde crash_dump32 ve crash_dump64 gerektiğinde oluşturulur.
Kilitlenme dökümleyicinin yalnızca başka bir şey bağlı değilse bağlanması mümkündür. Bu, strace veya lldb gibi araçların kullanılmasının kilitlenme dökümlerinin oluşmasını engellediği anlamına gelir.
Örnek çıkış (zaman damgaları ve alakasız bilgiler kaldırılmıştır):
*** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
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
Çıktının son satırı, tam mezar taşının diskteki konumunu belirtir.
Çıplak olmayan ikili dosyalarınız varsa yığını development/scripts/stack içine yapıştırarak satır numarası bilgilerini içeren daha ayrıntılı bir çözme işlemi yapabilirsiniz:
development/scripts/stack
İpucu: Kolaylık sağlamak için lunch'yi çalıştırdıysanız stack zaten $PATH'inizdedir. Bu nedenle tam yolu belirtmeniz gerekmez.
Örnek çıkış (yukarıdaki logcat çıkışına göre):
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 simgesini tüm bir mezar taşı üzerinde kullanabilirsiniz. Örnek:
stack < FS/data/tombstones/tombstone_05
Mevcut dizinde bir hata raporunun sıkıştırmasını yeni açtıysanız bu yöntemi kullanabilirsiniz. Doğal kilitlenmeler ve mezar taşları hakkında daha fazla bilgi edinmek için Doğal Kilitlenmeleri Teşhis Etme başlıklı makaleyi inceleyin.
Çalışan bir süreçten yığın izleme veya mezar taşı alma
Çalışan bir işlemden yığın dökümü almak için debuggerd aracını kullanabilirsiniz.
Tam bir mezar taşı dökümünü stdout'a aktarmak için komut satırından bir işlem kimliği (PID) kullanarak debuggerd'ü çağırın. İşlemdeki her ileti dizisinin yalnızca yığınını almak için -b veya --backtrace işaretini ekleyin.
Karmaşık bir geri sarma işlemini anlama
Bir uygulama kilitlendiğinde yığın oldukça karmaşık olur. Aşağıdaki ayrıntılı örnekte, karmaşıklıkların çoğu vurgulanmaktadır:
#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 numaralı kareler, ayrı bir .so dosyasına ayıklanmak yerine disk alanından tasarruf etmek için APK'da sıkıştırılmadan depolanan yerel JNI kodundan gelir. Android 9 ve sonraki sürümlerdeki yığın çözücü, Android'e özgü bu yaygın durumla başa çıkmak için ayıklanmış .so dosyasına ihtiyaç duymaz.
00-02 numaralı kareler, geliştirici tarafından kaldırıldığı için simge adlarına sahip değildir.
03 numaralı kare, sarmalayıcının simgelerin bulunduğu yerlerde bunları kullandığını gösterir.
#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 numaralı kare, önceden derlenmiş Java kodudur. Eski çözücü, Java'da çözme işlemini tamamlayamayarak burada dururdu.
#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 numaralı kareler ART yorumlayıcı uygulamasından alınmıştır.
Android 9'dan önceki sürümlerdeki yığın çözücü, bu kareleri yorumlayıcının hangi kodu yorumladığını açıklayan 11. karenin bağlamı olmadan gösterirdi. ART'da hata ayıklama yapıyorsanız bu kareler yararlıdır. Bir uygulamada hata ayıklama yapıyorsanız bu hataları yoksayabilirsiniz. simpleperf gibi bazı araçlar bu kareleri otomatik olarak atlar.
#11 pc 00000000001992d6 /system/priv-app/Velvet/Velvet.apk (offset 0x26cf000) (com.google.speech.recognizer.AbstractRecognizer.run+18)
11. kare, yorumlanan Java kodudur.
#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 numaralı çerçeveler, yorumlayıcı uygulamasının kendisidir.
#17 pc 00000000002454a0 /system/priv-app/Velvet/Velvet.apk (offset 0x1322000) (com.google.android.apps.gsa.speech.e.c.c.call+28)
17. kare, yorumlanan Java kodudur. Bu Java yöntemi, 12-16 numaralı yorumcu çerçevelerine karşılık gelir.
#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 numaralı çerçeveler, derlenmiş Java kodundan yorumlanmış Java koduna geçiş kodu olan sanal makinenin kendisidir.
#21 pc 00000000002ce44c /system/framework/arm64/boot.oat (offset 0xdc000) (java.util.concurrent.FutureTask.run+204)
21. çerçeve, 17. çerçevedeki Java yöntemini çağıran derlenmiş Java yöntemidir.
#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 numaralı çerçeveler, yorumlanmış koddan derlenmiş bir yönteme yöntem çağrısı yapan yorumlayıcı uygulamasıdır.
#28 pc 00000000003ed69e /system/priv-app/Velvet/Velvet.apk (com.google.android.apps.gsa.shared.util.concurrent.b.e.run+22)
28. kare, yorumlanan Java kodudur.
#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 numaralı kareler, derlenmiş kod ile yorumlanmış kod arasında başka bir geçiştir.
#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 numaralı çerçeveler, birbirini doğrudan çağıran derlenmiş Java çerçeveleridir. Bu durumda yerel çağrı yığını, Java çağrı yığınıyla aynıdır.
#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 numaralı kareler, çevirmenin kendisidir.
#41 pc 00000000003ed8e0 /system/priv-app/Velvet/Velvet.apk (com.google.android.apps.gsa.shared.util.concurrent.b.i.run+20)
41. kare, yorumlanan Java kodudur.
#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 numaralı kareler sanal makinenin kendisidir. Bu kez, Java'yı yeni bir iş parçacığında çalıştırmaya başlayan koddur.
#50 pc 0000000000082e24 /system/lib64/libc.so (__pthread_start(void*)+36)
#51 pc 00000000000233bc /system/lib64/libc.so (__start_thread+68)
Tüm mesaj dizileri 50-51 numaralı karelerle başlamalıdır. Bu, libc
yeni ileti dizisi başlangıç kodudur.