مشکلات Firebase Crashlytics و Android Vitals را با اطلاعات کیفیت برنامه تجزیه و تحلیل کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
می‌توانید داده‌های خرابی برنامه را از Firebase Crashlytics و Android Vitals مستقیماً در Android Studio ببینید و روی آنها عمل کنید. این ادغام داده‌های ردیابی پشته و آمار خرابی را از Crashlytics و Google Play به پنجره ابزار App Quality Insights در Studio IDE می‌کشد، بنابراین لازم نیست بین مرورگر خود و IDE به عقب و جلو بپرید. تیم های توسعه می توانند از قابلیت های کلیدی از جمله موارد زیر بهره مند شوند:
خطوط در کدتان را که وقتی داده‌های رویداد Crashlytics مرتبط دارند، برجسته‌شده ببینید.
ردیابی پشته برای خرابی های بالا را ببینید و روی stack trace کلیک کنید تا به خطوط مربوطه در کد خود بروید.
آمار خلاصه‌ای درباره تصادفات برتر و رویدادهای غیرکشنده را ببینید، برای مثال گروه‌بندی‌شده بر اساس سازنده دستگاه و نسخه Android.
رویدادها را بر اساس ویژگی‌هایی از جمله شدت، زمان و نسخه برنامه فیلتر کنید.
پیوند مرورگری دریافت کنید که صفحه داشبورد Crashlytics را با جزئیات بیشتر درباره رویداد باز می کند.
بینش‌هایی دریافت کنید که به شما کمک می‌کند راحت‌تر دلایل ریشه‌ای برخی مسائل را درک کرده و حل کنید.
گزارش‌های Android Vitals برای همه برنامه‌های منتشر شده در Google Play در دسترس هستند. اگر هنوز از Crashlytics استفاده نمی‌کنید و می‌خواهید درباره پیشنهادات آن بیشتر بدانید، Firebase Crashlytics را ببینید.
شروع کنید
برای دیدن داده های Crashlytics در Android Studio، باید Firebase و Crashlytics را در پروژه برنامه خود راه اندازی کنید. به این صورت است: با رفتن به Tools > Firebase ، دستیار Firebase را در Android Studio باز کنید، روی Crashlytics کلیک کنید و سپس آموزش افزودن Firebase و Crashlytics را به پروژه خود دنبال کنید. می‌توانید در راهنمای شروع Firebase برای Android درباره گردش کار Firebase Assistant اطلاعات بیشتری کسب کنید.
اگر قبلاً Firebase و Crashlytics را به برنامه خود اضافه کرده اید، با کلیک بر روی نماد آواتار به حساب توسعه دهنده خود در IDE وارد شوید. . پس از ورود به سیستم، روی پنجره ابزار App Quality Insights کلیک کنید . باید ببینید که پانل ها مملو از گزارش های Crashlytics هستند.
آنالیز حیاتی اندروید
App Quality Insights شامل داده‌های حیاتی Android است. این به شما امکان می دهد راحت تر به معیارهای اصلی جمع آوری شده توسط Google Play دسترسی داشته باشید و تجربه کاربری خود را بهبود بخشید. برای کمک به بهبود کیفیت برنامه خود در Google Play، از برنامه حیاتی Android برای رفع مشکلات مربوط به پایداری برنامه استفاده کنید.
از پنجره ابزار App Quality Insights می‌توانید مسائل حیاتی Android را مشاهده کنید، آنها را فیلتر کنید، و از Stack Trace به همه کدها بروید. برای شروع، مراحل زیر را دنبال کنید:
با استفاده از نماد نمایه به حساب توسعه دهنده خود در Android Studio وارد شوید در انتهای نوار ابزار
App Quality Insights را با کلیک کردن روی پنجره ابزار در Android Studio یا روی View > Tool Windows > App Quality Insights باز کنید.
روی برگه Android vitals در App Quality Insights کلیک کنید.
اختیاری: برای استفاده از یکپارچه‌سازی کنترل نسخه برای یک ساختنی قابل اشکال‌زدایی، آخرین Firebase Crashlytics SDK (یا Firebase Android Bill of Materials) را به برنامه خود اضافه کنید. سپس کد زیر را به فایل build.gradle.kts یا build.gradle در سطح ماژول اضافه کنید. بیلدهای انتشار (غیر اشکال زدایی) دارای پرچم به طور پیش فرض فعال هستند.
داده های Crashlytics را در Android Studio تجزیه و تحلیل کنید
پنجره ابزار App Quality Insights دارای داده‌های غنی است که به شما اطلاعاتی در مورد رویدادهایی می‌دهد که کاربران با آنها مواجه می‌شوند، و پیوندهایی برای کمک به شما برای پیمایش سریع به منابع آن رویدادها.
از منوی کشویی شناسه برنامه برای انتخاب شناسه برنامه مورد نظر برای تجزیه و تحلیل استفاده کنید. برای مثال، در حالی که ممکن است روی نسخه اشکال زدایی برنامه خود در IDE کار کنید، ممکن است بخواهید داده های رویداد را برای نسخه تولیدی برنامه خود که کاربران نصب می کنند، مشاهده کنید.
پانل Issues رویدادهای برتری را نشان می‌دهد که Crashlytics داده‌هایی برای آنها دارد و بر اساس تأثیرگذارترین خرابی‌های شما مرتب شده است.
رویدادها را بر اساس انواع یا گروه‌هایی از رویدادها مشاهده کنید که دارای ردیابی پشته مشابه هستند. تجزیه و تحلیل رویدادها بر اساس نوع به شما کمک می کند تا دلایل اصلی خرابی را شناسایی کنید.
برگه Stack Trace جزئیات مربوط به آخرین رویدادی را که در پانل Issues کلیک می کنید نشان می دهد. می توانید ردیابی پشته رویداد را ببینید و روی ردیابی پشته کلیک کنید تا به خطوط مربوطه در پایگاه کد خود بروید. اگر کد شما از زمان وقوع خرابی تغییر کرده است، روی show diff در کنار خطای stack trace کلیک کنید تا تفاوت بین کد فعلی شما و نسخه پایگاه کد شما که خرابی را ایجاد کرده است را مشاهده کنید.
همچنین اطلاعاتی درباره نوع دستگاه تحت تأثیر، نسخه Android آن و زمان وقوع رویداد، و همچنین پیوندی به رویداد در داشبورد Firebase Crashlytics وجود دارد. برای مرور اطلاعات برای چندین رویداد در یک گروه، از پیکان های چپ و راست استفاده کنید. برای بستن یک مشکل مستقیماً از پانل روی Close issue کلیک کنید.
برگه‌های کلیدها و گزارش‌ها جفت‌ها و گزارش‌های سفارشی کلید-مقدار را برای هر گزارش Crashlytics نشان می‌دهند.
پانل جزئیات تعداد خرابی ها را بر اساس نوع دستگاه و نسخه اندروید تجزیه می کند، بنابراین می توانید تعیین کنید کدام گروه های کاربری بیشتر تحت تأثیر قرار می گیرند. همچنین نشان می دهد که کدام نسخه برنامه دچار خرابی شده و تعداد کاربرانی که تحت تأثیر قرار گرفته اند.
یادداشت‌ها را بخوانید و به آنها پیوست کنید تا در کنسول Firebase و هم تیمی‌هایتان قابل مشاهده باشند. برای نوشتن یادداشت در مورد یک مشکل، موضوع را انتخاب کنید و پانل یادداشت ها را باز کنید. برای نوشتن یادداشت ها باید مجوز نوشتن برای پروژه Crashlytics داشته باشید. مشکلات مربوط به یادداشت ها با نماد "یادداشت ها" ظاهر می شوند در پانل مسائل
از انواع فیلترها برای تقویت زیر مجموعه های خاصی از رویدادها استفاده کنید. می توانید رویدادهایی را که Fatal هستند انتخاب یا لغو انتخاب کنید ، غیر کشنده و ANR ها و همچنین بر اساس زمان، نسخه برنامه، Crashlytics Signal ، ساخت و مدل دستگاه و نسخه پلتفرم Android فیلتر کنید. توجه داشته باشید که برای حالت‌های Crashlytics Signal، زمانی که یک مشکل در گذشته بسته شده باشد و در نسخه جدید برنامه دوباره رخ داده باشد، مشکل پسرفت شده در نظر گرفته می‌شود.
علاوه بر اینکه می‌توانید از پشته‌ای به کد دیگر پیمایش کنید، می‌توانید از کد به ردیابی پشته نیز بپرید: Android Studio اکنون خطوط کد مربوط به خرابی‌ها را با نماد ناودان خرابی حاشیه‌نویسی می‌کند. بنابراین می توانید به راحتی آنها را شناسایی و اشکال زدایی کنید.
هنگامی که ماوس را روی نماد خرابی نگه می‌دارید، یک پاپ‌آپ ظاهر می‌شود که نشان می‌دهد چند رویداد شامل آن خط کد و فرکانس‌های رویداد است.
برای فهرست دقیق‌تر رویدادها، از جمله تعداد و تعداد کاربرانی که تحت تأثیر یک رویداد خاص قرار گرفته‌اند، روی نماد خرابی کلیک کنید. روی یک رویداد خاص کلیک کنید تا به جزئیات رویداد در پنجره ابزار App Quality Insights بروید.
اعداد مختلف بین Android vitals و Crashlytics
توجه داشته باشید که Android vitals و Crashlytics ممکن است مقادیر متفاوتی را برای تعداد کاربران و رویدادهای مرتبط با یک خرابی گزارش دهند. این تناقضات به این دلیل اتفاق می‌افتد که Play و Crashlytics می‌توانند در زمان‌های مختلف و برای کاربران مختلف دچار خرابی شوند. در اینجا چند دلیل برای اینکه چرا تعداد Play و Crashlytics ممکن است متفاوت باشد آورده شده است:
خرابی‌های Play از زمان راه‌اندازی شروع می‌شود، در حالی که Crashlytics خرابی‌هایی را که پس از راه‌اندازی Crashlytics SDK اتفاق می‌افتد، می‌گیرد.
اگر کاربر هنگام دریافت یک تلفن جدید از گزارش خرابی منصرف شود، این خرابی‌ها به Play گزارش نمی‌شوند. با این حال، Crashlytics بر اساس خط مشی رازداری خود برنامه، خرابی ها را می گیرد.
در حالت آفلاین با عملکرد محدود تحقیق کنید
اگر درخواست جدیدی ارائه می‌کنید، مثلاً با کلیک کردن روی Refresh ، و Android Studio قادر به برقراری ارتباط با Crashlytics نیست، پنجره App Quality Insights به شما امکان می‌دهد وارد حالت آفلاین شوید.
در حالی که در این حالت هستید، می توانید به بررسی مسائل و آخرین رویدادها از داده های حافظه پنهان ادامه دهید. برخی از عملکردها، مانند تغییر برخی گزینه‌های فیلتر یا بستن مشکلات، در دسترس نیستند. برای اتصال مجدد به Crashlytics و بازگشت به حالت آنلاین، روی اتصال مجدد کلیک کنید .
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Analyze issues from Firebase Crashlytics and Android Vitals with App Quality Insights\n\n| **Note:** App Quality Insights is only available in the current stable channel version of Android Studio, the three most recent previous major versions, and patches associated with those versions. If you are using an older version of Android Studio, you will need to update to use App Quality Insights. [More\n| information](/studio/releases#service-compat).\n\nYou can see and act on app crash data from\n[Firebase Crashlytics](https://firebase.google.com/products/crashlytics) and\n[Android Vitals](/topic/performance/vitals)\ndirectly in Android Studio. This integration pulls stack trace data and crash\nstatistics from Crashlytics and Google Play into the **App Quality Insights**\ntool window in the Studio IDE, so you don't have to jump back and forth between\nyour browser and the IDE. Development teams can benefit from key capabilities\nincluding the following:\n\n- See lines in your code highlighted when they have related Crashlytics event data.\n- See the stack trace for top crashes and click on the stack trace to jump to the relevant lines in your code.\n- See summary statistics about top crash and non-fatal events, for example grouped by device manufacturer and Android version.\n- Filter events by attributes including severity, time, and app version.\n- Get a browser link that opens the Crashlytics dashboard page with more details about the event.\n- Get insights that help you more easily understand and resolve root causes of certain issues.\n\nAndroid Vitals reports are available to all apps published to Google Play. If\nyou're not using Crashlytics yet and would like to learn more about its\nofferings, see\n[Firebase Crashlytics](https://firebase.google.com/products/crashlytics).\n\nGet started\n-----------\n\nTo see Crashlytics data in Android Studio, you need to set up Firebase and\nCrashlytics in your app project. Here's how: open the Firebase Assistant in\nAndroid Studio by going to **Tools \\\u003e Firebase** , click **Crashlytics** , and then\nfollow the tutorial to add Firebase and Crashlytics to your project. You can\nread more about the Firebase Assistant workflow in\n[Firebase's getting started guide for Android](https://firebase.google.com/docs/android/setup#assistant).\n\nIf you've already added Firebase and Crashlytics to your app, sign in to your\nDeveloper account in the IDE by clicking on the avatar icon\n.\nAfter you sign in, click the **App Quality Insights** tool window\n. You should\nsee the panels populate with reports from Crashlytics.\n\nAnalyze Android vitals\n----------------------\n\n**App Quality Insights** includes [Android vitals](/topic/performance/vitals)\ndata. This lets you more easily access core metrics collected by Google Play and\nimprove your user experience. Use Android vitals to address issues related to\napp stability to help improve the quality of your app on Google Play.\n\nYou can view Android vitals issues, filter them, and jump from stack trace to\ncode all from the **App Quality Insights** tool window. To get started, follow\nthese steps:\n\n1. Sign in to your developer account in Android Studio using the profile icon at the end of the toolbar.\n2. Open **App Quality Insights** by clicking the tool window in Android Studio or clicking **View \\\u003e Tool Windows \\\u003e App Quality Insights**.\n3. Click the **Android vitals** tab within **App Quality Insights**.\n4. Optional: To use version control integration for a debuggable build, add the\n latest\n [Firebase Crashlytics SDK](https://firebase.google.com/docs/crashlytics/get-started?platform=android#add-sdk)\n (or Firebase Android Bill of Materials) to your app. Then add the following\n code to the module-level `build.gradle.kts` or `build.gradle` file. Release\n (non-debuggable) builds have the flag enabled by default.\n\n | **Note:** App Quality Insights only supports version control using git.\n\n\u003cbr /\u003e\n\n### Kotlin\n\n```kotlin\nandroid {\n buildTypes {\n getByName(\"debug\") {\n vcsInfo {\n include = true\n }\n }\n }\n}\n```\n\n### Groovy\n\n```groovy\nandroid {\n buildTypes {\n debug {\n vcsInfo {\n include true\n }\n }\n }\n}\n```\n\n\u003cbr /\u003e\n\nAnalyze Crashlytics data in Android Studio\n------------------------------------------\n\nThe **App Quality Insights** tool window has rich data that gives you insight\ninto the events your users are encountering, and links to help you quickly\nnavigate to the sources of those events.\n\n1. Use the application ID dropdown menu to select the app ID you want to analyze. For example, while you might work on the debug version of your app in the IDE, you might want to see event data for your production version of your app that your users install.\n2. The **Issues** panel shows the top events that Crashlytics has data for, and is sorted by your most impactful crashes.\n3. View events by *variants*, or groups of events that have similar stack traces. Analyzing events by variant helps you identify the root causes of a crash.\n4. The **Stack trace** tab shows details about the latest\n occurrence of the event you click in the **Issues** panel. You can see the\n event's stack trace and click the stack trace to jump to the relevant lines in\n your codebase. If your code has changed since the crash occurred, click\n **show diff** next to the error in the stack trace to view a diff between\n your current code and the version of your codebase that generated the crash.\n\n There is also information about the device type affected, its Android\n version, and the time the event occurred, as well a link to the event in the\n Firebase Crashlytics dashboard. To browse info for multiple events in a group,\n use the left and right arrows. Click **Close issue** to close an issue\n directly from the panel.\n5. The **Keys** and **Logs** tabs show custom key-value pairs and logs for each Crashlytics report.\n6. The **Details** panel breaks down the crash counts by device type and Android version, so you can determine which user groups are most affected. It also shows which app versions experienced the crash and the number of users affected.\n7. Read and attach notes to issues so that they are visible in the Firebase Console and your teammates. To write a note about an issue, select the issue and open the **Notes** panel. You must have write permission to the Crashlytics project in order to write notes. Issues with notes appear with a \"notes\" icon in the **Issues** panel.\n8. Use the variety of filters to hone in on certain subsets of events. You can select or deselect events that are Fatal , Non-Fatal , and [ANRs](/topic/performance/anrs/keep-your-app-responsive) , as well as filter by time, app version, [Crashlytics Signal](https://firebase.google.com/support/releases#october_8_2021), device make and model, and Android platform version. Note that for the Crashlytics Signal states, an issue is considered *regressed* when it's been closed in the past and has occurred again in a new version of the app.\n\nIn addition to being able to navigate from stack trace to code, you can also\njump from code to stack trace: Android Studio now annotates lines of code that\nare related to crashes with a crash gutter icon\nso you\ncan easily spot and debug them.\n\nWhen you hover over the crash icon, a pop-up appears that shows how many events\ninvolve that line of code, and the event frequencies.\n\nClick on the crash icon for a more detailed list of events, including the\nfrequency of and number of users affected by a given event. Click on a specific\nevent to jump to the event details in the **App Quality Insights** tool window.\n\n### Different numbers between Android vitals and Crashlytics\n\nNote that Android vitals and Crashlytics might report different values for the\nnumbers of users and events associated with the same crash. These discrepancies\nhappen because Play and Crashlytics can catch crashes at different times and for\ndifferent users. Here are a couple reasons for why the Play and Crashlytics\ncounts might differ:\n\n- Play catches crashes starting at boot time, whereas Crashlytics catches crashes that happen after the Crashlytics SDK initializes.\n- If a user opts out of crash reporting when they get a new phone, those crashes aren't reported to Play; however, Crashlytics catches crashes based on an app's own privacy policy.\n\nInvestigate with limited functionality when offline\n---------------------------------------------------\n\nIf you make a new request, for example by clicking **Refresh** , and Android\nStudio is unable to communicate with Crashlytics, the **App Quality Insights**\nwindow lets you to enter **Offline Mode**.\n\nWhile in this mode, you can continue to investigate issues and the latest events\nfrom cached data. Certain functionality, such as changing some filter options or\nclosing issues, isn't available. To retry your connection to Crashlytics\nand return to an online state, click **Reconnect**\n."]]
. پس از ورود به سیستم، روی پنجره ابزار App Quality Insights کلیک کنید
. باید ببینید که پانل ها مملو از گزارش های Crashlytics هستند.
در پانل مسائل 
، غیر کشنده
و ANR ها
و همچنین بر اساس زمان، نسخه برنامه، Crashlytics Signal ، ساخت و مدل دستگاه و نسخه پلتفرم Android فیلتر کنید. توجه داشته باشید که برای حالت‌های Crashlytics Signal، زمانی که یک مشکل در گذشته بسته شده باشد و در نسخه جدید برنامه دوباره رخ داده باشد، مشکل پسرفت شده در نظر گرفته می‌شود.
بنابراین می توانید به راحتی آنها را شناسایی و اشکال زدایی کنید.
.