איך מתחילים להשתמש ב-Crashlytics ל-Android

במדריך הזה מוסבר איך להתחיל להשתמש ב-Firebase Crashlytics באפליקציית Android.

אחרי שמגדירים את Firebase Crashlytics SDK באפליקציה, אפשר לקבל דוחות מקיפים על קריסות במסוף Firebase. עם Crashlytics ל-Android, מקבלים דוחות על קריסות, שגיאות לא קריטיות ושגיאות מסוג 'האפליקציה לא מגיבה' (ANR).

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Firebase Crashlytics for my app.

לפני שמתחילים

ההגדרה של Crashlytics דורשת ביצוע משימות במסוף Firebase ובסביבת הפיתוח המשולבת (IDE) (למשל, הוספה של קובץ הגדרות Firebase ושל Crashlytics SDK). כדי לסיים את ההגדרה, צריך לגרום לקריסת בדיקה כדי לשלוח את דוח הקריסה הראשון ל-Firebase.

1. אם עדיין לא עשיתם זאת, אתם צריכים להוסיף את Firebase לפרויקט Android שלכם. אם אין לכם אפליקציית Android, אתם יכולים להוריד אפליקציה לדוגמה.

2. מומלץ: כדי לקבל באופן אוטומטי יומני נתיב ולהבין את פעולות המשתמש שהובילו לקריסה, לאירוע לא קטלני או לאירוע ANR, צריך להפעיל את Google Analytics בפרויקט Firebase.

   • אם אתם יוצרים פרויקט חדש ב-Firebase, זכרו להפעיל את Google Analytics לפני שתסיימו ליצור את הפרויקט.

   • אם אתם משתמשים בפרויקט קיים ב-Firebase שלא הפעלתם בו את Google Analytics, אתם יכולים להפעיל אותו בדף settings Settings (הגדרות) > Integrations (שילובים) במסוף Firebase.

3. מוודאים שבאפליקציה מותקנות הגרסאות המינימליות הנדרשות הבאות:

   • ‫Gradle 8.0
   • Android Gradle plugin 8.1.0
   • פלאגין Google services Gradle‏ 4.4.1

שלב 1: מוסיפים את Crashlytics SDK לאפליקציה

כדי ליהנות מיומני נתיבי מיקום, צריך להוסיף לאפליקציה גם את Firebase SDK for Google Analytics. חשוב לוודא שGoogle Analytics מופעל בפרויקט Firebase.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.19.0"))

    // Add the dependencies for the Crashlytics and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics")
    implementation("com.google.firebase:firebase-analytics")
}

באמצעות Firebase Android BoM, האפליקציה תמיד תשתמש בגרסאות תואמות של ספריות Firebase ל-Android.

