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

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

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

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

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

פלאגין של Android Gradle מגרסה 8.1 ואילך
כדי לשדרג את הפלאגין הזה, משתמשים בכלי לשדרוג הפלאגין של Android Gradle בגרסה האחרונה של Android Studio.
הפלאגין של Firebase ל-Gradle בגרסה 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.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 של פלאגין Gradle ‏Crashlytics, התוסף 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")
            }
          }
        }