השתמש ב-Google Analytics כדי לקבל מדדים עבור דוחות קריסה

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

מדריך זה מתאר כיצד להוסיף Analytics לאפליקציה שמוגדרת בה Crashlytics (אם עדיין לא עשית זאת, הוסף את Crashlytics לאפליקציה שלך ).

שלב 1: הוסף קובץ תצורה של Firebase

  1. הוסף את קובץ התצורה של Firebase Android לאפליקציה שלך:

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

    2. לחץ על הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android שלך ( google-services.json ).

    3. העבר את קובץ התצורה שלך לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.

  2. כדי להפעיל מוצרי Firebase באפליקציה שלך, הוסף את הפלאגין google-services לקבצי Gradle שלך.

    1. בקובץ Gradle ברמת השורש (ברמת הפרויקט) ( <project>/build.gradle.kts או <project>/build.gradle ), הוסף כללים כדי לכלול את הפלאגין Gradle שירותי Google. בדוק שיש לך גם את מאגר Maven של גוגל.

      Kotlin

      plugins {
         id("com.android.application") version "7.3.0" apply false
         // ...
      
         // Add the dependency for the Google services Gradle plugin
         id("com.google.gms.google-services") version "4.4.0" apply false
      }
      

      Groovy

      plugins {
         id 'com.android.application' version '7.3.0' apply false
         // ...
      
         // Add the dependency for the Google services Gradle plugin
         id 'com.google.gms.google-services' version '4.4.0' apply false
      }
      
    2. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle ), החל את הפלאגין Gradle של שירותי Google.

      Kotlin

      plugins {
         id("com.android.application")
      
         // Add the Google services Gradle plugin
         id("com.google.gms.google-services")
         // ...
      }
      

      Groovy

      plugins {
         id 'com.android.application'
      
         // Add the Google services Gradle plugin
         id 'com.google.gms.google-services'
         // ...
      }
      

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

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

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:32.6.0"))
    
        // Add the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics'
    }
    

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

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

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

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

    dependencies {
        // Add the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics:21.5.0'
    }
    
    מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).

  2. הכריז על האובייקט com.google.firebase.analytics.FirebaseAnalytics בראש הפעילות שלך:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. אתחל אותו בשיטת onCreate() :

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

    Java

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

הצעדים הבאים