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

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

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

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

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

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