دریافت گزارش‌های خرابی خوانا در داشبورد Crashlytics (یونیتی)

انتخاب پلاتفرم: iOS+ Android Flutter Unity


iOS+ (پلاتفرم‌های Apple)

برای برنامه‌های پلاتفرم 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. مطمئن شوید که از Crashlytics Unity SDK نسخه ۸.۶.۱ یا جدیدتر استفاده می‌کنید. جدیدترین نسخه را بارگیری کنید.

  2. محیط و پروژه خود را برای بارگذاری نمادها راه‌اندازی کنید:

    1. دستورالعمل‌های نصب Firebase CLI را دنبال کنید.

      اگر قبلاً CLI را نصب کرده‌اید، حتماً آن را به جدیدترین نسخه‌اش به‌روز کنید.

    2. (فقط برای برنامه‌هایی که از میانای برنامه‌سازی کاربردی Android سطح ۳۰+ استفاده می‌کنند) الگوی AndroidManifest.xml برنامه‌تان را به‌روز کنید تا «برچسب‌گذاری اشاره‌گر» غیرفعال شود:

      1. چارگوش تنظیمات پخش‌کننده Android > تنظیمات انتشار > ساخت > مانیفست اصلی سفارشی را علامت بزنید.

      2. الگوی مانیفست را که در Assets/Plugins/Android/AndroidManifest.xml قرار دارد باز کنید.

      3. (فقط برای برنامه‌هایی که از نسخه کیت توسعه نرم‌افزار قبل‌از ۸.۸.۰ استفاده می‌کنند) مشخصه زیر را به برچسب برنامه اضافه کنید: <application android:allowNativeHeapPointerTagging="false" ... />

  3. پروژه‌تان را بسازید و نمادها را بارگذاری کنید.

    هر بار که ساخت نسخه پخش یا هر ساخت دیگری را ایجاد می‌کنید که می‌خواهید رد پشته نمادین‌شده آن را در داشبورد Crashlytics ببینید، این مراحل را تکمیل کنید.

    1. در کادر گفتگوی تنظیمات ساخت، یکی از کارهای زیر را انجام دهید:

      • به پروژه «استودیو Android» صادر کنید تا پروژه‌تان را بسازید؛ یا

      • APK خود را مستقیماً از Unity Editor بسازید.
        قبل‌از ساختن، مطمئن شوید چارگوش انتخاب ایجاد symbols.zip در کادر گفتگوی تنظیمات ساختن علامت زده شده باشد.

    2. پس‌از اتمام ساخت، فایل نماد سازگار با Crashlytics را تولید کنید و با اجرای فرمان CLI زیر، آن را در سرورهای Firebase بارگذاری کنید: Firebase

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: شناسه برنامه Android در Firebase (نه نام بسته شما)
        نمونه شناسه برنامه Android در Firebase: 1:567383003300:android:17104a2ced0c9b9b

      • ‫PATH/TO/SYMBOLS: مسیر فایل نماد تولیدشده توسط CLI

        • به پروژه «استودیو Android» صادر شد — PATH/TO/SYMBOLS دایرکتوری unityLibrary/symbols است، که پس‌از ساختن برنامه ازطریق Gradle یا «استودیو Android» در ریشه پروژه صادرشده ایجاد می‌شود.

        • فایل APK را مستقیماً از داخل Unity ساخته‌اید — PATH/TO/SYMBOLS مسیر فایل نماد فشرده‌شده است که پس‌از تکمیل ساخت در دایرکتوری ریشه پروژه تولید شده است (برای مثال: myproject/myapp-1.0-v100.symbols.zip).

      مشاهده گزینه‌های پیشرفته برای استفاده از فرمان Firebase CLI برای تولید و بارگذاری فایل نماد

      پرچم شرح
      --generator=csym

      به‌جای تولیدکننده پیش‌فرض Breakpad، از تولیدکننده فایل نماد cSYM قدیمی استفاده می‌کند

      استفاده از آن توصیه نمی‌شود. توصیه می‌کنیم از تولیدکننده فایل نماد Breakpad پیش‌فرض استفاده کنید.

      --generator=breakpad

      از تولیدکننده فایل نماد Breakpad استفاده می‌کند

      توجه داشته باشید که Breakpad پیش‌فرض تولید فایل نماد است. فقط درصورتی از این پرچم استفاده کنید که symbolGenerator { csym() } را در پیکربندی ساختتان اضافه کرده باشید و بخواهید آن را لغو کنید تا به‌جای آن از Breakpad استفاده کنید.

      --dry-run

      فایل‌های نماد را تولید می‌کند اما آن‌ها را بارگذاری نمی‌کند

      این پرچم زمانی مفید است که بخواهید محتوای فایل‌های ارسالی را بررسی کنید.

      --debug اطلاعات اشکال‌زدایی بیشتری ارائه می‌دهد