קבלת דוחות קריסה קריאים במרכז הבקרה של 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 את עקבות מחסנית עם סימבולים לקריסות של ספריות מקוריות, צריך להעלות מידע על סימבולים בזמן הבנייה באמצעות Firebase CLI.

1. מוודאים שמשתמשים ב-Unity SDK בגרסה Crashlytics 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 > 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 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: מזהה האפליקציה שלך ב-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 לא מומלץ לשימוש. מומלץ להשתמש בברירת המחדל של מחולל קובצי הסמלים של Breakpad.
      --generator=breakpad	שימוש בכלי ליצירת קובצי סמלים של Breakpad הערה: ברירת המחדל ליצירת קובץ סמלים היא Breakpad. משתמשים בדגל הזה רק אם הוספתם את symbolGenerator { csym() } להגדרת ה-build ורוצים לבטל את ההגדרה הזו כדי להשתמש ב-Breakpad במקום זאת.
      --dry-run	יוצר את קובצי הסמלים אבל לא מעלה אותם התג הזה שימושי אם רוצים לבדוק את התוכן של הקבצים שנשלחים.
      --debug	מספק מידע נוסף על תוצאות ניפוי הבאגים