דף זה תורגם על ידי Cloud Translation API.

התחל עם Firebase Crashlytics

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

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

לפני שאתה מתחיל

אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך. אם אין לך אפליקציית אנדרואיד, תוכל להוריד אפליקציה לדוגמה .
מומלץ : כדי לקבל אוטומטית יומני פירורי לחם כדי להבין את פעולות המשתמש המובילות לקריסה, לא קטלנית או אירוע ANR, עליך להפעיל את Google Analytics בפרויקט Firebase שלך.
- אם בפרויקט Firebase הקיים שלך לא מופעל Google Analytics, תוכל להפעיל את Google Analytics מהכרטיסייה אינטגרציות של > הגדרות פרויקט במסוף Firebase.
- אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך תהליך העבודה של יצירת הפרויקט.

שלב 1 : הוסף את ה-SDK של Crashlytics לאפליקציה שלך

בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle ), הוסף את התלות של ספריית Crashlytics עבור אנדרואיד. אנו ממליצים להשתמש ב- Firebase Android BoM כדי לשלוט בגירסאות של הספרייה.

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

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.8.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.

(אלטרנטיבי) הוסף תלות בספריית Firebase מבלי להשתמש ב-BoM

אם תבחר שלא להשתמש ב-Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.

שים לב שאם אתה משתמש במספר ספריות Firebase באפליקציה שלך, אנו ממליצים בחום להשתמש ב-BoM לניהול גרסאות ספרייה, מה שמבטיח שכל הגרסאות תואמות.

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:18.6.3")
    implementation("com.google.firebase:firebase-analytics:21.6.1")
}

מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

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

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

Kotlin

האם אתה עדיין משתמש בתחביר buildscript ? למד כיצד להוסיף פלאגין של Firebase באמצעות התחביר הזה.

plugins {
    id("com.android.application") version "7.3.0" apply false
    // ...

    // Make sure that you have the Google services Gradle plugin dependency
    id("com.google.gms.google-services") version "4.4.1" apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id("com.google.firebase.crashlytics") version "2.9.9" apply false
}

Groovy

האם אתה עדיין משתמש בתחביר buildscript ? למד כיצד להוסיף פלאגין של Firebase באמצעות התחביר הזה.

plugins {
    id 'com.android.application' version '7.3.0' apply false
    // ...

    // Make sure that you have the Google services Gradle plugin dependency
    id 'com.google.gms.google-services' version '4.4.1' apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id 'com.google.firebase.crashlytics' version '2.9.9' apply false
}

בקובץ 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, עליך לאלץ קריסת מבחן.

הוסף קוד לאפליקציה שלך שבו תוכל להשתמש כדי לאלץ קריסת מבחן.

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

Kotlin+KTX

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));

בנה והפעל את האפליקציה שלך.
כפה את קריסת הבדיקה כדי לשלוח את דוח הקריסה הראשון של האפליקציה שלך:
1. פתח את האפליקציה שלך ממכשיר הבדיקה או האמולטור שלך.
2. באפליקציה שלך, לחץ על כפתור "Test Crash" שהוספת באמצעות הקוד שלמעלה.
3. לאחר שהאפליקציה שלך קורסת, הפעל אותה מחדש כדי שהאפליקציה תוכל לשלוח את דוח הקריסה ל-Firebase.
עבור אל לוח המחוונים של Crashlytics של מסוף Firebase כדי לראות את קריסת המבחן שלך.
אם רענן את המסוף ואתה עדיין לא רואה את קריסת הבדיקה לאחר חמש דקות, הפעל רישום באגים כדי לראות אם האפליקציה שלך שולחת דוחות קריסה.

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

הצעדים הבאים

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

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

ב-Android Studio, הצג וסנן נתוני Crashlytics.
- השתמש בחלון App Quality Insights (AQI) ב-Android Studio כדי לצפות בנתוני Crashlytics לצד הקוד שלך - אין צורך לקפוץ הלוך ושוב בין לוח המחוונים של Crashlytics ל-IDE כדי להתחיל באגים מובילים.
- קבל גישה לחלון AQI במהדורת Electric Eel של Android Studio (יציב) או נסה תכונות AQI חדשות ב-Flamingo (בטא). הורד את גרסת Android Studio הרצויה לך.
- למד כיצד להשתמש בחלון AQI בתיעוד של Android Studio.
- נשמח לשמוע ממך! שלח לנו משוב על חלון AQI על ידי הגשת דוח באג .

