דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

פלאגין Android Gradle בגרסה 8.1 ואילך
כדי לשדרג את הפלאגין הזה, צריך להשתמש בעוזר השדרוג של פלאגין Android Gradle בגרסה העדכנית ביותר של 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")
            }
          }
        }