สร้างบันทึกการติดตามด้วยเครื่องมือสำหรับแอป

หากต้องการสร้างร่องรอยเมธอดของการดำเนินการของแอป คุณสามารถใช้เครื่องมือวัดแอปโดยใช้คลาส Debug การใช้เครื่องมือวัดแอปด้วยวิธีนี้ช่วยให้คุณควบคุมได้มากขึ้นว่าอุปกรณ์จะเริ่มและหยุดบันทึกข้อมูลการติดตามเมื่อใด นอกจากนี้ อุปกรณ์ยังบันทึกบันทึกการติดตามโดยใช้ชื่อที่คุณระบุ เพื่อให้คุณระบุบันทึกแต่ละรายการได้ง่ายๆ ในภายหลัง จากนั้นคุณจะดูบันทึกการติดตามแต่ละรายการได้โดยใช้เครื่องมือสร้างโปรไฟล์ CPU ของ Android Studio

นอกจากนี้ คุณยังเริ่มและหยุดการติดตามในเครื่องมือสร้างโปรไฟล์ CPU ได้โดยไม่ต้องใช้เครื่องมือวัดโค้ดของแอป

ก่อนเริ่มสร้างบันทึกการติดตาม ให้ตรวจสอบว่าแอปได้เพิ่มตรรกะเพื่อบันทึกการติดตามลงในไดเรกทอรีเฉพาะแอปแล้ว

ติดตั้งเครื่องมือวัดในแอป

หากต้องการสร้างบันทึกการติดตาม ให้เรียกใช้ startMethodTracing() ในตำแหน่งที่คุณต้องการให้ระบบเริ่มบันทึกข้อมูลการติดตาม

ในการเรียกใช้ คุณสามารถระบุชื่อไฟล์ .trace และระบบจะบันทึกไฟล์ลงในไดเรกทอรีเฉพาะแพ็กเกจซึ่งมีไว้สำหรับข้อมูลแอปแบบถาวรในอุปกรณ์เป้าหมาย โดยไดเรกทอรีนี้เป็นไดเรกทอรีเดียวกับที่ getExternalFilesDir() แสดงผล และอยู่ในไดเรกทอรี ~/sdcard/ ในอุปกรณ์ส่วนใหญ่ ไฟล์นี้มีข้อมูลร่องรอยเมธอดแบบไบนารีและตารางการแมปที่มีชื่อชุดข้อความและชื่อเมธอด หากต้องการหยุดการติดตาม ให้โทรหา stopMethodTracing()

ตัวอย่างต่อไปนี้จะเริ่มและหยุดบันทึกการติดตามด้วยชื่อ sample.trace

// Starts recording a trace log with the name you provide. For example, the
// following code tells the system to start recording a .trace file to the
// device with the name "sample.trace".
Debug.startMethodTracing("sample")

// The system begins buffering the generated trace data, until your
// application calls stopMethodTracing(), at which time it writes
// the buffered data to the output file.
Debug.stopMethodTracing()

โปรดทราบว่าหากแอปเรียกใช้ startMethodTracing() อีกครั้งโดยไม่เปลี่ยนชื่อบันทึกการติดตาม ระบบจะเขียนทับบันทึกที่มีอยู่ซึ่งบันทึกไว้ในอุปกรณ์ ดูวิธีเปลี่ยนชื่อบันทึกการติดตามแต่ละรายการแบบไดนามิกได้ที่ส่วนเกี่ยวกับการบันทึกหลายรายการ

หากระบบมีขนาดบัฟเฟอร์สูงสุดก่อนที่คุณจะเรียกใช้ stopMethodTracing() ระบบจะหยุดการติดตามและส่งการแจ้งเตือนไปยังคอนโซล เมธอดที่เริ่มและหยุดการติดตามจะทำงานตลอดทั้งกระบวนการของแอป กล่าวคือ คุณสามารถเรียกใช้ startMethodTracing() ในเมธอด onCreate(Bundle) ของกิจกรรม และเรียกใช้ stopMethodTracing() ในเมธอด onDestroy() ของกิจกรรมนั้น

