استخدم 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 ).

      • يمكنك تنزيل ملف تكوين Firebase Android مرة أخرى في أي وقت.
      • تأكد من عدم إلحاق ملف التكوين بأحرف إضافية، مثل (2) .

    3. انقل ملف التكوين الخاص بك إلى دليل الوحدة النمطية (على مستوى التطبيق) لتطبيقك.

  2. لتمكين منتجات Firebase في تطبيقك، قم بإضافة المكون الإضافي لخدمات Google إلى ملفات Gradle الخاصة بك.

    1. في ملف Gradle على مستوى الجذر (على مستوى المشروع) ( <project>/build.gradle.kts أو <project>/build.gradle )، أضف قواعد لتضمين المكون الإضافي Gradle لخدمات Google. تأكد من أن لديك مستودع 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: أضف Analytics SDK إلى تطبيقك

  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'
}
    هل تبحث عن وحدة مكتبة خاصة بـ Kotlin؟ بدءًا من أكتوبر 2023 (Firebase BoM 32.5.0) ، يمكن لمطوري Kotlin وJava الاعتماد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة ).

  2. قم بتعريف كائن com.google.firebase.analytics.FirebaseAnalytics أعلى نشاطك:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. قم بتهيئته في طريقة onCreate() :

    Kotlin+KTX

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

    Java

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

الخطوات التالية