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

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

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

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

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

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

    flutter pub add firebase_performance

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

    flutterfire configure

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

  3. אחרי שמשלימים את התהליך, בונים מחדש את פרויקט Flutter:

    flutter run

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

ב-Flutter, אי אפשר לעקוב אחרי הביצועים של עיבוד המסך באופן אוטומטי במסכים נפרדים של Flutter. בקר תצוגה יחיד מכיל את כל אפליקציית 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 שסופק על ידי Performance Monitoring SDK.

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

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

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

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

השלבים הבאים