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

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

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

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

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 כולל את שינויי התוכנה הבאים:

הוסר התוסף מהבלוק 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")
            }
          }
        }