升級至 Crashlytics Gradle 外掛程式 v3

Crashlytics Gradle 外掛程式的最新版本主要是 更新 SDK,並停止支援較低版本的 SDK,藉此翻新 SDK 以及 Android Gradle 外掛程式此外,這個版本中的變更可解決 AGP 8.1 以上版本的問題,並改善對原生應用程式和自訂版本的支援。

基本規定

Crashlytics Gradle 外掛程式 3 版的最低需求如下:

  • Android Gradle 外掛程式 8.1 以上版本
    使用 Android Gradle 外掛程式升級工具 最新版的 Android Studio

  • Firebase google-servicesGradle 外掛程式 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.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 擴充功能有以下破壞性變更:

  • 已從 defaultConfig Android 區塊中移除擴充功能。請改為設定每個變化版本。

  • 移除已淘汰的欄位 mappingFile。而是改為合併對應檔案 會自動顯示。

  • 移除已淘汰的欄位 strippedNativeLibsDir。相反地 unstrippedNativeLibsDir 適用於所有原生程式庫。

  • 已將「unstrippedNativeLibsDir」欄位變更為累計值。

  • 將結束欄位 symbolGenerator 替換為兩個新的頂層欄位:

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