الحصول على تقارير أعطال قابلة للقراءة في لوحة بيانات Crashlytics
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
iOS+ (منصات Apple)
بالنسبة إلى تطبيقات منصة Apple التي تستخدم الإصدار 8.2.0 أو إصدارًا أحدث من Crashlytics Unity SDK، يضبط المكوّن الإضافي Firebase
Unity Editor تلقائيًا مشروع Xcode لتحميل الرموز. تنزيل أحدث إصدار
Android
بالنسبة إلى تطبيقات Android، تتضمّن Crashlytics حزمة تطوير البرامج (SDK) 8.6.1 والإصدارات الأحدث تلقائيًا ميزة إعداد تقارير الأعطال في NDK، ما يتيح Crashlytics إعداد تقارير تلقائية عن أعطال IL2CPP في Unity على Android. ومع ذلك، لعرض عمليات تتبُّع تسلسل استدعاء الدوال البرمجية التي تم تحويلها إلى رموز لكي يتمكّن الكمبيوتر من قراءتها، وذلك في ما يتعلّق بالأعطال في المكتبة الأصلية، ضِمن لوحة بيانات Crashlytics، عليك تحميل معلومات الرموز في وقت الإنشاء باستخدام واجهة سطر الأوامر Firebase.
تأكَّد من استخدام الإصدار 8.6.1 أو إصدار أحدث من حزمة تطوير البرامج (SDK) Crashlytics Unity.
تنزيل أحدث إصدار
(فقط للتطبيقات التي تستخدم المستوى 30 أو أعلى من واجهة برمجة التطبيقات Android) عدِّل نموذج
AndroidManifest.xml لتتمكّن من إيقاف ميزة "وضع علامات على المؤشر" باتّباع الخطوات التالية:
ضَع علامة في المربّع بجانب إعدادات مشغّل Android > إعدادات النشر >
إنشاء > ملف البيان الرئيسي المخصّص.
افتح نموذج البيان في
Assets/Plugins/Android/AndroidManifest.xml.
(للتطبيقات التي تستخدم إصدارًا من حزمة SDK قبل
8.8.0 فقط) أضِف السمة التالية إلى علامة التطبيق:
<application android:allowNativeHeapPointerTagging="false" ... />
أنشئ مشروعك وحمِّل الرموز.
يجب إكمال هذه الخطوات في كل مرة تنشئ فيها إصدارًا أو أي إصدار تريد عرض عمليات تتبُّع تسلسل استدعاء الدوال البرمجية مع رموزها في وحدة تحكّم Firebase.
من مربّع الحوار إعدادات الإنشاء، نفِّذ أحد الإجراءات التالية:
تصديرها إلى مشروع في "استوديو Android" لإنشاء مشروعك
إنشاء حزمة APK مباشرةً من Unity Editor
قبل الإنشاء، تأكَّد من وضع علامة في مربّع الاختيار إنشاء ملف symbols.zip في مربّع الحوار إعدادات الإنشاء.
بعد انتهاء عملية الإنشاء، أنشئ ملف رموز متوافقًا مع Crashlytics وحمِّله إلى خوادم Firebase من خلال تنفيذ أمر Firebase التالي في واجهة سطر الأوامر:
FIREBASE_APP_ID: رقم تعريف تطبيق Firebase على Android (وليس اسم الحزمة)
مثال على رقم تعريف تطبيق Firebase على Android: 1:567383003300:android:17104a2ced0c9b9b
هل تحتاج إلى العثور على معرّف تطبيقك في Firebase؟
في ما يلي طريقتان للعثور على معرّف التطبيق في Firebase:
في ملف google-services.json، يكون رقم تعريف التطبيق هو قيمة mobilesdk_app_id.
في وحدة تحكّم Firebase، انتقِل إلى إعدادات المشروع.
انتقِل للأسفل إلى بطاقة تطبيقاتك، ثم انقر على تطبيق Firebase المطلوب للعثور على رقم تعريف التطبيق.
PATH/TO/SYMBOLS: مسار ملف الرموز الذي تم إنشاؤه بواسطة واجهة سطر الأوامر
تم تصديرها إلى مشروع في "استوديو Android" —
PATH/TO/SYMBOLS هو دليل unityLibrary/symbols،
الذي يتم إنشاؤه في جذر المشروع الذي تم تصديره بعد إنشاء التطبيق
باستخدام Gradle أو "استوديو Android".
تم إنشاء حزمة APK مباشرةً من داخل Unity —
PATH/TO/SYMBOLS هو مسار ملف الرموز المضغوط
الذي تم إنشاؤه في دليل جذر المشروع عند انتهاء عملية الإنشاء
(على سبيل المثال:
myproject/myapp-1.0-v100.symbols.zip).
عرض الخيارات المتقدّمة لاستخدام
أمر Firebase واجهة سطر الأوامر لإنشاء ملف الرموز وتحميله
Flag
الوصف
--generator=csym
يستخدم أداة إنشاء ملفات رموز cSYM القديمة بدلاً من أداة الإنشاء التلقائية في Breakpad
لا يُنصح باستخدامه. ننصح باستخدام أداة إنشاء ملفات رموز Breakpad التلقائية.
--generator=breakpad
استخدام أداة إنشاء ملفات رموز Breakpad
يُرجى العِلم أنّ الإعداد التلقائي لإنشاء ملفات الرموز هو Breakpad.
لا تستخدِم هذا الخيار إلا إذا أضفت
symbolGenerator { csym() }
في إعدادات الإصدار وأردت تجاوزه لاستخدام
Breakpad بدلاً من ذلك.
--dry-run
إنشاء ملفات الرموز بدون تحميلها
تكون هذه العلامة مفيدة إذا أردت فحص محتوى الملفات التي يتم إرسالها.
تاريخ التعديل الأخير: 2025-08-11 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-11 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Get readable crash reports in the Crashlytics dashboard\n\n\u003cbr /\u003e\n\niOS+ Android Flutter Unity \n\n\u003cbr /\u003e\n\nBy default, Firebase Crashlytics automatically processes your debug symbol\n(dSYM) files to give you deobfuscated and human-readable crash reports. You\nusually configure this behavior during the initial setup of Crashlytics in\nyour app, specifically by\n[adding a run script](/docs/crashlytics/get-started?platform=ios#set-up-dsym-uploading)\nthat automatically uploads dSYM files during your app's build phase.\n\nUnfortunately, there are a few cases that could cause your automatic dSYM files\nupload to fail. This guide provides some ways to troubleshoot when\nCrashlytics can't locate your app's dSYM files.\n\nMake sure Xcode can automatically process dSYMs and upload the files\n--------------------------------------------------------------------\n\nWhen setting up Crashlytics in your app, you\n[configured a run script](/docs/crashlytics/get-started?platform=ios#set-up-dsym-uploading)\nto automatically process dSYMs and upload the files.\n\nMake sure that your configuration for the Crashlytics run script is\nup-to-date with the new requirements which started with Xcode 15. If your\nconfiguration isn't up-to-date, you might be getting the following error: \n\n`error: Info.plist Error Unable to process Info.plist at path ...`.\n\nSpecifically, Xcode 15 and later requires that you provide a more complete set\nof file locations. For your Crashlytics run script\n(`firebase-ios-sdk/Crashlytics/run`), make sure that you have the following\nsetup:\n\n1. Click the **Build Phases** tab, and then expand the *Run Script* section.\n\n2. In the *Input Files* section, make sure you have the paths for the locations\n of the following files:\n\n ```\n ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}\n ``` \n\n ```\n ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}\n ``` \n\n ```\n ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist\n ``` \n\n ```\n $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist\n ``` \n\n ```\n $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)\n ```\n If you have `ENABLE_USER_SCRIPT_SANDBOXING=YES` and `ENABLE_DEBUG_DYLIB=YES` in your project build settings, then include the following: \n\n ```\n ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}.debug.dylib\n ```\n **Understand why the locations of these files are\n needed**\n\n Xcode looks in the specified locations for these input files to ensure\n that the build files are available for the run script. Also, if\n *User Script Sandboxing* is enabled, Xcode only allows the run\n script to access files specified in the *Input Files*.\n - Providing the location of your project's dSYM files enables Crashlytics to process dSYMs.\n - Providing the location of your app's built `GoogleService-Info.plist` file enables Crashlytics to associate the dSYMs with your Firebase app.\n - Providing the location of your app's executable allows the run script to prevent duplicate uploads of the same dSYM. Note that app binaries are *not uploaded*.\n\nCheck if Xcode is producing dSYMs\n---------------------------------\n\nMore often than not, dSYM files go missing because Xcode simply isn't producing\nthem. When an upload fails, Crashlytics displays a \"Missing dSYM\" alert in\nthe Firebase console. If you get this alert, first check that Xcode is\nproducing the correct dSYM for every build:\n\n1. Open your project in Xcode, and then select the project file in the Xcode\n Navigator.\n\n2. Select your main build target.\n\n3. Open the target's **Build Settings** tab, and then click **All**.\n\n4. Search for `debug information format`.\n\n5. Set **Debug Information Format** to **DWARF with dSYM File** for all\n your build types.\n\n6. Rebuild your app.\n\nYour crash reports should now appear in the\n[Crashlytics dashboard](https://console.firebase.google.com/project/_/crashlytics). If the problem persists or you\nencounter other errors, try [locating your dSYMs](#locate) and\n[uploading them to Crashlytics manually](#upload-dsyms).\n\nLocate your dSYMs on a local machine\n------------------------------------\n\nRun the following command to display all your dSYMs' UUIDs on your machine and\nsearch for the missing dSYM: \n\n```text\nmdfind -name .dSYM | while read -r line; do dwarfdump -u \"$line\"; done\n```\n\nOnce you find the dSYM, [manually upload it to Crashlytics](#upload-dsyms).\nIf the `mdfind` command doesn't return any results, you can look in the\n`Products` directory where your `.app` lives (by default, the `Products`\ndirectory is located in `Derived Data`). If your app is released to production,\nyou can also look for its dSYM in the `.xcarchive` directory on disk:\n\n1. In Xcode, open the **Organizer** window, and then select your app from the\n list. Xcode displays a list of archives for your project.\n\n2. Control-click an archive to view it in Finder. Control-click it again, and\n then click **Show Package Contents**.\n\n3. Within `.xcarchive` is a dSYMs directory that contains dSYMs generated as\n part of Xcode's archiving process.\n\nUpload your dSYMs\n-----------------\n\nCrashlytics supports multiple ways to upload your dSYMs files, either\n[automatically](#auto-upload-dsyms) or [manually](#manually-upload-dsyms).\n\n### *(Recommended)* Automatically process your dSYMs and upload the files\n\nWhen you initially set up Crashlytics, you most likely configured this\nautomatic upload behavior for your app. However, if automatic uploads are\nfailing, [check that your configuration is correct](#check-input-files-setup).\n\n### Manually upload your dSYM files\n\nIf automatic uploads are failing, you can manually upload your dSYM files using\neither of the following options.\n\n- **Option 1** : Use the console-based \"Drag and Drop\" option to upload a zip\n file containing your dSYM files (go to the\n Firebase console \\\u003e\n [Crashlytics](https://console.firebase.google.com/project/_/crashlytics) \\\u003e\n *dSYMs* tab).\n\n- **Option 2** : Use the `upload-symbols` script that you can call from\n anywhere in your build process to manually upload your dSYM files. To run the\n `upload-symbols` script, use either of the following options:\n\n - **Option A**: Include the following line in your build process:\n\n ```gdscript\n find dSYM_DIRECTORY -name \"*.dSYM\" | xargs -I \\{\\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \\{\\}\n ```\n - **Option B**: Run the script directly from your terminal:\n\n ```\n /PATH/TO/PODS/DIRECTORY/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p ios /PATH/TO/dSYMs\n ```\n\n For usage notes and additional instructions about this script, run\n `upload-symbols` with the `--help` parameter."]]
