گزارش‌های خرابی قابل خواندن را در داشبورد Crashlytics دریافت کنید


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

برای برنامه‌های پلتفرم اپل که از Crashlytics Unity SDK 8.2.0+ استفاده می‌کنند، افزونه Firebase Unity Editor به طور خودکار پروژه Xcode شما را برای آپلود نمادها پیکربندی می‌کند. آخرین نسخه را دانلود کنید.

اندروید

برای برنامه‌های اندروید، Crashlytics Unity SDK 8.6.1+ به طور خودکار شامل گزارش خرابی NDK است که به Crashlytics اجازه می‌دهد تا به طور خودکار خرابی‌های Unity IL2CPP را در اندروید گزارش دهد. با این حال، برای مشاهده ردیابی‌های پشته نمادین برای خرابی‌های کتابخانه بومی در داشبورد Crashlytics ، باید اطلاعات نماد را در زمان ساخت با استفاده از Firebase CLI بارگذاری کنید.

  1. مطمئن شوید که از Crashlytics Unity SDK نسخه ۸.۶.۱ یا بالاتر استفاده می‌کنید. آخرین نسخه را دانلود کنید.

  2. محیط و پروژه خود را برای آپلود نماد تنظیم کنید:

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

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

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

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

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

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

  3. پروژه خود را بسازید و نمادها را آپلود کنید.

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

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

      • برای ساخت پروژه خود، آن را به یک پروژه اندروید استودیو منتقل کنید؛ یا

      • APK خود را مستقیماً از ویرایشگر Unity بسازید.
        قبل از ساخت، مطمئن شوید که کادر انتخاب Create symbols.zip در کادر محاوره‌ای Build Settings علامت زده شده باشد.

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

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

      • FIREBASE_APP_ID : شناسه برنامه اندروید Firebase شما (نه نام بسته شما)
        مثالی از شناسه برنامه اندروید فایربیس: 1:567383003300:android:17104a2ced0c9b9b

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

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

        • 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 اطلاعات اشکال‌زدایی اضافی ارائه می‌دهد