התחל עם ניטור ביצועים עבור פלטפורמות Apple

לפני שאתה מתחיל

אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Apple שלך .

שלב 1 : הוסף ניטור ביצועים לאפליקציה שלך

לאחר שהוספת את ה-SDK לניטור ביצועים, Firebase מתחיל באופן אוטומטי לאסוף נתונים עבור עיבוד המסך של האפליקציה שלך, נתונים הקשורים למחזור החיים של האפליקציה שלך (כמו שעת התחלה של האפליקציה ) ונתונים עבור בקשות רשת HTTP/S .

השתמש ב- Swift Package Manager כדי להתקין ולנהל תלות ב-Firebase.

  1. ב-Xcode, כשפרויקט האפליקציה שלך פתוח, נווט אל קובץ > הוסף חבילות .
  2. כשתתבקש, הוסף את מאגר Firebase Apple platforms SDK:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. בחר את ספריית ניטור הביצועים.
  5. הוסף את הדגל -ObjC לקטע Other Linker Flags של הגדרות הבנייה של היעד שלך.
  6. בסיום, Xcode יתחיל באופן אוטומטי לפתור ולהוריד את התלות שלך ברקע.

לאחר מכן, הגדר את מודול Firebase:

  1. ייבא את מודול FirebaseCore ב- UIApplicationDelegate שלך, כמו גם כל מודולי Firebase אחרים שנציג האפליקציה שלך משתמש בו. לדוגמה, כדי להשתמש ב-Cloud Firestore ובאימות:

    SwiftUI

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

    מָהִיר

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-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()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. אם אתה משתמש ב- SwiftUI, עליך ליצור נציג יישום ולצרף אותו למבנה App שלך באמצעות UIApplicationDelegateAdaptor או NSApplicationDelegateAdaptor . עליך גם להשבית את העברת נציגי האפליקציה. למידע נוסף, עיין בהוראות של 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 (מינימום v14.1), בחר מוצר > סכימה > עריכת סכמה .
    2. בחר הפעלה מהתפריט השמאלי ולאחר מכן בחר בכרטיסייה ארגומנטים .
    3. בקטע הטיעונים שהועברו בהפעלה , הוסף -FIRDebugEnabled .
  2. בדוק את הודעות היומן שלך עבור הודעות שגיאה.

  3. ניטור ביצועים מתייג את הודעות היומן שלו ב- Firebase/Performance כדי שתוכל לסנן את הודעות היומן שלך.

  4. בדוק את סוגי היומנים הבאים שמציינים שניטור ביצועים רושם אירועי ביצועים:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. לחץ על כתובת האתר כדי להציג את הנתונים שלך במסוף Firebase. ייתכן שיחלפו מספר רגעים עד שהנתונים יתעדכנו בלוח המחוונים.

אם האפליקציה שלך לא רושמת אירועי ביצועים, עיין בטיפים לפתרון בעיות .

שלב 4 : (אופציונלי) הוסף ניטור מותאם אישית עבור קוד ספציפי

כדי לעקוב אחר נתוני ביצועים המשויכים לקוד ספציפי באפליקציה שלך, אתה יכול ליישם מעקבי קוד מותאמים אישית .

בעזרת מעקב קוד מותאם אישית, אתה יכול למדוד כמה זמן לוקח לאפליקציה שלך להשלים משימה ספציפית או קבוצת משימות, כגון טעינת קבוצת תמונות או שאילתות במסד הנתונים שלך. מדד ברירת המחדל עבור מעקב אחר קוד מותאם אישית הוא משך הזמן שלו, אבל אתה יכול גם להוסיף מדדים מותאמים אישית, כגון התאמות מטמון ואזהרות זיכרון.

בקוד שלך, אתה מגדיר את ההתחלה והסוף של מעקב קוד מותאם אישית (ומוסיף כל מדדים מותאמים אישית רצויים) באמצעות ה-API שסופק על ידי ה-SDK לניטור ביצועים.

בקר ב'הוסף ניטור לקוד ספציפי' כדי ללמוד עוד על תכונות אלו וכיצד להוסיף אותן לאפליקציה שלך.

שלב 5 : פרוס את האפליקציה שלך ואז סקור את התוצאות

לאחר אימות ניטור ביצועים באמצעות סימולטור Xcode ומכשיר בדיקה אחד או יותר, תוכל לפרוס את הגרסה המעודכנת של האפליקציה שלך למשתמשים שלך.

אתה יכול לעקוב אחר נתוני ביצועים בלוח המחוונים הביצועים של מסוף Firebase.

בעיות ידועות

  • לניטור ביצועים יש בעיות תאימות ידועות עם GTMSQLite. אנו ממליצים לא להשתמש בניטור ביצועים עם אפליקציות המשתמשות ב-GTMSQLite.
  • שיטה שוטפת לאחר קריאה FirebaseApp.configure() עלולה להפריע ל-SDK לניטור ביצועים.
  • בעיות ידועות בסימולטור iOS 8.0-8.2 מונעות ניטור ביצועים ללכוד אירועי ביצועים. בעיות אלו מתוקנות בסימולטור iOS 8.3 ובגירסאות מאוחרות יותר.
  • חיבורים שנוצרו באמצעות backgroundSessionConfiguration של NSURLSession יציגו זמני חיבור ארוכים מהצפוי. חיבורים אלה מבוצעים מחוץ לתהליך והתזמונים משקפים אירועי התקשרות חוזרים בתהליך.

הצעדים הבאים