Passer au plug-in Crashlytics Gradle v3

La dernière version du plug-in Gradle Crashlytics est une version majeure (v3.0.0) qui modernise le SDK en abandonnant la prise en charge des versions antérieures de Gradle et du plug-in Android Gradle. De plus, les modifications apportées à cette version résolvent les problèmes liés à AGP v8.1+ et améliorent la compatibilité avec les applications natives et les builds personnalisés.

Conditions minimales requises

Le plug-in Gradle v3 présente les exigences minimales suivantes :Crashlytics

Plug-in Android Gradle 8.1+
Mettez à niveau ce plug-in à l'aide de l'assistant de mise à niveau du plug-in Android Gradle sur la dernière version d'Android Studio.
Plug-in Gradle 4.4.1+ de Firebase
Mettez à niveau ce plug-in en spécifiant la dernière version dans le fichier de compilation Gradle de votre projet, comme suit :google-services

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

Modifications apportées à l'extension Crashlytics

Avec la version 3 du plug-in Gradle Crashlytics, l'extension Crashlytics présente les modifications importantes suivantes :

Suppression de l'extension du bloc Android defaultConfig. Vous devez plutôt configurer chaque variante.
Suppression du champ obsolète mappingFile. À la place, le fichier de mappage fusionné est désormais fourni automatiquement.
Suppression du champ obsolète strippedNativeLibsDir. Vous devez plutôt utiliser unstrippedNativeLibsDir pour toutes les bibliothèques natives.

Le champ unstrippedNativeLibsDir est désormais cumulatif.

Afficher un exemple avec plusieurs répertoires

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

La tâche uploadCrashlyticsSymbolFilesBasicRelease n'importera que les symboles dans MY/NATIVE/LIBS, mais uploadCrashlyticsSymbolFilesFeatureXRelease importera les symboles dans MY/NATIVE/LIBS et MY/FEATURE_X/LIBS.

Le champ de clôture symbolGenerator a été remplacé par deux nouveaux champs de premier niveau :
- symbolGeneratorType, une chaîne de caractères "breakpad" (par défaut) ou "csym".
- breakpadBinary, fichier de remplacement binaire dump_syms local.

Exemple de mise à niveau de l'extension

Kotlin

Avant

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

Maintenant dans la version 3

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

Groovy

Avant

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

Maintenant dans la version 3

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