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

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

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

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

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

השלבים הבאים