เริ่มต้นใช้งานการตรวจสอบประสิทธิภาพสำหรับ Flutter

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

ก่อนเริ่มต้น

กำหนดค่าและเริ่มต้น Firebase ในโปรเจ็กต์ Flutter หากยังไม่ได้ดำเนินการ

ขั้นตอนที่ 1: เพิ่มการตรวจสอบประสิทธิภาพลงในแอป

  1. จากไดเรกทอรีรากของโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอินการตรวจสอบประสิทธิภาพของ Flutter

    flutter pub add firebase_performance

  2. จากไดเรกทอรีรากของโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้

    flutterfire configure

    การเรียกใช้คำสั่งนี้จะช่วยให้มั่นใจว่าการกำหนดค่า Firebase ของแอป Flutter เป็นเวอร์ชันล่าสุด และสำหรับ Android จะเพิ่มปลั๊กอิน Gradle การตรวจสอบประสิทธิภาพที่จำเป็นลงในแอป

  3. เมื่อเสร็จแล้ว ให้สร้างโปรเจ็กต์ Flutter อีกครั้งโดยทำดังนี้

    flutter run

หลังจากเพิ่ม Performance Monitoring SDK แล้ว Firebase จะเริ่มรวบรวม ข้อมูลที่เกี่ยวข้องกับวงจรการทำงานของแอป (เช่น เวลาเริ่มต้นของแอป) และ ข้อมูลสำหรับ คำขอเครือข่าย HTTP/S โดยอัตโนมัติ

ใน Flutter คุณไม่สามารถตรวจสอบประสิทธิภาพการแสดงผลหน้าจออัตโนมัติสำหรับหน้าจอ Flutter แต่ละหน้าจอได้ เนื่องจากตัวควบคุมมุมมองเดียวจะห่อหุ้มแอปพลิเคชัน Flutter ทั้งหมดไว้ในรูปแบบเนทีฟ ดังนั้น Firebase SDK เนทีฟที่อยู่เบื้องหลังจึงไม่ทราบการเปลี่ยนหน้าจอ

ขั้นตอนที่ 2: สร้างเหตุการณ์ด้านประสิทธิภาพเพื่อแสดงข้อมูลเริ่มต้น

Firebase จะเริ่มประมวลผลเหตุการณ์เมื่อคุณเพิ่ม SDK ลงในแอปเรียบร้อยแล้ว หากคุณยังคงพัฒนาแอปในเครื่องอยู่ ให้โต้ตอบกับแอปเพื่อสร้างเหตุการณ์สำหรับการรวบรวมและประมวลผลข้อมูลเริ่มต้น

  1. พัฒนาแอปต่อโดยใช้โปรแกรมจำลองหรืออุปกรณ์ทดสอบ

  2. สร้างเหตุการณ์โดยสลับแอปไปมาระหว่างเบื้องหลังกับเบื้องหน้าหลายๆ ครั้ง โต้ตอบกับแอปโดยไปยังส่วนต่างๆ ของหน้าจอ และ/หรือทริกเกอร์คำขอเครือข่าย

  3. ไปที่แดชบอร์ด ประสิทธิภาพ ของคอนโซล Firebase คุณควรเห็นข้อมูลเริ่มต้นแสดงภายในไม่กี่นาที

    หากไม่เห็นข้อมูลเริ่มต้นแสดง โปรดอ่านเคล็ดลับในการแก้ปัญหาการแก้ปัญหา เคล็ดลับ

ขั้นตอนที่ 3: (ไม่บังคับ) ดูข้อความบันทึกสำหรับเหตุการณ์ด้านประสิทธิภาพ

  1. ตรวจสอบข้อความแสดงข้อผิดพลาดในข้อความบันทึก

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

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. ตรวจสอบบันทึกประเภทต่อไปนี้ ซึ่งบ่งชี้ว่าการตรวจสอบประสิทธิภาพกำลังบันทึกเหตุการณ์ด้านประสิทธิภาพ

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. คลิก URL เพื่อดูข้อมูลในคอนโซล Firebase ระบบอาจใช้เวลาสักครู่ในการอัปเดตข้อมูลในแดชบอร์ด

ขั้นตอนที่ 4: (ไม่บังคับ) เพิ่มการตรวจสอบที่กำหนดเองสำหรับโค้ดที่เฉพาะเจาะจง

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

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

ในโค้ด คุณกำหนดจุดเริ่มต้นและจุดสิ้นสุดของการติดตามโค้ดที่กำหนดเอง (และเพิ่มเมตริกที่กำหนดเองที่ต้องการ) โดยใช้ API ที่ Performance Monitoring SDK มีให้

ไปที่เพิ่มการตรวจสอบสำหรับโค้ดที่เฉพาะเจาะจง เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์เหล่านี้และวิธีเพิ่มฟีเจอร์ลงในแอป

ขั้นตอนที่ 5: นำแอปไปใช้งาน แล้วตรวจสอบผลลัพธ์

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

คุณตรวจสอบข้อมูลประสิทธิภาพได้ใน แดชบอร์ด ประสิทธิภาพของคอนโซล Firebase

ขั้นตอนถัดไป