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

ก่อนที่คุณจะเริ่มต้น

หากคุณยังไม่ได้ ดำเนินการ ให้เพิ่ม Firebase ในโครงการ Apple ของคุณ

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

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

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการอ้างอิง Firebase

1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Firebase Apple platforms SDK:

  https://github.com/firebase/firebase-ios-sdk

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

ถัดไป กำหนดค่าโมดูล Firebase:

1. นำเข้าโมดูล FirebaseCore ใน UIApplicationDelegate ของคุณ รวมถึง โมดูล Firebase อื่นๆ ที่ตัวแทนแอปของคุณใช้ ตัวอย่างเช่น หากต้องการใช้ Cloud Firestore และการรับรองความถูกต้อง:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   สวิฟต์

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   วัตถุประสงค์-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ FirebaseApp ใน application(_:didFinishLaunchingWithOptions:) วิธีการ:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   สวิฟต์

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   วัตถุประสงค์-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. หากคุณใช้ SwiftUI คุณต้องสร้างตัวแทนแอปพลิเคชันและแนบกับโครงสร้าง App ของคุณผ่าน UIApplicationDelegateAdaptor หรือ NSApplicationDelegateAdaptor คุณต้องปิดใช้งานการ swizzling ของผู้รับมอบสิทธิ์แอปด้วย สำหรับข้อมูลเพิ่มเติม โปรดดู คำแนะนำ SwiftUI

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. คอมไพล์แอปของคุณใหม่

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

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

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

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

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

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

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

1. เปิดใช้งานการบันทึกการแก้ไขจุดบกพร่อง ดังนี้:

   1. ใน Xcode (ขั้นต่ำ v13.3.1) เลือก Product > Scheme > Edit scheme
   2. เลือก เรียกใช้ จากเมนูด้านซ้าย จากนั้นเลือกแท็บ อาร์กิวเมนต์
   3. ในส่วน Arguments Passed on Launch ให้เพิ่ม -FIRDebugEnabled

2. ตรวจสอบข้อความบันทึกของคุณเพื่อหาข้อความแสดงข้อผิดพลาด

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

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

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

5. คลิกที่ URL เพื่อดูข้อมูลของคุณในคอนโซล Firebase อาจใช้เวลาสักครู่เพื่อให้ข้อมูลอัปเดตในแดชบอร์ด

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

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

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

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

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

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

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

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

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

ปัญหาที่ทราบ

• การตรวจสอบประสิทธิภาพมีปัญหาความเข้ากันได้ที่ทราบกับ GTMSQLite เราไม่แนะนำให้ใช้การตรวจสอบประสิทธิภาพกับแอปที่ใช้ GTMSQLite
• เมธอดหมุนวนหลังจากเรียก FirebaseApp.configure() อาจรบกวน SDK การตรวจสอบประสิทธิภาพ
• ปัญหาที่ทราบเกี่ยวกับ iOS 8.0-8.2 Simulator ทำให้การตรวจสอบประสิทธิภาพไม่สามารถบันทึกเหตุการณ์ประสิทธิภาพได้ ปัญหาเหล่านี้ได้รับการแก้ไขแล้วใน iOS 8.3 Simulator และเวอร์ชันที่ใหม่กว่า
• การเชื่อมต่อที่สร้างโดยใช้ backgroundSessionConfiguration ของ NSURLSession จะแสดงนานกว่าเวลาการเชื่อมต่อที่คาดไว้ การเชื่อมต่อเหล่านี้ดำเนินการนอกกระบวนการ และการกำหนดเวลาสะท้อนถึงเหตุการณ์การเรียกกลับในกระบวนการ

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

• ตรวจสอบและรัน ตัวอย่างโค้ด Performance Monitoring iOS บน GitHub

• เรียนรู้เพิ่มเติมเกี่ยวกับข้อมูลที่เก็บรวบรวมโดยอัตโนมัติโดยการตรวจสอบประสิทธิภาพ:

  • ข้อมูลที่เกี่ยวข้องกับวงจรชีวิตของแอป เช่น เวลาเริ่มต้นของแอป
  • ข้อมูลสำหรับ การแสดงผลหน้าจอ ในแอปของคุณ
  • ข้อมูลสำหรับ คำขอเครือข่าย HTTP/S ที่ออกโดยแอปของคุณ

• ดู ติดตาม และกรอง ข้อมูลประสิทธิภาพของคุณในคอนโซล Firebase

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

• ใช้แอตทริบิวต์เพื่อกรองข้อมูลประสิทธิภาพ