קבלת דוחות קריסה קריאים בלוח הבקרה של 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 לדווח באופן אוטומטי על קריסות של Unity IL2CPP ב-Android. עם זאת, כדי לראות את עקבות מחסנית הקריאות עם סימבולים לקריסות של ספריית Native בלוח הבקרה Crashlytics, צריך להעלות מידע על סימבולים משך זמן של תהליך 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 > מניפסט ראשי מותאם אישית).

      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 כדי לבצע build של הפרויקט, או

      • אפשר ליצור את קובץ ה-APK ישירות מ-Unity Editor.
        לפני שיוצרים את ה-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: מזהה האפליקציה ל-Android ב-Firebase (לא שם החבילה)
        דוגמה למזהה אפליקציה ל-Android ב-Firebase: 1:567383003300:android:17104a2ced0c9b9b

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

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

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

        • במסוף Firebase, עוברים אל 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 ליצירה ולהעלאה של קובץ סמלים

      Flag	תיאור
      --generator=csym	משתמש במחולל קובצי הסמלים cSYM מדור קודם במקום במחולל ברירת המחדל Breakpad לא מומלץ לשימוש. מומלץ להשתמש בברירת המחדל של מחולל קובצי הסמלים של Breakpad.
      --generator=breakpad	שימוש בכלי ליצירת קובצי סמלים של Breakpad הערה: ברירת המחדל ליצירת קובץ סמלים היא Breakpad. משתמשים בדגל הזה רק אם הוספתם את symbolGenerator { csym() } להגדרת ה-build ואתם רוצים לבטל את ההגדרה הזו כדי להשתמש ב-Breakpad במקום זאת.
      --dry-run	יוצר את קובצי הסמלים אבל לא מעלה אותם הדגל הזה שימושי אם רוצים לבדוק את התוכן של הקבצים שנשלחים.
      --debug	מספק מידע נוסף על ניפוי באגים