תחילת העבודה עם מעקב אחר ביצועים של Flutter

במדריך למתחילים הזה נסביר איך להגדיר את Firebase Performance Monitoring כדי לעזור לכם לקבל תובנות לגבי מאפייני הביצועים של אפליקציות Flutter.

לפני שמתחילים

אם עדיין לא עשיתם זאת, מגדירים ומפעילים את Firebase בפרויקט Flutter.

שלב 1: מוסיפים את התכונה 'מעקב ביצועים' לאפליקציה

  1. כדי להתקין את הפלאגין של Performance Monitoring ל-Flutter, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של פרויקט Flutter:

    flutter pub add firebase_performance

  2. בתיקיית השורש של פרויקט Flutter, מריצים את הפקודה הבאה:

    flutterfire configure

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

  3. בסיום, יוצרים מחדש את פרויקט Flutter:

    flutter run

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

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

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

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

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

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

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

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

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

  1. בודקים אם יש הודעות שגיאה בהודעות היומן.

    כדי שתוכלו לסנן את הודעות היומן, מערכת Performance Monitoring מסמנת את הודעות היומן שלה בתגים הבאים:

    • 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 שסופק על ידי ה-SDK למעקב ביצועים.

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

שלב 5: פורסים את האפליקציה ובודקים את התוצאות

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

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

השלבים הבאים