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

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

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

Android

באפליקציות ל-Android, ‏ Crashlytics Unity SDK 8.6.1+ כולל באופן אוטומטי דיווח על קריסות של NDK, שמאפשר ל-Crashlytics לדווח באופן אוטומטי על קריסות של IL2CPP ב-Android. עם זאת, כדי לראות בלוח הבקרה Crashlytics את עקבות מחסנית (stack traces) עם סימבולים לקריסות של ספריות מקוריות, צריך להעלות מידע על סימבולים בזמן הבנייה באמצעות Firebase CLI.

1. מוודאים שמשתמשים ב-Crashlytics Unity SDK v8.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).

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

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