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

בחירת פלטפורמה:

iOS+‎ Android Flutter Unity

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

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

Android

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

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

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

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

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

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

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

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

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

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

   צריך לבצע את השלבים האלה בכל פעם שיוצרים גרסת build להפצה או כל גרסת build שרוצים לראות בשבילה דוחות קריסות שעברו סימבוליזציה בלוח הבקרה של Crashlytics.

   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 (לא שם החבילה)
        דוגמה למזהה אפליקציית Android ב-Firebase: ‏1:567383003300:android:17104a2ced0c9b9b

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

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

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

        • במסוף Firebase, נכנסים לדף settings Settings > General. גוללים לכרטיס Your apps ולוחצים על אפליקציית 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 לא מומלץ לשימוש. אנחנו ממליצים להשתמש במחולל קובצי הסמלים של Breakpad שמוגדר כברירת מחדל.
      --generator=breakpad	שימוש במחולל קובצי הסמלים של Breakpad שימו לב שברירת המחדל ליצירת קובץ סמלים היא Breakpad. השתמשו בדגל הזה רק אם הוספתם את symbolGenerator { csym() } בתצורת ה-build ואתם רוצים לשנות אותה כדי להשתמש ב-Breakpad במקום זאת.
      --dry-run	יצירת קובצי הסמלים בלי להעלות אותם הדגל הזה שימושי אם רוצים לבדוק את התוכן של הקבצים שנשלחים.
      --debug	מספק מידע נוסף על תוצאות ניפוי הבאגים