Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

שלב 1: הוסף מעקב אחר ביצועים באפליקציה

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

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

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

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

  1. ייבא את מודול Firebase ב שלך UIApplicationDelegate :

    מָהִיר

    import Firebase

    Objective-C

    @import Firebase;
  2. & Nbsp הגדר FirebaseApp משותף למשל, בדרך כלל של האפליקציה שלך application:didFinishLaunchingWithOptions: השיטה:

    מָהִיר

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  1. הידור מחדש של האפליקציה שלך.

שלב 2: יצירת אירועי ביצועים לתצוגת נתונים ראשונית

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

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

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

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

    אם אינך רואה תצוגה של הנתונים ההתחלתי, לסקור את הטיפים .

שלב 3: (אופציונאלי) הודעות יומן עבור אירועי ביצועים

  1. אפשר רישום באגים, באופן הבא:

    1. בשנת Xcode (v12.5 מינימום), לבחור מוצרים> תוכנית> ערכת ערוך.
    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.
  • Swizzling שיטה אחרי שחייגתי FirebaseApp.configure() עלול להפריע SDK מעקב אחר ביצועים.
  • בעיות ידועות בסימולטור iOS 8.0-8.2 מונעות ניטור ביצועים ללכוד אירועי ביצועים. בעיות אלו מתוקנות בסימולטור iOS 8.3 ובגירסאות מאוחרות יותר.
  • חיבורים הוקמו באמצעות של NSURLSession backgroundSessionConfiguration יפגין יותר מאשר פעמי חיבור צפוי. חיבורים אלה מבוצעים מחוץ לתהליך והתזמונים משקפים אירועי התקשרות חוזרים בתהליך.

הצעדים הבאים