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


iOS+‏ (פלטפורמות של Apple)

באפליקציות לפלטפורמות של 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 את הנתונים של מעקב הסטאק המתווסף (symbolicated) של קריסות בספריות מקומיות, צריך להעלות את פרטי הסמלים בזמן ה-build באמצעות CLI של Firebase.

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

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

    1. פועלים לפי ההוראות להתקנת ה-CLI של Firebase.

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

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

      1. מסמנים את התיבה הגדרות נגן Android > הגדרות פרסום > build > מניפסט ראשי מותאם אישית.

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

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

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

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

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

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

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

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

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

      • FIREBASE_APP_ID: מזהה האפליקציה ל-Android ב-Firebase (לא שם החבילה)
        מזהה אפליקציה לדוגמה ב-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).

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

      סימון תיאור
      --generator=csym

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

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

      --generator=breakpad

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

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

      --dry-run

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

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

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