ניתוח בעיות מ-Firebase Crashlytics ומ-Android Vitals באמצעות תובנות לגבי איכות האפליקציה

אתם יכולים לראות את נתוני הקריסות באפליקציה מ-Firebase Crashlytics ומ-Android Vitals ישירות ב-Android Studio, ולבצע פעולות בהתאם. השילוב הזה גורר נתונים של מעקב סטאק ונתונים סטטיסטיים של קריסות מ-Crashlytics ומ-Google Play אל חלון הכלי App Quality Insights ב-Studio IDE, כך שאין צורך לעבור שוב ושוב בין הדפדפן ל-IDE. צוותי הפיתוח יכולים ליהנות מיכולות מרכזיות, כולל:

  • הקווים בקוד מודגשים אם יש להם נתוני אירועים קשורים מ-Crashlytics.
  • בודקים את נתיב הסטאק של תאונות הקריסת הקוד המובילות, ולוחצים על נתיב הסטאק כדי לעבור לשורות הרלוונטיות בקוד.
  • הצגת נתונים סטטיסטיים על אירועי הקריסה והאירועים הלא קטלניים המובילים, למשל, מקובצים לפי יצרן המכשיר וגרסה של Android.
  • סינון אירועים לפי מאפיינים, כולל חומרה, זמן וגרסת האפליקציה.
  • לקבל קישור לדפדפן שפותח את דף לוח הבקרה של Crashlytics עם פרטים נוספים על האירוע.
  • תובנות שיעזרו לכם להבין בקלות רבה יותר את הגורמים העיקריים לבעיות מסוימות ולפתור אותן.

הדוחות של Android Vitals זמינים לכל האפליקציות שפורסמו ב-Google Play. אם אתם עדיין לא משתמשים ב-Crashlytics ואתם רוצים לקבל מידע נוסף על המוצרים שלו, תוכלו לקרוא את המאמר Firebase Crashlytics.

שנתחיל?

כדי לראות את נתוני Crashlytics ב-Android Studio, צריך להגדיר את Firebase ואת Crashlytics בפרויקט האפליקציה. כך עושים את זה: פותחים את Firebase Assistant ב-Android Studio. לשם כך, עוברים אל Tools (כלים) > Firebase, לוחצים על Crashlytics ופועלים לפי המדריך להוספת Firebase ו-Crashlytics לפרויקט. מידע נוסף על תהליך העבודה של Firebase Assistant זמין במדריך לתחילת העבודה עם Firebase ל-Android.

אם כבר הוספתם את Firebase ו-Crashlytics לאפליקציה, צריך להיכנס לחשבון הפיתוח בסביבת הפיתוח האינטגרטיבית (IDE) בלחיצה על סמל הדמות . אחרי הכניסה, לוחצים על חלון הכלי תובנות לגבי איכות האפליקציה . הלוחות אמורים לאכלס דוחות מ-Crashlytics.

ניתוח של נתוני תפקוד האפליקציה ב-Android

תובנות לגבי איכות האפליקציה כוללות נתונים של מדדי ביצועים חיוניים של Android. כך תוכלו לגשת בקלות רבה יותר למדדים המרכזיים שנאספים על ידי Google Play ולשפר את חוויית המשתמש. אתם יכולים להשתמש בתכונה 'נתונים על תפקוד האפליקציה' כדי לטפל בבעיות שקשורות ליציבות האפליקציה, וכך לשפר את האיכות שלה ב-Google Play.

נתוני תפקוד האפליקציה ב-Android ב-Android Studio.

אתם יכולים להציג בעיות בנתוני 'תפקוד האפליקציה' ב-Android, לסנן אותן ולעבור ממעקב ה-stack לקוד – והכול מחלון הכלי תובנות לגבי איכות האפליקציה. כדי להתחיל:

  1. נכנסים לחשבון הפיתוח ב-Android Studio באמצעות סמל הפרופיל שבסוף סרגל הכלים.
  2. פותחים את App Quality Insights בלחיצה על חלון הכלים ב-Android Studio או בלחיצה על View (תצוגה) > Tool Windows (חלונות כלים) > App Quality Insights (תובנות לגבי איכות האפליקציה).
  3. לוחצים על הכרטיסייה Android vitals בקטע תובנות לגבי איכות האפליקציה.
  4. אופציונלי: כדי להשתמש בשילוב של בקרת גרסאות לגרסה של build שניתנת לניפוי באגים, מוסיפים לאפליקציה את Firebase Crashlytics SDK (או את Firebase Android Bill of Materials) העדכני. לאחר מכן מוסיפים את הקוד הבא לקובץ build.gradle.kts או build.gradle ברמת המודול. הדגל מופעל כברירת מחדל בגרסאות build של גרסאות ייצור (לא ניתנות לניפוי באגים).

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Groovy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

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

