อัปเกรดเป็นปลั๊กอิน Crashlytics Gradle v3

Crashlyticsปลั๊กอิน Gradle เวอร์ชันล่าสุดเป็นเวอร์ชันหลัก (v3.0.0) และปรับปรุง SDK ให้ทันสมัยด้วยการเลิกสนับสนุน Gradle และปลั๊กอิน Android Gradle เวอร์ชันที่ต่ำกว่า นอกจากนี้ การเปลี่ยนแปลงในรุ่นนี้ยังช่วยแก้ปัญหาเกี่ยวกับ AGP v8.1 ขึ้นไป และปรับปรุงการรองรับแอปเนทีฟและบิลด์ที่กำหนดเอง

ข้อกำหนดขั้นต่ำ

Crashlytics ปลั๊กอิน Gradle v3 มีข้อกำหนดขั้นต่ำดังนี้

• ปลั๊กอิน Android Gradle 8.1 ขึ้นไป
  อัปเกรดปลั๊กอินนี้โดยใช้ Android Gradle plugin Upgrade Assistant ใน Android Studio เวอร์ชันล่าสุด

• google-servicesปลั๊กอิน Gradle 4.4.1 ขึ้นไป
  ของ Firebase อัปเกรดปลั๊กอินนี้โดยระบุเวอร์ชันล่าสุดในไฟล์บิลด์ 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

ปลั๊กอิน Crashlytics Gradle เวอร์ชัน 3 มีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบต่อไปนี้สำหรับส่วนขยาย 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 ด้วยฟิลด์ระดับบนสุดใหม่ 2 รายการ ดังนี้

  • symbolGeneratorType สตริงของ "breakpad" (ค่าเริ่มต้น) หรือ "csym"
  • breakpadBinary ซึ่งเป็นไฟล์ของไบนารี dump_syms ที่ลบล้างในเครื่อง

ตัวอย่างวิธีอัปเกรดส่วนขยาย

Kotlin

ก่อน	buildTypes { release { configure<CrashlyticsExtension> { // ... symbolGenerator( closureOf<SymbolGenerator> { symbolGeneratorType = "breakpad" breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS") } ) } } }
ตอนนี้ใน v3	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") } } } } }
ตอนนี้ใน v3	buildTypes { release { firebaseCrashlytics { // ... symbolGeneratorType "breakpad" breakpadBinary file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } }