升級至 Crashlytics Gradle 外掛程式 v3

最新發布的 Crashlytics Gradle 外掛程式是主要版本 (3.0.0 版)，並淘汰對較低版本的 Gradle 和 Android Gradle 外掛程式的支援，讓 SDK 更加現代化。此外，這個版本中的變更也解決了 AGP v8.1 以上版本的問題，並改善對原生應用程式和自訂建構作業的支援。

基本規定

Crashlytics Gradle 外掛程式 v3 的最低需求如下：

• Android Gradle 外掛程式 8.1 以上版本
  在最新版 Android Studio 中，使用 Android Gradle 外掛程式升級工具升級這個外掛程式。

• Firebase 的 google-services Gradle 外掛程式 4.4.1 以上版本
  在專案的 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」擴充功能異動

使用第 3 版 Crashlytics Gradle 外掛程式時，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") } } }