תחילת העבודה עם מעקב אחר ביצועים של 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.

השלבים הבאים