استخدم 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 ) ، أضف القواعد لتضمين المكوّن الإضافي لخدمات Google Gradle. تأكد من أن لديك مستودع Google Maven أيضًا.

      Kotlin

      plugins {
   id("com.android.application") version "7.2.0" apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id("com.google.gms.google-services") version "4.3.15" apply false
}

      Groovy

      plugins {
   id 'com.android.application' version '7.2.0' apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id 'com.google.gms.google-services' version '4.3.15' apply false
}

    2. في ملف Gradle (على مستوى التطبيق) الوحدة النمطية الخاصة بك (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle ) ، قم بتطبيق المكون الإضافي لخدمات Google Gradle.

      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 Android مكتبة. نوصي باستخدام Firebase Android BoM للتحكم في إصدارات المكتبة.

    Kotlin+KTX

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

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

    باستخدام 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-ktx:21.3.0'
}

    Java

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

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

  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

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