به پلاگین Crashlytics Gradle نسخه 3 ارتقا دهید

آخرین نسخه پلاگین Crashlytics Gradle یک نسخه اصلی (v3.0.0) است و با حذف پشتیبانی از نسخه های پایین تر Gradle و Android Gradle، SDK را مدرن می کند. علاوه بر این، تغییرات در این نسخه مشکلات مربوط به AGP v8.1+ را حل می کند و پشتیبانی از برنامه های بومی و ساخت های سفارشی را بهبود می بخشد.

حداقل نیازمندی ها

پلاگین Crashlytics Gradle v3 دارای حداقل الزامات زیر است:

• افزونه اندروید Gradle 8.1+
  این افزونه را با استفاده از افزونه Android Gradle Upgrade Assistant در آخرین نسخه اندروید استودیو ارتقا دهید.

• پلاگین google-services Gradle Firebase 4.4.1+
  این افزونه را با مشخص کردن آخرین نسخه در فایل بیلد Gradle پروژه خود ارتقا دهید، مانند:

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

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 حذف کرد. در عوض، شما باید هر گونه را پیکربندی کنید.

• فیلد منسوخ 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 محلی.

مثالی برای نحوه ارتقاء افزونه

        buildTypes {
          release {
            configure<CrashlyticsExtension> {
              // ...
              symbolGenerator(
                closureOf<SymbolGenerator> {
                  symbolGeneratorType = "breakpad"
                  breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS")
                }
              )
            }
          }
        }
      

        buildTypes {
          release {
            configure<CrashlyticsExtension> {
              // ...
              symbolGeneratorType = "breakpad"
              breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS")
            }
          }
        }
      

        buildTypes {
          release {
            firebaseCrashlytics {
              // ...
              symbolGenerator {
                breakpad {
                  binary file("/PATH/TO/BREAKPAD/DUMP_SYMS")
                }
              }
            }
          }
        }
      

        buildTypes {
          release {
            firebaseCrashlytics {
              // ...
              symbolGeneratorType "breakpad"
              breakpadBinary file("/PATH/TO/BREAKPAD/DUMP_SYMS")
            }
          }
        }