الحصول على تقارير أعطال قابلة للقراءة في لوحة بيانات Crashlytics (نظام التشغيل Android)

اختيار المنصة:

+iOS Android الويب Flutter Unity

يمكن للمكوّن الإضافي Gradle في Crashlytics رصد حالات تشويش الرمز البرمجي تلقائيًا. عندما تنشئ عملية الإنشاء ملف تعيين، يحمّله المكوّن الإضافي لتتمكّن خوادم Crashlytics من استخدام الملف لعرض تتبُّع تسلسل استدعاء الدوال البرمجية في تطبيقك كرمز غير مخفي ويمكن لشخص عادي قراءته.

الإعدادات المطلوبة عند استخدام R8 وProGuard وDexGuard

يمكن لـ "Crashlytics" إزالة التشويش باستخدام أي ملف ربط متوافق مع ProGuard، وقد تم اختباره أيضًا مع ProGuard وR8 وDexGuard.

إذا كان تطبيقك يستخدم أداة R8 مع تفعيل ميزة التعتيم مع الإصدار 4.2.0 من Android Gradle أو إصدار أحدث، سيُنشئ "Crashlytics" تقارير أعطال يمكن قراءتها. يُرجى العِلم أنّ Crashlytics حسّنت مؤخرًا دعمها للتطبيقات التي تستخدم كلاً من Kotlin وR8، ما قد يؤدي إلى بعض المشاكل غير المتوقعة في تصنيف المشاكل.

إذا كان تطبيقك يستخدم ملف إعداد ProGuard، عليك الاحتفاظ بالمعلومات التي يتطلّبها Crashlytics لإنشاء تقارير أعطال قابلة للقراءة. يمكنك إجراء ذلك من خلال إضافة الأسطر التالية إلى ملف إعداد ProGuard أو DexGuard:

-keepattributes SourceFile,LineNumberTable        # Keep file names and line numbers.
-keep public class * extends java.lang.Exception  # Optional: Keep custom exceptions.

للحصول على مساعدة بشأن الأسئلة أو المشاكل المتعلّقة بـ DexGuard، يُرجى التواصل مع فريق دعم Guardsquare مباشرةً. للحصول على مساعدة بشأن ProGuard، يُرجى الانتقال إلى منتديات منتدى Guardsquare للحصول على مساعدة من أحد الخبراء.

الاحتفاظ بتنويعات التصميم المبهمة

لمنع المكوّن الإضافي Crashlytics لنظام Gradle من تحميل ملف الربط للإصدارات التي تستخدم التعتيم، اضبط سمة إضافة firebaseCrashlytics.mappingFileUploadEnabled لنظام Gradle على false في ملف Gradle الخاص بالوحدة (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle). يمكن أن يساعد ذلك في تسريع أوقات إنشاء الإصدارات التي تم تعتيمها، ولكن يُرجى العِلم أنّ تتبُّع تسلسل استدعاء الدوال البرمجية الناتج سيظهر معتمًا في صفحة Crashlytics ضمن وحدة تحكّم Firebase.

Kotlin

import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension

// ...

android {

// To enable Crashlytics mapping file upload for specific build types:
buildTypes {
  getByName("debug") {
    minifyEnabled = true
    configure<CrashlyticsExtension> {
      mappingFileUploadEnabled = false
    }
  }
}

...

// To enable Crashlytics mapping file upload for specific product flavors:
flavorDimensions += "environment"
productFlavors {
  create("staging") {
    dimension = "environment"
    ...
    configure<CrashlyticsExtension> {
      mappingFileUploadEnabled = false
    }
  }
  create("prod") {
    dimension = "environment"
    ...
    configure<CrashlyticsExtension> {
      mappingFileUploadEnabled = true
    }
  }
}
}

Groovy

android {

// To enable Crashlytics mapping file upload for specific build types:
buildTypes {
  debug {
    minifyEnabled true
    firebaseCrashlytics {
      mappingFileUploadEnabled false
    }
  }
}

...

// To enable Crashlytics mapping file upload for specific product flavors:
flavorDimensions "environment"
productFlavors {
  staging {
    dimension "environment"
    ...
    firebaseCrashlytics {
      mappingFileUploadEnabled false
    }
  }
  prod {
    dimension "environment"
    ...
    firebaseCrashlytics {
      mappingFileUploadEnabled true
    }
  }
}
}