לפני שאתה מתחיל

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

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

שלב 1 : הוסף את ה- Crashlytics SDK לאפליקציה שלך

בקובץ המודול שלך (רמת אפליקציה) קובץ gradle (בדרך כלל <project>/<app-module>/build.gradle.kts > <project>/<app-module>/build.gradle לאנדרואיד. אנו ממליצים להשתמש ב- Firebase Android BOM כדי לשלוט על גרסת הספריה.

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

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.8.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.

(אלטרנטיבה) הוסף תלות בספריית Firebase מבלי להשתמש ב- BOM

אם תבחר לא להשתמש ב- FireBase BOM, עליך לציין כל גרסת ספריית Firebase בקו התלות שלה.

שים לב שאם אתה משתמש בספריות Firebase מרובות באפליקציה שלך, אנו ממליצים בחום להשתמש ב- BOM לניהול גרסאות הספריה, מה שמבטיח שכל הגרסאות תואמות.

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:18.6.3")
    implementation("com.google.firebase:firebase-analytics:21.6.1")
}

מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BOM 32.5.0) , מפתחי קוטלין וגם Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

שלב 2 : הוסף את התוסף Rashlytics Gradle לאפליקציה שלך

בקובץ ה- Gradle ברמת השורש (ברמת פרויקט) ( <project>/build.gradle.kts או <project>/build.gradle ), הוסף את התוסף Gradle של Crashlytics לחסימת plugins :

Kotlin

האם אתה עדיין משתמש בתחביר buildscript ? למד כיצד להוסיף תוספי FireBase באמצעות תחביר זה.

plugins {
    id("com.android.application") version "7.3.0" apply false
    // ...

    // Make sure that you have the Google services Gradle plugin dependency
    id("com.google.gms.google-services") version "4.4.1" apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id("com.google.firebase.crashlytics") version "2.9.9" apply false
}

Groovy

האם אתה עדיין משתמש בתחביר buildscript ? למד כיצד להוסיף תוספי FireBase באמצעות תחביר זה.

plugins {
    id 'com.android.application' version '7.3.0' apply false
    // ...

    // Make sure that you have the Google services Gradle plugin dependency
    id 'com.google.gms.google-services' version '4.4.1' apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id 'com.google.firebase.crashlytics' version '2.9.9' apply false
}

בקובץ ה- gradle של המודול שלך (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts <project>/<app-module>/build.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, עליך לכפות תאונת בדיקה.

הוסף קוד לאפליקציה שלך שתוכל להשתמש בו כדי לכפות את תאונת הבדיקה.

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

Kotlin+KTX

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));

בנה והריץ את האפליקציה שלך.
כפה את התרסקות הבדיקה על מנת לשלוח את דוח ההתרסקות הראשון של האפליקציה שלך:
1. פתח את האפליקציה שלך ממכשיר הבדיקה או האמולטור שלך.
2. באפליקציה שלך, לחץ על כפתור "התרסקות הבדיקה" שהוספת באמצעות הקוד שלמעלה.
3. לאחר שהאפליקציה שלך קורסת, הפעל אותה מחדש כך שהאפליקציה שלך תוכל לשלוח את דוח ההתרסקות ל- Firebase.
עבור אל לוח המחוונים Crashlytics של קונסולת Firebase כדי לראות את התרסקות הבדיקה שלך.
אם רעננת את הקונסולה ואתה עדיין לא רואה את התרסקות הבדיקה לאחר חמש דקות, אפשר רישום באגים כדי לבדוק אם האפליקציה שלך שולחת דוחות קריסה.

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

הצעדים הבאים

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

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

באולפן אנדרואיד, צפה ומסנן נתוני Crashlytics.
- השתמש בחלון התובנות האיכותיות של אפליקציה (AQI) באולפן אנדרואיד כדי להציג נתוני Crashlytics לצד הקוד שלך - אין צורך לקפוץ קדימה ואחורה בין לוח המחוונים Crashlytics ל- IDE כדי להתחיל לבצע ניפוי באגים.
- קבל גישה לחלון AQI בשחרור צלופח חשמלי של אנדרואיד סטודיו (יציב) או נסה תכונות AQI חדשות בפלמינגו (בטא). הורד את גרסת הסטודיו הרצויה שלך לאנדרואיד.
- למד כיצד להשתמש בחלון AQI בתיעוד Studio Android.
- נשמח לשמוע ממך! שלח לנו משוב על חלון AQI על ידי הגשת דוח באגים .