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

อุปกรณ์ที่ใช้ Android 9 (API ระดับ 28) ขึ้นไปจะมีแอประดับระบบ ที่เรียกว่า System Tracing แอปนี้คล้ายกับ ยูทิลิตีบรรทัดคำสั่ง systrace แต่ แอปช่วยให้คุณบันทึกการติดตามได้โดยตรงจากอุปกรณ์ทดสอบเอง ต้องเสียบปลั๊กและเชื่อมต่อกับอุปกรณ์ผ่าน adb จากนั้นคุณสามารถใช้ เพื่อแชร์ผลลัพธ์จากการติดตามเหล่านี้กับทีมพัฒนาของคุณ

แต่อุปกรณ์ที่ใช้ Android 10 ขึ้นไปจะมีระเบียนการติดตามในรูปแบบ Perfetto แต่ ก่อนหน้านี้อุปกรณ์จะบันทึกข้อมูลในรูปแบบ Systrace เราขอแนะนำให้คุณใช้เมนู Perfetto โปรแกรมดูการติดตามเพื่อเปิดทั้ง 2 รูปแบบและ จากนั้นวิเคราะห์การติดตาม

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

บันทึกการติดตามของระบบ

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

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

บันทึกโดยใช้การ์ดการตั้งค่าด่วน

การ์ดการตั้งค่าด่วนมักจะเป็นวิธีที่สะดวกมากกว่าในการทำ กระบวนการติดตามระบบในอุปกรณ์

ตั้งค่าการ์ด

หากคุณใช้ System Tracing เป็นครั้งแรกในอุปกรณ์ทดสอบ หรือหาก ไม่เห็นการ์ดการติดตามระบบในแผงการตั้งค่าด่วนของอุปกรณ์ ดังที่แสดงในรูปที่ 2 ทำตามขั้นตอนการตั้งค่าต่อไปนี้ให้เสร็จสมบูรณ์

1. เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอป
2. เปิดหน้าจอการตั้งค่าตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์
3. ในส่วนการแก้ไขข้อบกพร่อง ให้เลือกการติดตามระบบ System Tracing แอปจะเปิดขึ้น โดยแสดงเมนูแอป

4. จากเมนูแอป ให้เปิดใช้แสดงการ์ดการตั้งค่าด่วนดังที่แสดงในรูปที่ 1 ระบบจะเพิ่มการ์ดการติดตามระบบลงในแผงการตั้งค่าด่วน ดังที่แสดงในรูปที่ 2:

   วันที่

   รูปที่ 1 ให้เปลี่ยนแสดงการ์ดการตั้งค่าด่วนเข้า แอป System Tracing

   

   รูปที่ 2 การ์ด System Tracing ภายใน แผงการตั้งค่าด่วน

   หมายเหตุ: โดยค่าเริ่มต้น ระบบจะ เพิ่มการ์ด System Tracing เป็นไทล์แรกใน Quick ด่วน การตั้งค่า หากต้องการให้การ์ดปรากฏในตำแหน่งอื่น ใช้โหมดแก้ไขของแผงเพื่อย้ายการ์ด

บันทึกการติดตามระบบให้เสร็จสมบูรณ์

หากต้องการบันทึกการติดตามของระบบโดยใช้แผงการตั้งค่าด่วน ให้ทำดังนี้ ขั้นตอนต่อไปนี้

1. แตะการ์ด System Tracing ที่มีป้ายกำกับ Record Tracking จะมีการเปิดใช้การ์ด และจะมีการแจ้งเตือนปรากฏขึ้นตลอดเวลาเพื่อแจ้งให้คุณทราบ ว่าระบบกำลังบันทึกการติดตามหรือไม่ ดังที่แสดงในรูปที่ 3:

   วันที่

   รูปที่ 3 การแจ้งเตือนที่แสดงอยู่เรื่อยๆ ซึ่งปรากฏหลังจาก เริ่มการติดตามระบบในอุปกรณ์

