Firebase Crashlytics הוא כלי קל משקל לדיווח על קריסות בזמן אמת, שמאפשר לכם לנהל בקלות בעיות יציבות באפליקציה. Crashlytics חוסך לכם זמן בפתרון בעיות על ידי קיבוץ חכם של קריסות והדגשת הנסיבות שמובילות אליהן.
במדריך הזה מוסבר איך לשלב את Crashlytics בפרויקט ב-Android Studio כדי שתוכלו לתעד מזהים של תגובות לבקשות של מודעות. בהמשך, כשתפתרו בעיות שקשורות לקריסות באפליקציה, תוכלו לחפש את המזהה של התגובה לבקשת המודעה ולהשתמש במרכז בקרת המודעות ב-AdMob כדי למצוא ולחסום את המודעות.
שלב 1: מוסיפים את Firebase לאפליקציה ל-Android
אם אתם רוצים לנסות להתחבר באמצעות Firebase מאפליקציה נקייה, אתם יכולים להוריד או לשכפל את המאגר של דוגמאות ל-Google Mobile Ads SDK (Legacy) ל-Android ב-GitHub. המדריך הזה מתייחס ספציפית לדוגמה למודעת באנר.
אם כבר יש לכם אפליקציה, אתם אמורים להיות מסוגלים להמשיך לשלבים הבאים עם שם החבילה של האפליקציה. אפשר גם להחיל את אותם שלבים על דוגמאות אחרות במאגר, עם התאמות קלות.
כדי להשתמש ב-Firebase Crashlytics, צריך ליצור פרויקט ב-Firebase ולהוסיף אליו את האפליקציה. אם עדיין לא עשיתם את זה, אתם צריכים ליצור פרויקט ב-Firebase. חשוב לרשום את האפליקציה בפרויקט.
בדף Crashlytics במסוף Firebase, לוחצים על Set up Crashlytics.
במסך שמופיע, לוחצים על No (לא) > Set up a new Firebase app (הגדרת אפליקציית Firebase חדשה).

בקובץ build.gradle, מוסיפים את יחסי התלות של Google Analytics, 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.

(אופציונלי): בדיקת ההגדרה
הוספת כפתור לקריסה מאפשרת לכם לאלץ קריסה של האפליקציה בכל לחיצה על הכפתור.
בדוגמה הבאה אפשר לראות איך מוסיפים כפתור קריסה ב-method onCreate() של Activity:
MainActivity (קטע)
Java
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 Studio, יוצרים את האפליקציה ומריצים אותה באמולטור או במכשיר מחובר. אחרי שהאפליקציה נטענת, אפשר ללחוץ על הכפתור Crash. מפעילים מחדש את האפליקציה מהמכשיר או מ-Android Studio כדי להעלות את יומן הקריסות ל-Crashlytics.
שלב 2: מתעדים את המזהה של התגובה לבקשת המודעה
אם אתם טוענים כמה מודעות ומציגים אותן בזמנים שונים, מומלץ לתעד כל מזהה של תגובה לבקשת מודעה באמצעות מפתח נפרד. לדוגמה, במדריך הזה יש דוגמה עם מודעת באנר אחת בלבד. לכן, אנחנו מתעדים את המזהה של התגובה לבקשת המודעה כמפתח banner_ad_response_id בקטע הקוד הבא. למעשה, אתם יכולים ליצור כמה צמדים מותאמים אישית של מפתח/ערך ב-Firebase Crashlytics לסוגים שונים של מודעות ואירועים של מודעות (ראו AdListener לגבי מחזור החיים של המודעה). במאמר התאמה אישית של דוחות הקריסה ב-Firebase Crashlytics מוסבר איך להתאים אישית את הרישום ביומן.
מוסיפים את הקוד הבא אל MyActivity.java. בעצם, היא משתמשת בפונקציה FirebaseCrashlytics.setCustomKey() בפונקציית הקריאה החוזרת (callback) של onAdLoaded() כדי לוודא שהמודעה נטענה לפני שהיא מנסה להפעיל את getResponseInfo().
Java
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. שימו לב שיכול להיות שיעבור קצת זמן – מקסימום שעה – עד שהמפתחות יופיעו במרכז הבקרה.
