Nâng cấp lên trình bổ trợ Crashlytics Gradle phiên bản 3

Bản phát hành mới nhất của trình bổ trợ Gradle Crashlytics là một phiên bản chính (v3.0.0) và hiện đại hoá SDK bằng cách ngừng hỗ trợ các phiên bản thấp hơn của Gradle và trình bổ trợ Android cho Gradle. Ngoài ra, những thay đổi trong bản phát hành này sẽ giải quyết các vấn đề với AGP phiên bản 8.1 trở lên và cải thiện khả năng hỗ trợ cho các ứng dụng gốc và bản dựng tuỳ chỉnh.

Yêu cầu tối thiểu

Crashlytics Trình bổ trợ Gradle phiên bản 3 có các yêu cầu tối thiểu sau:

Trình bổ trợ Android cho Gradle 8.1 trở lên
Nâng cấp trình bổ trợ này bằng Trợ lý nâng cấp trình bổ trợ Android cho Gradle trên phiên bản Android Studio mới nhất.
Trình bổ trợ Gradle 4.4.1+ google-services của Firebase
Nâng cấp trình bổ trợ này bằng cách chỉ định phiên bản mới nhất trong tệp bản dựng Gradle của dự án, như sau:

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
  ...
}

Các thay đổi đối với tiện ích Crashlytics

Với trình bổ trợ Gradle Crashlytics phiên bản 3, tiện ích Crashlytics có những thay đổi có thể gây lỗi sau:

Xoá tiện ích khỏi khối defaultConfig android. Thay vào đó, bạn nên định cấu hình từng biến thể.
Xoá trường mappingFile không dùng nữa. Thay vào đó, tệp ánh xạ đã hợp nhất hiện được cung cấp tự động.
Xoá trường strippedNativeLibsDir không dùng nữa. Thay vào đó, bạn nên dùng unstrippedNativeLibsDir cho tất cả các thư viện gốc.

Đã thay đổi trường unstrippedNativeLibsDir thành trường tích luỹ.

Xem ví dụ có nhiều thư mục

  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")
        }
      }
    }
  }

Tác vụ uploadCrashlyticsSymbolFilesBasicRelease sẽ chỉ tải các biểu tượng lên trong MY/NATIVE/LIBS, nhưng uploadCrashlyticsSymbolFilesFeatureXRelease sẽ tải các biểu tượng lên trong cả MY/NATIVE/LIBS và MY/FEATURE_X/LIBS.

Thay thế trường đóng cửa symbolGenerator bằng 2 trường cấp cao nhất mới:
- symbolGeneratorType, một chuỗi có giá trị là "breakpad" (mặc định) hoặc "csym".
- breakpadBinary, một tệp của chế độ ghi đè nhị phân dump_syms cục bộ.

Ví dụ về cách nâng cấp tiện ích

Kotlin

Trước

        buildTypes {
          release {
            configure<CrashlyticsExtension> {
              // ...
              symbolGenerator(
                closureOf<SymbolGenerator> {
                  symbolGeneratorType = "breakpad"
                  breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS")
                }
              )
            }
          }
        }

Hiện có trong phiên bản 3

        buildTypes {
          release {
            configure<CrashlyticsExtension> {
              // ...
              symbolGeneratorType = "breakpad"
              breakpadBinary = file("/PATH/TO/BREAKPAD/DUMP_SYMS")
            }
          }
        }

Groovy

Trước

        buildTypes {
          release {
            firebaseCrashlytics {
              // ...
              symbolGenerator {
                breakpad {
                  binary file("/PATH/TO/BREAKPAD/DUMP_SYMS")
                }
              }
            }
          }
        }

Hiện có trong phiên bản 3

        buildTypes {
          release {
            firebaseCrashlytics {
              // ...
              symbolGeneratorType "breakpad"
              breakpadBinary file("/PATH/TO/BREAKPAD/DUMP_SYMS")
            }
          }
        }