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

בחירת פלטפורמה: ‫iOS+‎ Android Flutter Unity


‫iOS+‎ (פלטפורמות של אפל)

באפליקציות לפלטפורמת Apple שמשתמשות ב-Crashlytics Unity SDK בגרסה 8.2.0 ואילך, התוסף Firebase Unity Editor מגדיר אוטומטית את פרויקט Xcode להעלאת סמלים. כאן אפשר להוריד את הגרסה האחרונה.

Android

באפליקציות ל-Android, ‏ Crashlytics Unity SDK 8.6.1+ כולל באופן אוטומטי דיווח על קריסות של NDK, שמאפשר ל-Crashlytics לדווח באופן אוטומטי על קריסות של IL2CPP של Unity ב-Android. עם זאת, כדי לראות במרכז הבקרה Crashlytics עקבות מחסנית עם סימבולים לקריסות של ספריית Native, צריך להעלות את פרטי הסימבולים משך זמן של תהליך build באמצעות ה-CLI‏ Firebase.

  1. מוודאים שמשתמשים ב-Crashlytics Unity SDK גרסה 8.6.1 ואילך. מורידים את הגרסה העדכנית.

  2. מגדירים את הסביבה והפרויקט להעלאת סמלים:

    1. פועלים לפי ההוראות כדי להתקין את Firebase CLI.

      אם כבר התקנתם את ה-CLI, חשוב לעדכן לגרסה האחרונה.

    2. (רק לאפליקציות שמשתמשות ברמת API‏ 30 ומעלה של Android) צריך לעדכן את תבנית AndroidManifest.xml של האפליקציה כדי להשבית את התיוג של מצביע העכבר:

      1. מסמנים את התיבה Android Player Settings > Publishing Settings > Build > Custom Main Manifest (הגדרות של Android Player > הגדרות פרסום > Build > Custom Main Manifest).

      2. פותחים את תבנית המניפסט שנמצאת בכתובת Assets/Plugins/Android/AndroidManifest.xml.

      3. (רק לאפליקציות שמשתמשות בגרסת SDK לפני 8.8.0) מוסיפים את המאפיין הבא לתג application: <application android:allowNativeHeapPointerTagging="false" ... />

  3. יוצרים את הפרויקט ומעלים סמלים.

    צריך לבצע את השלבים האלה בכל פעם שיוצרים גרסת build להפצה או כל build אחר שרוצים לראות בו את דוחות הקריסות עם הנגשת דוח קריסה בשפה אנושית (symbolication) בלוח הבקרה Crashlytics.

    1. בתיבת הדו-שיח Build Settings (הגדרות בנייה), מבצעים אחת מהפעולות הבאות:

      • לייצא לפרויקט Android Studio כדי לבנות את הפרויקט, או

      • יוצרים את קובץ ה-APK ישירות מ-Unity Editor.
        לפני שיוצרים את הקובץ, מוודאים שתיבת הסימון Create symbols.zip מסומנת בתיבת הדו-שיח Build Settings.

    2. אחרי שה-build מסתיים, מריצים את פקודת Firebase CLI הבאה כדי ליצור קובץ סמלים שמתאים ל-Crashlytics ולהעלות אותו לשרתי Firebase:

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

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

      • ‫PATH/TO/SYMBOLS: הנתיב לקובץ הסמלים שנוצר על ידי ה-CLI

        • ייצוא לפרויקט Android Studio – PATH/TO/SYMBOLS היא הספרייה unityLibrary/symbols, שנוצרת בספריית השורש של הפרויקט המיוצא אחרי שבונה את האפליקציה באמצעות Gradle או Android Studio.

        • יצירת קובץ ה-APK ישירות מתוך Unity –‏ PATH/TO/SYMBOLS היא הנתיב של קובץ הסמלים הדחוס שנוצר בספריית השורש של הפרויקט כשה-build הסתיים (לדוגמה: myproject/myapp-1.0-v100.symbols.zip).

      הצגת אפשרויות מתקדמות לשימוש בפקודת Firebase CLI ליצירה ולהעלאה של קובץ סמלים

      Flag תיאור
      --generator=csym

      משתמש במחולל קובצי הסמלים cSYM מדור קודם במקום במחולל ברירת המחדל Breakpad

      לא מומלץ לשימוש. מומלץ להשתמש בברירת המחדל של מחולל קובצי הסמלים של Breakpad.

      --generator=breakpad

      שימוש במחולל קובצי הסמלים של Breakpad

      שימו לב: ברירת המחדל ליצירת קובץ סמלים היא Breakpad. משתמשים בדגל הזה רק אם הוספתם את הערך symbolGenerator { csym() } בהגדרות ה-build ואתם רוצים לשנות את ברירת המחדל ל-Breakpad.

      --dry-run

      יוצר את קובצי הסמלים אבל לא מעלה אותם

      התג הזה שימושי אם רוצים לבדוק את התוכן של הקבצים שנשלחים.

      --debug מספק מידע נוסף על תוצאות ניפוי הבאגים