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

במדריך למתחילים מוסבר איך מגדירים מעקב ביצועים ב-Firebase כדי לקבל תובנות לגבי מאפייני הביצועים של אפליקציות 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. מנהל תצוגה יחיד מכיל את כל האפליקציה של 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.

השלבים הבאים