Crashlytics Gradle プラグイン v3 にアップグレードする

Crashlytics Gradle プラグインの最新リリースは、メジャーバージョン（v3.0.0）で、Gradle と Android Gradle プラグインの下位バージョンのサポートを終了することで SDK をモダナイズしています。また、このリリースでの変更により、AGP v8.1 以降に関する問題が解決され、ネイティブアプリとカスタマイズしたビルドのサポートが改善されています。

最小要件

Crashlytics Gradle プラグイン v3 の最小要件は以下のとおりです。

Android Gradle プラグイン 8.1 以降
Android Studio の最新バージョンで Android Gradle プラグイン Upgrade Assistant を使用してこのプラグインをアップグレードします。
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.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 プラグインの v3 では、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")
            }
          }
        }