חלון הכלי של תובנות לגבי איכות האפליקציה

  1. בתפריט הנפתח של מזהה האפליקציה, בוחרים את מזהה האפליקציה שרוצים לנתח. לדוגמה, יכול להיות שתעבדו על גרסת ניפוי הבאגים של האפליקציה בסביבת הפיתוח המשולבת, אבל תרצו לראות את נתוני האירועים של גרסת הייצור של האפליקציה שהמשתמשים מתקינים.
  2. בחלונית בעיות מוצגים האירועים המובילים שיש ל-Crashlytics נתונים לגביהם, והיא ממוינת לפי הקריסות שהכי השפיעו עלכם.
  3. הצגת אירועים לפי וריאנטים, או קבוצות של אירועים שיש להם מעקב סטאק דומה. ניתוח אירועים לפי וריאנט עוזר לזהות את הגורמים לקריסה.
  4. בכרטיסייה Stack trace מוצגים פרטים על המופע האחרון של האירוע שבו לוחצים בחלונית Issues. אפשר לראות את מעקב ה-stack של האירוע וללחוץ עליו כדי לעבור לשורות הרלוונטיות בקוד. אם הקוד השתנה מאז התקרית, לוחצים על show diff לצד השגיאה ב-stack trace כדי להציג את ההבדל בין הקוד הנוכחי לבין הגרסה של קוד הבסיס שגרמה לקריסה.

    אפשרות להציג את ההבדל ב-AQI stack trace.

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

  5. בכרטיסיות Keys ו-Logs מוצגים זוגות מפתח/ערך מותאם אישית ויומנים לכל דוח ב-Crashlytics.
  6. בחלונית פרטים מוצג פירוט של מספרי הקריסות לפי סוג המכשיר וגרסה של Android, כדי שתוכלו לקבוע אילו קבוצות משתמשים מושפעות הכי הרבה. בנוסף, מוצגות גרסאות האפליקציה שבהן הייתה קריסה ומספר המשתמשים שהושפעו.
  7. לקרוא הערות ולצרף אותן לבעיות, כדי שהן יהיו גלויות במסוף Firebase ולחברים בצוות. כדי לכתוב הערה לגבי בעיה, בוחרים את הבעיה ופתיחים את החלונית הערות. כדי לכתוב הערות, צריכה להיות לכם הרשאת כתיבה בפרויקט Crashlytics. בעיות עם הערות מופיעות עם סמל הערות בחלונית בעיות.
    חלונית ההערות של תובנות לגבי איכות האפליקציה.
  8. אפשר להשתמש במגוון המסננים כדי להתמקד בקבוצות משנה מסוימות של אירועים. אפשר לבחור או לבטל את הבחירה באירועים מסוג 'קריטי' , 'לא קריטי' וANR , וגם לסנן לפי זמן, גרסת אפליקציה, אות Crashlytics, יצרן ומדגם המכשיר וגרסה של פלטפורמת Android. לתשומת ליבכם: בסטטוסים של Crashlytics Signal, בעיה נחשבת חזרה אם היא נסגרה בעבר והתרחשה שוב בגרסה חדשה של האפליקציה.

בנוסף לאפשרות לנווט ממעקב סטאק לקוד, אפשר גם לעבור מקוד למעקב סטאק: עכשיו ב-Android Studio מופיעים סימונים של קווים בקוד שקשורים לקריסות, עם סמל של בורר קריסות , כדי שתוכלו לזהות אותם בקלות ולפתור את הבאגים.

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

סיכום האירוע כשמציבים את סמן העכבר מעל סמל התאונה

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

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

מספרים שונים בין Android Vitals לבין Crashlytics

חשוב לזכור שיכול להיות שמערכת Android Vitals ו-Crashlytics ידווחו על ערכים שונים של מספר המשתמשים והאירועים שמשויכים לאותו קריסה. הפערים האלה נובעים מכך שמערכת Play ו-Crashlytics יכולות לזהות קריסות בזמנים שונים ובמשתמשים שונים. ריכזנו כאן כמה סיבות אפשריות להבדלים בין המספרים ב-Play לבין המספרים ב-Crashlytics:

  • מערכת Play מתעדת קריסות החל מזמן האתחול, ואילו Crashlytics מתעדת קריסות שמתרחשות אחרי שה-SDK של Crashlytics מופעל.
  • אם משתמש מבטל את ההסכמה לדיווח על קריסות כשמקבל טלפון חדש, הקריסות האלה לא ידווחו ל-Play. עם זאת, מערכת Crashlytics מזהה קריסות על סמך מדיניות הפרטיות של האפליקציה.

בדיקה עם פונקציונליות מוגבלת במצב אופליין

אם שולחים בקשה חדשה, למשל בלחיצה על רענון, ו-Android Studio לא מצליח לתקשר עם Crashlytics, אפשר להיכנס למצב אופליין בחלון תובנות לגבי איכות האפליקציה.

ב-App Quality Insights יש מצב אופליין.

במצב הזה, תוכלו להמשיך לבדוק בעיות ואת האירועים האחרונים מהנתונים ששמורים במטמון. חלק מהפונקציונליות, כמו שינוי של חלק מאפשרויות הסינון או סגירת בעיות, לא זמינה. כדי לנסות שוב להתחבר ל-Crashlytics ולחזור למצב אונליין, לוחצים על Reconnect (התחברות מחדש) .