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

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

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

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

ปลั๊กอิน Android Gradle 8.1 ขึ้นไป
อัปเกรดปลั๊กอินนี้โดยใช้เครื่องมือช่วยอัปเกรดปลั๊กอิน Android Gradle ใน 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.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

เมื่อใช้ปลั๊กอิน Crashlytics Gradle เวอร์ชัน 3 ส่วนขยาย 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 ด้วยช่องระดับบนสุด 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")
            }
          }
        }