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

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

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

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

• הפלאגין ל-Android Gradle מגרסה 8.1 ואילך
  שדרוג הפלאגין באמצעות כלי השדרוג של הפלאגין של Android Gradle בגרסה העדכנית ביותר של Android Studio.

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

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") } } }