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

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

iOS+‎ Android אינטרנט Flutter Unity

מומלץ להשתמש בגרסה העדכנית של Crashlytics Unity SDK (גרסה 14.1.0). להורדה של הגרסה העדכנית

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

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

Android

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

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

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

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

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

      הערה: אפשר גם להריץ פקודות של ה-CLI של Firebase ב-Cloud Shell. ‫Cloud Shell היא סביבה מבוססת-דפדפן של שורת פקודה שעברה אימות מראש, שאפשר לגשת אליה ממסוף Firebase, וה-CLI של Firebase מותקן בה מראש. לכן זו אפשרות נוחה להתחלה מהירה, בתנאי שמוסיפים את קובצי הפרויקט לסביבת Cloud Shell.

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

      1. מסמנים את התיבה Android Player Settings > Publishing Settings > Build > Custom Main Manifest.

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

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