התחל בעבודה עם Creblytics של Firebase

iOS + Android אחדות

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

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

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

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

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

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

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

שלב 1: הפעל Crashlytics במסוף Firebase

1. עבור אל לוח המחוונים Crashlytics במסוף Firebase.

2. ודאו שהאפליקציה שלכם נבחרת מתוך התפריט הנפתח לצד Crashlytics בראש הדף.

3. לחץ אפשר Crashlytics.

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

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

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

    // 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'
}

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

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

    // 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'
}

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

שלב 3: הוספת תוסף 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'
   

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

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

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

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

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

   קוטלין+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. באפליקציה שלך, לחץ על כפתור "Test Crash" שהוספת באמצעות הקוד למעלה.

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

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

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

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

הצעדים הבאים

• התאמה אישית של התקנת דו"ח ההתרסקות שלך על ידי הוספת opt-in דיווח, יומנים, מפתחות, והמעקב של טעויות הלא-קטלניות.