קבלת דוחות קריסה קריאים במרכז הבקרה של Crashlytics


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

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

Android

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

  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.

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

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

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

    צריך לבצע את השלבים האלה בכל פעם שיוצרים גרסת הפצה או כל גרסה אחרת שרוצים לראות בה עקבות מחסנית עם סימבולים במסוף Firebase.

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

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

      • יוצרים את קובץ ה-APK ישירות מכלי העריכה של Unity.
        לפני שמבצעים Build, מוודאים שתיבת הסימון 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 מספק מידע נוסף לצורך ניפוי באגים