שדרוג לגרסה 3 של הפלאגין Crashlytics Gradle

הגרסה האחרונה של פלאגין Crashlytics Gradle היא גרסה ראשית (v3.0.0), והיא כוללת עדכון של ה-SDK על ידי הפסקת התמיכה בגרסאות ישנות יותר של Gradle ושל פלאגין Android Gradle. בנוסף, השינויים בגרסה הזו פותרים בעיות ב-AGP מגרסה 8.1 ואילך, ומשפרים את התמיכה באפליקציות מקוריות ובגרסאות מותאמות אישית.

דרישות מינימליות

Crashlytics לתוסף Gradle גרסה 3 יש את דרישות המינימום הבאות:

• ‫Android Gradle plugin 8.1+
  כדי לשדרג את הפלאגין הזה, צריך להשתמש בAndroid Gradle plugin Upgrade Assistant בגרסה העדכנית ביותר של Android Studio.

• ‫google-services Gradle plugin 4.4.1+
  של Firebase כדי לשדרג את הפלאגין הזה, מציינים את הגרסה האחרונה בקובץ ה-build של 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") } } }