קבלת דוחות קריסה קריאים בלוח הבקרה של Crashlytics‏ (Flutter)

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

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

פלטפורמות של אפל

בדיקת ההגדרות להעלאת קובצי dSYM

הוספה של Crashlytics Flutter plugin והרצה של הפקודה flutterfire configure ינסו להוסיף סקריפט הרצה לסביבת העבודה של פרויקט Xcode, שימצא ויעלה את קובצי הסמלים dSYM הנדרשים אל Crashlytics. בלי הקבצים האלה, תופיע התראה 'חסר dSYM' בלוח הבקרה Crashlytics, והחריגים יוחזקו על ידי ה-Backend עד להעלאת הקבצים החסרים.

אם נתקלתם בבעיה הזו, קודם כל ודאו שהתקנתם את סקריפט ההרצה:

1. מאתרים ופותחים את קובץ סביבת העבודה של Xcode בספריית iOS של הפרויקט (FLUTTER_PROJECT_NAME/ios/Runner.xcworkspace).

2. בודקים אם סקריפט הפעלה בשם [firebase_crashlytics] Crashlytics Upload Symbols נוסף לשלבי הבנייה של יעד ה-Runner.

   בהמשך מוסבר מה קורה אם סקריפט ההפעלה לא קיים ומה קורה אם סקריפט ההפעלה קיים.

בודקים את הגדרת הגרסה של Flutter ושל Crashlytics (אם משתמשים בדגל --split-debug-info)

אם פרויקט Flutter שלכם משתמש בדגל --split-debug-info (ובאופן אופציונלי גם בדגל --obfuscate), צריך לבצע שלבים נוספים כדי להציג עקבות מחסנית קריאה קריאות באפליקציה.

חשוב לוודא שהפרויקט שלכם משתמש בהגדרת הגרסה המומלצת (Flutter 3.12.0 ומעלה וCrashlyticsפלאגין Flutter‏ 3.3.4 ומעלה) כדי שהפרויקט יוכל ליצור ולהעלות באופן אוטומטי סמלי Flutter (קבצי dSYM) אל Crashlytics.

Android

בדיקת הגדרות התלות

הפקודה flutterfire configure מנסה להוסיף תלויות נדרשות לקובצי ה-build של Gradle בפרויקט. אם התלות הזו לא קיימת, יכול להיות שדוחות הקריסה במסוף Firebase יהיו מעורפלים אם ההסתרה מופעלת.

מוודאים שהשורות הבאות מופיעות בקובץ build.gradle ברמת הפרויקט ובקובץ build.gradle ברמת האפליקציה:

• בקובץ ה-build ברמת הפרויקט (android/build.gradle), מחפשים את השורה הבאה:

  dependencies {
  // ... other dependencies
  
  classpath 'com.google.gms:google-services:4.3.5'
  classpath 'com.google.firebase:firebase-crashlytics-gradle:2.7.1'
  }

• בקובץ ה-build ברמת האפליקציה (android/app/build.gradle), מחפשים את השורה הבאה:

  // ... other imports
  
  android {
  // ... your android config
  }
  
  dependencies {
  // ... your dependencies
  }
  
  // This section must appear at the bottom of the file
  apply plugin: 'com.google.gms.google-services'
  apply plugin: 'com.google.firebase.crashlytics'

בודקים שאתם משתמשים ב-CLI כדי להעלות סמלי Flutter (אם משתמשים בדגל --split-debug-info)

אם פרויקט Flutter שלכם משתמש בדגל --split-debug-info (ובאופן אופציונלי גם בדגל --obfuscate), צריך לבצע שלבים נוספים כדי להציג עקבות מחסנית קריאה קריאות באפליקציה.

משתמשים ב-Firebase CLI (גרסה 11.9.0 ואילך) כדי להעלות סמלי ניפוי באגים של Flutter. צריך להעלות את סמלי ניפוי הבאגים לפני שמדווחים על קריסה מגרסת build של קוד שעבר טשטוש.

מתיקיית השורש של פרויקט Flutter, מריצים את הפקודה הבאה:

firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/symbols

• ‫FIREBASE_APP_ID: מזהה האפליקציה ל-Android ב-Firebase (לא שם החבילה)
  דוגמה למזהה אפליקציה ל-Android ב-Firebase: 1:567383003300:android:17104a2ced0c9b9b

  צריך למצוא את מזהה האפליקציה ב-Firebase?

  יש שתי דרכים לאתר את מזהה האפליקציה ב-Firebase:

  • בקובץ google-services.json, מזהה האפליקציה הוא הערך mobilesdk_app_id, או

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

• ‫PATH/TO/symbols: אותה ספרייה שמעבירים לדגל --split-debug-info כשיוצרים את האפליקציה

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