Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

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

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

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

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

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

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

שלב 1 : הגדר Crashlytics במסוף Firebase

  1. לחץ על Crashlytics בחלונית הניווט הימנית של קונסולת Firebase .

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

  3. לחץ על אפשר התרסקויות .

שלב 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.8'
    
            // Add the Crashlytics Gradle plugin (be sure to add version
            // 2.0.0 or later if you built your app with Android Studio 4.1).
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.7.0'
        }
    }
    
    allprojects {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    }
       
  2. בקובץ build.gradle ברמת 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 : הוסף את ה- SDK של Firebase Crashlytics לאפליקציה שלך

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

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

    ג'אווה

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
        // 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 Android BoM , האפליקציה שלך תשתמש תמיד בגרסאות תואמות של ספריות Android ל- 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.0.1'
        implementation 'com.google.firebase:firebase-analytics:19.0.0'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:28.1.0')
    
        // 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 Android BoM , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- 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.0.1'
        implementation 'com.google.firebase:firebase-analytics-ktx:19.0.0'
    }
    

  2. אופציונלי : Firebase Crashlytics מציע דיווח על קריסות עבור אפליקציות שנבנו באמצעות ערכת הפיתוח של Native Android (NDK). אם האפליקציה שלך משתמשת ב- NDK, באפשרותך להגדיר את Crashlytics לדיווח על קריסות המתרחשות בספריות ה- NDK הבסיסיות של האפליקציה שלך. בקר בתיעוד של דיווח קריסות על NDK כדי ללמוד כיצד.

שלב 4 : הפעל את הפרויקט שלך

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

שלב 5 : כפה על קריסת בדיקה כדי לסיים את ההתקנה

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

לפרטים אודות אופן פעולה זה, בקרו בבדיקת היישום שלכם .

הצעדים הבאים