ניתוח בעיות מ-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, לוחצים על Crashlytics ופועלים לפי ההוראות במדריך כדי להוסיף את Firebase ו-Crashlytics לפרויקט. מידע נוסף על תהליך העבודה של Firebase Assistant זמין במדריך לתחילת העבודה עם Firebase ל-Android.

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

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

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

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

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

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

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

   

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

5. בכרטיסיות Keys (מפתחות) ו-Logs (יומנים) מוצגים זוגות מותאמים אישית של מפתח/ערך ויומנים לכל דוח של Crashlytics.
6. בחלונית פרטים מוצג פירוט של מספר הקריסות לפי סוג המכשיר וגרסת Android, כך שאפשר לזהות את קבוצות המשתמשים שהכי מושפעות מהבעיה. הדוח מציג גם את גרסאות האפליקציה שבהן התרחשה הקריסה ואת מספר המשתמשים שהושפעו.
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 (התחברות מחדש) .

הרשאות

הרשאות שירות