หน้านี้ได้รับการแปลโดย Cloud Translation API

อัปเกรดเป็นปลั๊กอิน 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")
            }
          }
        }