Check out what’s new from Firebase at Google I/O 2022. Learn more

התחל עם Firebase Crashlytics

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

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

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

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

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

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

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

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

באמצעות BOM Firebase אנדרואיד , להכריז על התלות של הספרייה אנדרואיד Crashlytics במודול שלך (ברמת האפליקציה) קובץ Gradle (בדרך כלל app/build.gradle ).

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

Java

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

    // Declare 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 אנדרואיד BOM , האפליקציה שלך תמיד ישתמשו גירסאות תואמות של ספריות אנדרואיד Firebase.

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

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

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

dependencies {
    // Declare 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.2.10'
    implementation 'com.google.firebase:firebase-analytics:21.0.0'
}

Kotlin+KTX

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

    // Declare 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-ktx'
    implementation 'com.google.firebase:firebase-analytics-ktx'
}

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

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

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

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

dependencies {
    // Declare 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-ktx:18.2.10'
    implementation 'com.google.firebase:firebase-analytics-ktx:21.0.0'
}

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

  1. בפרויקט ברמה שלך build.gradle הקובץ, להוסיף את תוסף Crashlytics Gradle כתלות buildscript.

    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    
        dependencies {
            // ...
    
            // Check that you have the Google services Gradle plugin v4.3.2 or later
            // (if not, add it).
            classpath 'com.google.gms:google-services:4.3.10'
    
            // Add the Crashlytics Gradle plugin
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.8.1'
        }
    }
    
    allprojects {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    }
  2. ב app ברמה שלך build.gradle קובץ, להחיל את תוסף Crashlytics Gradle:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services' // Google services Gradle plugin
    
    // Apply the Crashlytics Gradle plugin
    apply plugin: 'com.google.firebase.crashlytics'
    

שלב 3 : חיל התרסקות מבחן כדי לסיים את ההגדרה

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

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

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

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

    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))
    
  2. לבנות ולהפעיל את האפליקציה שלך.

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

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

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

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

  4. עבור אל לוח המחוונים Crashlytics של קונסולת Firebase לראות התרסקות הבדיקה שלך.

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


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

הצעדים הבאים

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