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

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

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

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

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

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

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

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

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

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

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

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

חשוב לוודא שהפרויקט משתמש בהגדרת הגרסה המומלצת (Flutter 3.12.0 ומעלה וCrashlytics Flutter plugin 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: מזהה האפליקציה שלך ב-Firebase ל-Android (לא שם החבילה)
  דוגמה למזהה אפליקציה ב-Firebase ל-Android: 1:567383003300:android:17104a2ced0c9b9b

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

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

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

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

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

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