2. ดําเนินการในแอปที่คุณต้องการให้ระบบตรวจสอบ

   หมายเหตุ: คุณบันทึกข้อบกพร่องที่ทำซ้ำได้ยากได้โดยออกจากระบบ การติดตามกำลังทำงานในเบื้องหลังแล้วหยุด System Tracing เร็วๆ นี้ หลังข้อบกพร่องเกิดขึ้น System Tracing จะบันทึกกิจกรรมของอุปกรณ์เป็นการเล่นต่อเนื่อง ซึ่งจะเก็บเหตุการณ์ได้ 10-30 วินาที

3. หยุดการติดตามโดยแตะการ์ด System Tracing ใน Quick ด่วน แผงการตั้งค่าหรือในการแจ้งเตือน System Tracing

   ระบบจะแสดงการแจ้งเตือนใหม่ที่มีข้อความ "กำลังบันทึก การติดตาม" เมื่อบันทึกเสร็จแล้ว ระบบจะปิดการแจ้งเตือน และ แสดงการแจ้งเตือนครั้งที่ 3 เพื่อยืนยันว่ามีการบันทึกการติดตามของคุณ และ คุณก็พร้อมที่จะแชร์การติดตามระบบ ดังที่แสดงในรูป 4:

   วันที่

   รูปที่ 4 การแจ้งเตือนที่แสดงอยู่เรื่อยๆ ซึ่งปรากฏหลังจาก จากนั้นระบบจะบันทึกการติดตามที่บันทึกไว้จนเสร็จสิ้น

บันทึกโดยใช้เมนูแอป

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

หากต้องการบันทึกการติดตามระบบโดยใช้เมนูแอป System Tracing ให้ทำดังนี้ ขั้นตอนต่อไปนี้

1. เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอป

2. เปิดหน้าจอการตั้งค่าตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ ในส่วนการแก้ไขข้อบกพร่อง เลือก System Tracing แอป System Tracing จะเปิดขึ้น

   หรือหากคุณตั้งค่าการ์ด System Tracing คุณก็แตะการ์ดค้างไว้เพื่อเข้าสู่แอป System Tracing ได้

3. ตรวจสอบว่าได้เลือกติดตามแอปพลิเคชันที่แก้ไขข้อบกพร่องได้เพื่อรวมแอปที่ เปิดใช้การแก้ไขข้อบกพร่องในการติดตามระบบแล้ว

4. (ไม่บังคับ) เลือกหมวดหมู่ของการเรียกใช้ระบบและเซ็นเซอร์เพื่อติดตาม และเลือกขนาดบัฟเฟอร์ต่อ CPU ในหน่วย KB เลือกหมวดหมู่ที่สอดคล้องกัน กับกรณีการใช้งานที่คุณกำลังทดสอบ เช่น หมวดหมู่เสียงสำหรับ การทดสอบการดำเนินการของบลูทูธหรือหมวดหมู่หน่วยความจำสำหรับการจัดสรรฮีป

   หมายเหตุ: หมวดหมู่เหล่านี้ทำหน้าที่เป็นการตั้งค่าระดับแอป ดังนั้นระบบจึงใช้หมวดหมู่เหล่านี้ หมวดหมู่ต่างๆ เมื่อใช้การ์ดการตั้งค่าด่วนด้วย นอกจากนี้ การตั้งค่าเหล่านี้จะยังคงอยู่ระหว่างการรีบูตอุปกรณ์

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

6. เปิดใช้สวิตช์บันทึกการติดตามที่ไฮไลต์ในรูปที่ 5 ไทล์จะกลายเป็น แล้วจะมีการแจ้งเตือนปรากฏขึ้นเพื่อแจ้งให้คุณทราบว่าระบบ กำลังบันทึกการติดตามดังที่แสดงในรูปที่ 3

   วันที่

   รูปที่ 5 สวิตช์ติดตามระเบียนในระบบ การตั้งค่าการติดตาม

