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

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

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

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

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

      • 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	מידע נוסף על ניפוי הבאגים