dependencies {
    // Add the dependencies for the Crashlytics and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics:20.1.1")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

שלב 2: מוסיפים את הפלאגין Crashlytics Gradle לאפליקציה

1. בקובץ Gradle ברמת הבסיס (ברמת הפרויקט) (<project>/build.gradle.kts או <project>/build.gradle), מוסיפים את הפלאגין Crashlytics Gradle לבלוק plugins:

   Kotlin

   plugins {
       // Make sure that you have the AGP plugin 8.1+ dependency
       id("com.android.application") version "8.1.4" apply false
       // ...
   
       // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
       id("com.google.gms.google-services") version "4.5.0" apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id("com.google.firebase.crashlytics") version "3.0.8" apply false
   }

   Groovy

   plugins {
       // Make sure that you have the AGP plugin 8.1+ dependency
       id 'com.android.application' version '8.1.4' apply false
       // ...
   
       // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
       id 'com.google.gms.google-services' version '4.5.0' apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics' version '3.0.8' apply false
   }

2. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מוסיפים את הפלאגין Crashlytics Gradle:

   Kotlin

   plugins {
     id("com.android.application")
     // ...
   
     // Make sure that you have the Google services Gradle plugin
     id("com.google.gms.google-services")
   
     // Add the Crashlytics Gradle plugin
     id("com.google.firebase.crashlytics")
   }

   Groovy

   plugins {
     id 'com.android.application'
     // ...
   
     // Make sure that you have the Google services Gradle plugin
     id 'com.google.gms.google-services'
   
     // Add the Crashlytics Gradle plugin
     id 'com.google.firebase.crashlytics'
   }

שלב 3: הפעלת קריסה לצורך בדיקה כדי לסיים את ההגדרה

כדי לסיים את ההגדרה של Crashlytics ולראות נתונים ראשוניים בלוח הבקרה של Crashlytics במסוף Firebase, צריך להפעיל קריסה של בדיקה.

1. מוסיפים לאפליקציה קוד שאפשר להשתמש בו כדי לגרום לקריסה של הבדיקה.

   אפשר להשתמש בקוד הבא ב-MainActivity של האפליקציה כדי להוסיף לאפליקציה כפתור שגורם לקריסה כשלוחצים עליו. הכפתור מסומן בתווית Test Crash (בדיקת קריסה).

   Kotlin

   val crashButton = Button(this)
   crashButton.text = "Test Crash"
   crashButton.setOnClickListener {
      throw RuntimeException("Test Crash") // Force a crash
   }
   
   addContentView(crashButton, ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT))

   Java

   Button crashButton = new Button(this);
   crashButton.setText("Test 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));

2. יוצרים ומריצים את האפליקציה.

3. כדי לשלוח את דוח הקריסה הראשון של האפליקציה, צריך לגרום לקריסה בכוח:

   1. פותחים את האפליקציה במכשיר הבדיקה או באמולטור.

   2. באפליקציה, לוחצים על הלחצן Test Crash (בדיקת קריסה) שהוספתם באמצעות הקוד שלמעלה.

   3. אחרי שהאפליקציה קורסת, צריך להפעיל אותה מחדש כדי שהיא תוכל לשלוח את דוח הקריסה ל-Firebase.

4. במסוף Firebase, עוברים אל DevOps & Engagement > Crashlytics dashboard כדי לבדוק אם דוח קריסת הבדיקה מופיע.

   אם רעננתם את המסוף ואחרי חמש דקות עדיין לא רואים את קריסת הבדיקה, צריך להפעיל את יומן ניפוי הבאגים כדי לבדוק אם האפליקציה שולחת דוחות קריסה.

זה הכול! מעכשיו, Crashlytics ינטר את האפליקציה שלכם כדי לזהות קריסות, שגיאות לא קריטיות ומקרי ANR. כדי לראות את כל הדוחות והנתונים הסטטיסטיים ולבדוק אותם, אפשר להיכנס אל לוח הבקרה של Crashlytics.

השלבים הבאים

• התאמה אישית של הגדרת דוח הקריסות על ידי הוספה של דיווח בהסכמה, יומנים, מפתחות ומעקב אחרי שגיאות לא קריטיות.

• משלבים עם Google Play כדי שתוכלו לסנן את דוחות קריסת האפליקציה ל-Android לפי Google Play ולעקוב אחרי הדוחות ישירות בלוח הבקרה של Crashlytics. כך תוכלו להתמקד ב-builds ספציפיים בלוח הבקרה.

• ב-Android Studio, צופים בנתוני Crashlytics ומסננים אותם.

  • אפשר להשתמש בחלון App Quality Insights (AQI) ב-Android Studio כדי להציג Crashlytics נתונים לצד הקוד – לא צריך לעבור הלוך ושוב בין Crashlytics לוח הבקרה לבין ה-IDE כדי להתחיל בניפוי באגים של בעיות מרכזיות.
  • אפשר לקרוא איך משתמשים בחלון AQI במאמרי העזרה של Android Studio.
  • נשמח לשמוע ממך. נשמח לקבל משוב על חלון איכות האוויר על ידי שליחת דוח על באג.

• ייצוא הנתונים אל BigQuery או אל Cloud Logging לניתוח מתקדם ולתכונות מתקדמות, כמו יצירת שאילתות על הנתונים, בניית מרכזי בקרה בהתאמה אישית והגדרת התראות מותאמות אישית.