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

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

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

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

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

  • ‫Firebase google-services Gradle plugin 4.4.1+
    כדי לשדרג את הפלאגין הזה, מציינים את הגרסה העדכנית בקובץ ה-build של Gradle בפרויקט, באופן הבא:

Kotlin 

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

Groovy 

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

שינויים בתוסף Crashlytics

בגרסה 3 של Crashlytics Gradle plugin, יש את שינויי התוכנה הבאים שעלולים לגרום לכשל בתוסף Crashlytics:

  • התוסף הוסר מהבלוק defaultConfig android. במקום זאת, צריך להגדיר כל וריאנט.

  • הוסר השדה שיצא משימוש mappingFile. במקום זאת, קובץ המיפוי הממוזג מסופק עכשיו באופן אוטומטי.

  • הוסר השדה שיצא משימוש strippedNativeLibsDir. במקום זאת, צריך להשתמש ב-unstrippedNativeLibsDir לכל הספריות המקומיות.

  • השדה unstrippedNativeLibsDir השתנה והפך לשדה מצטבר.

  • החלפנו את שדה הסגירה 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")
            }
          }
        }