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

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

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

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

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

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

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

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

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

    מעקב ביצועים מתייג את ההודעות ביומן באמצעות התגים הבאים, כדי שתוכלו לסנן את ההודעות ביומן:

    • 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.

השלבים הבאים