الترقية إلى الإصدار 3 من المكوّن الإضافي Crashlytics Gradle

إنّ أحدث إصدار من Crashlytics المكوّن الإضافي لنظام Gradle هو إصدار رئيسي (الإصدار 3.0.0) ويتم تحديث حزمة SDK من خلال إيقاف التوافق مع الإصدارات الأقدم من نظام Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android. بالإضافة إلى ذلك، تعمل التغييرات في هذا الإصدار على حلّ المشاكل المتعلّقة بالإصدار 8.1 والإصدارات الأحدث من المكوّن الإضافي لنظام Gradle في Android، كما تعمل على تحسين التوافق مع التطبيقات الأصلية وعمليات الإنشاء المخصّصة.

الحد الأدنى من المتطلبات

يجب استيفاء الحد الأدنى من المتطلبات التالية لاستخدام الإصدار 3 من المكوّن الإضافي Crashlytics لنظام Gradle:

  • الإصدار 8.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث
    يمكنك ترقية هذا المكوّن الإضافي باستخدام مساعِد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android في أحدث إصدار من "استوديو Android".

  • google-servicesالمكوّن الإضافي لنظام Gradle في Firebase‏ 4.4.1 أو الإصدارات الأحدث
    يمكنك ترقية هذا المكوّن الإضافي من خلال تحديد أحدث إصدار في ملف Gradle الخاص بمشروعك، كما يلي:

Kotlin 

plugins {
  id("com.android.application") version "8.1.4" apply false
  id("com.google.gms.google-services") version "4.4.4" apply false
  ...
}

Groovy 

plugins {
  id 'com.android.application' version '8.1.4' apply false
  id 'com.google.gms.google-services' version '4.4.4' apply false
  ...
}

تغييرات على إضافة "Crashlytics"

في الإصدار 3 من المكوّن الإضافي Crashlytics لنظام Gradle، تتضمّن الإضافة Crashlytics التغييرات التالية التي قد تؤدي إلى أعطال:

  • تمت إزالة الإضافة من حزمة defaultConfig Android. بدلاً من ذلك، عليك ضبط إعدادات كل صيغة.

  • تمت إزالة الحقل mappingFile الذي تم إيقافه نهائيًا. بدلاً من ذلك، يتم الآن توفير ملف التعيين المدمج تلقائيًا.

  • تمت إزالة الحقل strippedNativeLibsDir الذي تم إيقافه نهائيًا. بدلاً من ذلك، يجب استخدام unstrippedNativeLibsDir لجميع المكتبات الأصلية.

  • تم تغيير الحقل unstrippedNativeLibsDir ليصبح تراكميًا.

  • تم استبدال حقل الإغلاق symbolGenerator بحقلَين جديدَين من المستوى الأعلى:

    • ‫symbolGeneratorType، وهي سلسلة تتضمّن إما "breakpad" (القيمة التلقائية) أو "csym".
    • ‫breakpadBinary، وهو ملف يتضمّن عملية إلغاء ثنائية محلية dump_syms.

مثال على كيفية ترقية الإضافة

Kotlin

قبل 
        buildTypes {
          release {
            configure<CrashlyticsExtension> {
              // ...
              symbolGenerator(
                closureOf<SymbolGenerator> {
                  symbolGeneratorType = "breakpad"
                  breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS")
                }
              )
            }
          }
        }
الميزات الجديدة في الإصدار 3 
        buildTypes {
          release {
            configure<CrashlyticsExtension> {
              // ...
              symbolGeneratorType = "breakpad"
              breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS")
            }
          }
        }

Groovy

قبل 
        buildTypes {
          release {
            firebaseCrashlytics {
              // ...
              symbolGenerator {
                breakpad {
                  binary file("/PATH/TO/BREAKPAD/DUMP_SYMS")
                }
              }
            }
          }
        }
الميزات الجديدة في الإصدار 3 
        buildTypes {
          release {
            firebaseCrashlytics {
              // ...
              symbolGeneratorType "breakpad"
              breakpadBinary file("/PATH/TO/BREAKPAD/DUMP_SYMS")
            }
          }
        }