تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

المكوّن الإضافي لنظام Gradle المتوافق مع Android 8.1 والإصدارات الأحدث
يمكنك ترقية هذا المكوّن الإضافي باستخدام مساعِد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android على أحدث إصدار من Android Studio.
google-services المكوّن الإضافي لنظام Gradle 4.4.1 والإصدارات الأحدث من Firebase
: يمكنك ترقية هذا المكوّن الإضافي من خلال تحديد أحدث إصدار في ملف Gradle التصميم الخاص بمشروعك، على النحو التالي:

Kotlin

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

Groovy

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

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

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

تمت إزالة الإضافة من حظر Android defaultConfig. بدلاً من ذلك، عليك ضبط كلّ صيغة.
تمت إزالة الحقل المتوقّف 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")
            }
          }
        }