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

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

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

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

الإصدار 8.1 من المكوّن الإضافي لنظام Gradle المتوافق مع Android والإصدارات الأحدث
يمكنك ترقية هذا المكوّن الإضافي باستخدام مساعد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android في أحدث إصدار من Android Studio.
google-servicesالمكوّن الإضافي لنظام Gradle‏ 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.3" apply false
  ...
}

Groovy

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

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

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

تمت إزالة الإضافة من حزمة defaultConfig Android. بدلاً من ذلك، عليك ضبط إعدادات كل صيغة.
تمت إزالة الحقل mappingFile الذي تم إيقافه نهائيًا. بدلاً من ذلك، يتم الآن توفير ملف التعيين المدمج تلقائيًا.
تمت إزالة الحقل strippedNativeLibsDir الذي تم إيقافه نهائيًا. بدلاً من ذلك، يجب استخدام unstrippedNativeLibsDir لجميع المكتبات الأصلية.

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

عرض مثال يتضمّن أدلة متعددة

  buildTypes {
    release {
      configure<CrashlyticsExtension> {
        nativeSymbolUploadEnabled = true
        unstrippedNativeLibsDir = file("MY/NATIVE/LIBS")
      }
    }
    productFlavors {
      flavorDimensions += "feature"
      create("basic") {
        dimension = "feature"
        // ...
      }
      create("featureX") {
        dimension = "feature"
        configure<CrashlyticsExtension> {
          unstrippedNativeLibsDir = file("MY/FEATURE_X/LIBS")
        }
      }
    }
  }

لن تحمّل المهمة uploadCrashlyticsSymbolFilesBasicRelease سوى الرموز في MY/NATIVE/LIBS، بينما ستحمّل المهمة uploadCrashlyticsSymbolFilesFeatureXRelease الرموز في كل من MY/NATIVE/LIBS وMY/FEATURE_X/LIBS.

تم استبدال حقل الإغلاق 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")
            }
          }
        }