7. ดําเนินการในแอปที่คุณต้องการให้ระบบตรวจสอบ

   หมายเหตุ: คุณบันทึกข้อบกพร่องที่ทำซ้ำได้ยากได้โดยออกจากระบบ การติดตามกำลังทำงานในเบื้องหลัง หลังจากนั้นจะหยุดการติดตามระบบในเร็วๆ นี้ หลังข้อบกพร่องเกิดขึ้น โดยค่าเริ่มต้น System Tracing จะบันทึกกิจกรรมของอุปกรณ์ ลงในบัฟเฟอร์กลิ้งต่อเนื่อง ซึ่งเก็บเหตุการณ์ได้ 10-30 วินาที หากเป็นการติดตามยาว เปิดใช้ ระบบจะบันทึกกิจกรรมของอุปกรณ์ไปยังพื้นที่เก็บข้อมูลของอุปกรณ์อย่างต่อเนื่อง ตามขีดจำกัดที่คุณตั้งไว้

8. หยุดการติดตามโดยปิดใช้สวิตช์บันทึกการติดตาม

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

แชร์การติดตามระบบ

แอป System Tracing ช่วยให้คุณสามารถแชร์ผลลัพธ์การติดตามระบบโดยเป็นส่วนหนึ่งของ เวิร์กโฟลว์ที่แตกต่างกัน ติดตามในอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป บันทึกด้วยนามสกุลไฟล์ .perfetto-trace และเปิดไฟล์ได้ ใน Perfetto UI ในอุปกรณ์ ที่ใช้ Android เวอร์ชันก่อนหน้า ไฟล์การติดตามจะบันทึกด้วย .ctrace นามสกุลไฟล์ ซึ่งแสดงรูปแบบ Systrace

แชร์เป็นข้อความ

System Tracing ช่วยให้คุณแชร์การติดตามที่เก็บรวบรวมไว้กับแอปอื่นๆ ในอุปกรณ์ได้ อุปกรณ์ คุณสามารถส่งการติดตามนี้ไปให้ทีมพัฒนาของคุณทางอีเมลหรือ แอปติดตามข้อบกพร่องโดยไม่ต้องเชื่อมต่ออุปกรณ์กับการพัฒนา อุปกรณ์

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

แชร์จากแอป Files

สำหรับอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป การติดตามจะแสดงใน แอป Files คุณแชร์การติดตามจากแอปนี้ได้

ดาวน์โหลดรายงานโดยใช้ ADB

คุณยังดึงข้อมูลการติดตามของระบบจากอุปกรณ์โดยใช้ adb ได้ด้วย เชื่อมต่อ ที่ใช้ในการบันทึกการติดตาม ลงในเครื่องการพัฒนาของคุณ จากนั้นเรียกใช้ คำสั่งต่อไปนี้ในหน้าต่างเทอร์มินัล

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

แปลงรูปแบบการติดตาม

คุณสามารถแปลงไฟล์การติดตามของ Perfetto เป็นรูปแบบ Systrace ได้ ดูการแปลง ระหว่างรูปแบบการติดตาม เพื่อดูข้อมูลเพิ่มเติม

สร้างรายงาน HTML

เมื่อแชร์การติดตาม รายงานจะอยู่ในไฟล์ .perfetto-trace บน อุปกรณ์ที่ใช้ Android 10 หรือมากกว่า หรือไฟล์ .ctrace สำหรับเวอร์ชันอื่นทั้งหมด

สร้างรายงาน HTML จากไฟล์การติดตามโดยใช้ UI แบบเว็บ หรือ จากบรรทัดคำสั่ง

UI แบบเว็บ

ใช้ UI ของ Perfetto เพื่อเปิด ไฟล์การย้ายข้อมูล แล้วสร้างรายงาน

สำหรับไฟล์ Perfetto ให้คลิกเปิดไฟล์การติดตาม สำหรับไฟล์ Systrace ให้คลิก เปิดด้วย UI เดิม UI แบบเดิมมีรูปลักษณ์แบบเดียวกับ รายงาน Systrace

บรรทัดคำสั่ง

เรียกใช้คำสั่งต่อไปนี้ในหน้าต่างเทอร์มินัลเพื่อสร้างรายงาน HTML จากไฟล์การติดตาม

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

ดาวน์โหลดโปรแกรมบรรทัดคำสั่ง systrace ได้หากยังไม่มี จาก ตัวเร่งปฏิกิริยา บน GitHub หรือจากโอเพนซอร์ส Android โดยตรง โปรเจ็กต์