Questa pagina è stata tradotta dall'API Cloud Translation.

Esegui l'upgrade al plug-in di Crashlytics Gradle v3

L'ultima release del plug-in Gradle Crashlytics è una delle principali (v3.0.0) e modernizza l'SDK eliminando il supporto per le versioni precedenti di Gradle e del plug-in Android Gradle. Inoltre, le modifiche di questa release risolvono i problemi relativi ad AGP 8.1 e versioni successive e migliorano il supporto per le app native e le build personalizzate.

Requisiti minimi

Il plug-in Gradle Crashlytics versione 3 ha i seguenti requisiti minimi:

Plug-in Android per Gradle 8.1 e versioni successive
Esegui l'upgrade di questo plug-in utilizzando lo strumento di assistenza per l'upgrade del plug-in Android per Gradle sulla versione più recente di Android Studio.
Plug-in Gradle google-services di Firebase 4.4.1+
Esegui l'upgrade di questo plug-in specificando la versione più recente nel Gradle del tuo progetto in un file di build, in questo modo:

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

Modifiche all'estensione Crashlytics

Con la versione 3 del plug-in Gradle Crashlytics, l'estensione Crashlytics presenta le seguenti modifiche che comportano interruzioni:

L'estensione è stata rimossa dal blocco Android defaultConfig. Devi invece configurare ogni variante.
È stato rimosso il campo obsoleto mappingFile. Il file di mapping unito viene fornito automaticamente.
È stato rimosso il campo obsoleto strippedNativeLibsDir. Dovresti invece utilizzare unstrippedNativeLibsDir per tutte le librerie native.

Il campo unstrippedNativeLibsDir è stato modificato in modo da essere cumulativo.

Visualizza un esempio con più directory

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

L'attività uploadCrashlyticsSymbolFilesBasicRelease caricherà solo simboli in MY/NATIVE/LIBS, ma uploadCrashlyticsSymbolFilesFeatureXRelease caricherà simboli in entrambi MY/NATIVE/LIBS e MY/FEATURE_X/LIBS.

Il campo chiusura symbolGenerator è stato sostituito con due nuovi campi di primo livello:
- symbolGeneratorType, una stringa "breakpad" (valore predefinito) o "csym".
- breakpadBinary, un file di override del programma binario dump_syms locale.

Esempio di come eseguire l'upgrade dell'estensione

Kotlin

Prima

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

Ora nella versione 3

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

Groovy

Prima

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

Ora nella v3

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