โปรดทราบว่าแอปจะทำงานช้าลงเมื่อเปิดใช้การทำโปรไฟล์ กล่าวคือ คุณไม่ควรใช้ข้อมูลการทำโปรไฟล์เพื่อกำหนดเวลาที่แน่นอน (เช่น "เมธอด foo() ใช้เวลา 2.5 วินาทีในการทำงาน") ข้อมูลเวลาในบันทึกการติดตามจะมีประโยชน์ก็ต่อเมื่อนำไปเปรียบเทียบกับบันทึกการติดตามก่อนหน้า เพื่อให้คุณเห็นว่าการเปลี่ยนแปลงล่าสุดทำให้แอปเร็วขึ้นหรือช้าลง

เมื่อติดตั้งใช้งานในอุปกรณ์ที่ใช้ Android 5.0 (ระดับ API 21) ขึ้นไป คุณสามารถใช้การทำโปรไฟล์ตามตัวอย่างเพื่อทำโปรไฟล์โดยมีผลกระทบต่อประสิทธิภาพรันไทม์น้อยลง หากต้องการเปิดใช้การสร้างโปรไฟล์ตัวอย่าง ให้เรียกใช้ startMethodTracingSampling() (แทนการเรียกใช้ startMethodTracing()) โดยระบุช่วงเวลาการสุ่มตัวอย่าง ระบบจะรวบรวมตัวอย่างเป็นระยะๆ จนกว่าแอปจะเรียกใช้ stopMethodTracing()

บันทึกหลายรายการ

หากแอปเริ่มและหยุดร่องรอยเมธอดหลายครั้งโดยไม่ได้ระบุชื่อใหม่สำหรับบันทึกการติดตาม อุปกรณ์จะเขียนทับบันทึกการติดตามเก่าด้วยบันทึกใหม่ ซึ่งหมายความว่าจะเก็บบันทึกการติดตามล่าสุดไว้เท่านั้น หากต้องการบันทึกการติดตามหลายรายการลงในอุปกรณ์ ให้เปลี่ยนชื่อบันทึกการติดตามแบบไดนามิกทุกครั้งที่แอปเรียกใช้ startMethodTracing() ตัวอย่างด้านล่างใช้คลาส SimpleDateFormat เพื่อรวมวันที่และเวลาปัจจุบันเมื่อตั้งชื่อบันทึกการติดตามแต่ละรายการ

// Uses the SimpleDateFormat class to create a String with
// the current date and time.
val dateFormat: DateFormat = SimpleDateFormat("dd_MM_yyyy_hh_mm_ss", Locale.getDefault())
val logDate: String = dateFormat.format(Date())
// Applies the date and time to the name of the trace log.
Debug.startMethodTracing("sample-$logDate")

เข้าถึงบันทึกการติดตามในอุปกรณ์

หลังจากระบบสร้างบันทึกการติดตามในอุปกรณ์แล้ว คุณจะเข้าถึงไฟล์ได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้

  • ใช้ Device Explorer หากต้องการเปิด Device Explorer ให้คลิกดู > หน้าต่างเครื่องมือ > Device Explorer (หรือคลิกปุ่ม Device Explorer ในแถบหน้าต่างเครื่องมือ) ดังที่แสดงในรูปที่ 1 คุณจะค้นหาไฟล์ .trace ได้โดยไปที่ไดเรกทอรีเฉพาะแพ็กเกจของแอป

    รูปที่ 1 การค้นหาบันทึกการติดตามโดยใช้ Device Explorer

  • คัดลอกไฟล์ไปยังเครื่องของคุณโดยใช้คำสั่ง adb pull คำสั่งด้านล่างจะคัดลอกบันทึกการติดตามชื่อ sample.trace จากอุปกรณ์ไปยังไดเรกทอรี ~/Documents/trace-logs/ ของเครื่องในเครื่อง

    adb pull path-on-device/sample.trace ~/Documents/trace-logs/

จากนั้นคุณจะนำเข้าไฟล์การย้ายข้อมูลด้วยเครื่องมือสร้างโปรไฟล์ CPU ได้