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

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

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

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

שנתחיל?

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

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

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

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

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

1. נכנסים לחשבון המפתחים ב-Android Studio באמצעות סמל הפרופיל בסוף סרגל הכלים.
2. פותחים את App Quality Insights (תובנות לגבי איכות האפליקציה) על ידי לחיצה על חלון הכלים ב-Android Studio או על ידי לחיצה על View > Tool Windows > App Quality Insights (תצוגה > חלונות של כלים > תובנות לגבי איכות האפליקציה).
3. בכרטיסייה App Quality Insights, לוחצים על תפקוד האפליקציה.

4. אופציונלי: כדי להשתמש בשילוב של ניהול גרסאות ב-build שאפשר לנפות בו באגים, מוסיפים לאפליקציה את Firebase Crashlytics SDK (או את עץ המוצר (BoM) של Firebase ל-Android) בגרסה האחרונה. לאחר מכן מוסיפים את הקוד הבא לקובץ build.gradle.kts או build.gradle ברמת המודול. בגרסאות build של Release (שלא ניתן לבצע בהן ניפוי באגים), הדגל מופעל כברירת מחדל.

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

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

ניתוח נתונים של Crashlytics ב-Android Studio

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

1. בתפריט הנפתח של מזהה האפליקציה, בוחרים את מזהה האפליקציה שרוצים לנתח. לדוגמה, יכול להיות שאתם עובדים על גרסת הניפוי באגים של האפליקציה בסביבת הפיתוח המשולבת, אבל רוצים לראות נתוני אירועים של גרסת הייצור של האפליקציה שהמשתמשים מתקינים.
2. בחלונית Issues מוצגים האירועים המובילים שיש ל-Crashlytics נתונים לגביהם, והיא ממוינת לפי הקריסות שהכי משפיעות על האפליקציה.
3. לראות את האירועים לפי וריאציות, או קבוצות של אירועים עם עקבות מחסנית דומים. ניתוח אירועים לפי וריאנט עוזר לזהות את שורש הבעיות של קריסה.

4. בכרטיסייה דוח קריסות מוצגים פרטים על המופע האחרון של האירוע שעליו לוחצים בחלונית Issues. אפשר לראות את דוח הקריסות של האירוע וללחוץ על דוח הקריסות כדי לעבור לשורות הרלוונטיות בבסיס הקוד. אם הקוד השתנה מאז שהתרחשה הקריסה, לוחצים על show diff לצד השגיאה ב<term>דוח קריסות</term> כדי לראות את ההבדלים בין הקוד הנוכחי לבין גרסת בסיס הקוד שיצרה את הקריסה.

   

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

5. בכרטיסיות Keys (מפתחות) ו-Logs (יומנים) מוצגים זוגות מותאמים אישית של מפתח/ערך ויומנים לכל דוח של Crashlytics.
6. בחלונית פרטים מוצג פירוט של מספר הקריסות לפי סוג המכשיר וגרסת Android, כך שאפשר לזהות את קבוצות המשתמשים שהושפעו הכי הרבה. ‫It also shows which app versions experienced the crash and the number of users affected.
7. לקרוא הערות ולצרף אותן לבעיות כדי שיהיו גלויות במסוף Firebase ולחברי הצוות. כדי לכתוב הערה על בעיה, בוחרים את הבעיה ופותחים את החלונית הערות. כדי לכתוב הערות, צריכה להיות לכם הרשאת כתיבה לפרויקט Crashlytics. בעיות בסיכום הפגישה מופיעות עם סמל של סיכום פגישה בחלונית בעיות.

   

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

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

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

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

מספרים שונים בין תפקוד האפליקציה לבין Crashlytics

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

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

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

אם שולחים בקשה חדשה, למשל על ידי לחיצה על רענון, ו-Android Studio לא מצליח לתקשר עם Crashlytics, אפשר להזין את מצב אופליין בחלון App Quality Insights.

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

הרשאות

הרשאות שירות