Firebase Crashlytics هي أداة خفيفة لإعداد تقارير الأعطال في الوقت الفعلي تسهّل عليك إدارة مشاكل الثبات في تطبيقك. توفّر لك أداة Crashlytics الوقت المستغرَق في تحديد المشاكل وحلّها من خلال تجميع الأعطال بذكاء وتسليط الضوء على الظروف التي تؤدي إليها.
يوضّح هذا الدليل كيفية دمج Crashlytics في مشروعك على "استوديو Android" لتتمكّن من تسجيل أرقام تعريف الاستجابة للإعلانات. لاحقًا، عند تحديد مشاكل تعطُّل تطبيقك وحلّها، يمكنك البحث عن رقم تعريف استجابة الإعلان واستخدام "مركز مراجعة الإعلانات" في AdMob للعثور على الإعلانات وحظرها.
الخطوة 1: إضافة Firebase إلى تطبيق Android
إذا أردت تجربة التسجيل باستخدام Firebase من تطبيق جديد، يمكنك تنزيل أو استنساخ أمثلة Google Mobile Ads SDK (Legacy) لنظام التشغيل Android مستودع على GitHub. يستخدم هذا الدليل تحديدًا مثال إعلان البانر.
إذا كان لديك تطبيق حاليًا، من المفترض أن تتمكّن من الانتقال إلى الخطوات الأخرى باستخدام اسم حزمة تطبيقك. يمكن أيضًا تطبيق الخطوات نفسها على أمثلة أخرى في المستودع مع إجراء تعديلات طفيفة.
لاستخدام Firebase Crashlytics، عليك إنشاء مشروع على Firebase وإضافة تطبيقك إليه. أنشئ مشروع Firebase، إذا لم يسبق لك ذلك. تأكَّد من تسجيل تطبيقك فيه.
في صفحة Crashlytics ضمن وحدة تحكُّم Firebase، انقر على إعداد Crashlytics.
في الشاشة التي تظهر، انقر على لا > إعداد تطبيق Firebase جديد.

في ملف build.gradle، أضِف التبعيات لخدمة "إحصاءات Google" وFabric وCrashlytics.
app/build.gradle
apply plugin: 'com.android.application' apply plugin: 'com.google.gms.google-services' // Add the Fabric plugin apply plugin: 'io.fabric' dependencies { // ... // Add Google Mobile Ads SDK (Legacy) implementation 'com.google.android.gms:play-services-ads:25.5.0' // Add the Firebase Crashlytics dependency. implementation 'com.google.firebase:firebase-crashlytics:21.0.1' }
project/build.gradle
buildscript { repositories { // ... // Add Google's Maven repository. google() } dependencies { // ... classpath 'com.google.gms:google-services:4.5.0' // Add the Fabric Crashlytics plugin. classpath 'com.google.firebase:firebase-crashlytics-gradle:3.0.8' } } allprojects { // ... repositories { // Check that Google's Maven repository is included (if not, add it). google() // ... } }أنشئ تطبيقك وشغِّله للتأكّد من ضبط Crashlytics بشكل صحيح. بعد إكمال هذه الخطوة بنجاح، ستتمكّن من الوصول إلى لوحة بيانات Crashlytics.

(اختياري): اختبار الإعداد
من خلال إضافة زر تعطُّل، يمكنك فرض تعطُّل التطبيق في كل مرة يتم فيها الضغط على الزر.
في ما يلي مثال يوضّح كيفية إضافة زر تعطُّل في طريقة onCreate() في
Activity:
MainActivity (مقتطف)
جافا
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my); // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in // values/strings.xml. adView = findViewById(R.id.ad_view); // Start loading the ad in the background. adView.loadAd(new AdRequest.Builder().build()); // Add a crash button. Button crashButton = new Button(this); crashButton.setText("Crash!"); crashButton.setOnClickListener(new View.OnClickListener() { public void onClick(View view) { throw new RuntimeException("Test Crash"); // Force a crash } }); addContentView(crashButton, new ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)); }
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_my) // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in // values/strings.xml. adView = findViewById(R.id.ad_view) // Start loading the ad in the background. adView.loadAd(AdRequest.Builder().build()) // Add a crash button. val crashButton = Button(this) crashButton.text = "Crash!" crashButton.setOnClickListener { throw RuntimeException("Test Crash") // Force a crash } addContentView(crashButton, ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)) }
في استوديو Android، أنشئ تطبيقك وشغِّله على محاكي أو جهاز متصل. بعد تحميل التطبيق، يمكنك النقر على الزر تعطُّل. أعِد تشغيل التطبيق من الجهاز أو من استوديو Android لتحميل سجلّ الأعطال إلى Crashlyics.
الخطوة 2: تسجيل رقم تعريف استجابة الإعلان
إذا حمّلت إعلانات متعددة وعرضتها في أوقات مختلفة، من الأفضل تسجيل رقم تعريف كل استجابة إعلان باستخدام مفتاح منفصل. على سبيل المثال، يستخدم هذا الدليل
مثالاً يحتوي على إعلان بانر واحد فقط. لذلك، نسجّل رقم تعريف استجابة الإعلان كمفتاح
banner_ad_response_id في المقتطف التالي. يمكنك إنشاء أزواج متعددة من المفاتيح والقيم المخصّصة في Firebase Crashlytics لأنواع الإعلانات وأحداث الإعلانات المختلفة (راجِع AdListener للاطّلاع على مراحل نشاط الإعلان). لمزيد من المعلومات حول التسجيل المخصّص، يُرجى الانتقال إلى مقالة تخصيص تقارير الأعطال في Firebase Crashlytics.
أضِف الرمز التالي إلى MyActivity.java. تستخدم هذه الطريقة بشكل أساسي الدالة
FirebaseCrashlytics.setCustomKey()
في دالة رد الاتصال onAdLoaded() لضمان تحميل الإعلان قبل محاولة استدعاء getResponseInfo().
جافا
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_my); // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in // values/strings.xml. adView = findViewById(R.id.ad_view); adView.setAdListener(new AdListener() { @Override public void onAdLoaded() { String adResponseId = adView.getResponseInfo().getResponseId(); FirebaseCrashlytics.getInstance().setCustomKey( "banner_ad_response_id", adResponseId); } }); // Start loading the ad in the background. adView.loadAd(new AdRequest.Builder().build()); // Add a crash button. Button crashButton = new Button(this); crashButton.setText("Crash!"); crashButton.setOnClickListener(new View.OnClickListener() { public void onClick(View view) { throw new RuntimeException("Test Crash"); // Force a crash } }); addContentView(crashButton, new ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)); }
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_my) // Gets the ad view defined in layout/ad_fragment.xml with ad unit ID set in // values/strings.xml. adView = findViewById(R.id.ad_view) adView.adListener = object : AdListener() { override fun onAdLoaded() { mAdView.responseInfo?.responseId?.let { adResponseId -> FirebaseCrashlytics.getInstance().setCustomKey( "banner_ad_response_id", adResponseId) } } } // Start loading the ad in the background. adView.loadAd(AdRequest.Builder().build()) // Add a crash button. val crashButton = Button(this) crashButton.text = "Crash!" crashButton.setOnClickListener { throw RuntimeException("Test Crash") // Force a crash } addContentView(crashButton, ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT)) }
تهانينا! سيظهر لك الآن أحدث banner_ad_response_id
في القسم الرئيسي من جلسات التعطُّل على لوحة بيانات Crashlytics. يُرجى العِلم أنّ
بعض المفاتيح قد تستغرق مدة تصل إلى ساعة لتظهر في لوحة البيانات.
