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

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

iOS+‎ Android Flutter Unity

‫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, ודאו שעדכנתם אותו לגרסה העדכנית.

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

      1. מסמנים את התיבה הגדרות הנגן של 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 ליצירה ולהעלאה של קובץ סמלים

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