Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

התחל בעבודה עם ניטור ביצועים עבור iOS

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

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

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

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

  1. פתח את קובץ הפוד שיצרת עבור הפרויקט (או הפעל את pod init ליצירת קובץ), והוסף את השורה הבאה בתוך קטע היעד:

    pod 'Firebase/Performance'
  2. בספריה של קובץ הפוד שלך, הפעל את הפקודה הבאה להתקנת SDK לניטור ביצועים:

    pod install
  3. פתח את קובץ ה- .xcworkspace באמצעות Xcode.

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

    מָהִיר

    import Firebase

    מטרה-ג

    @import Firebase;
  5. הגדר תצורה משותפת של FirebaseApp , בדרך כלל ביישום האפליקציה שלך application:didFinishLaunchingWithOptions: method:

    מָהִיר

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

    מטרה-ג

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

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

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

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

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

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

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

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

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

    1. ב- Xcode (מינימום v12.2), בחר מוצר > סכמה > ערוך ערכה.
    2. בחר הפעלה מהתפריט השמאלי, ואז בחר בכרטיסייה ארגומנטים .
    3. בקטע ארגומנטים -FIRDebugEnabled , הוסף -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 NSURLSessionSessionConfiguration יציגו זמני חיבור ארוכים מהצפוי. חיבורים אלה מבוצעים מחוץ לתהליך והזמנים משקפים אירועי קריאה בתהליך.

הצעדים הבאים