Migração do SDK de consumidor do Android v2.0.0

Atualizações do Gradle e do Plug-in do Android para Gradle

Fazer upgrade das versões do Gradle e do Plug-in do Android para Gradle

Primeiro, faça upgrade das versões do Gradle e do Plug-in do Android para Gradle. Esse upgrade inclui melhor compatibilidade com determinadas dependências do SDK (incluindo o Kotlin 1.9), além de algumas correções de bugs importantes.

Esta versão principal do SDK requer as seguintes dependências de versão para seu projeto de aplicativo Android:

  • uma versão do Gradle pelo menos v7.5.0, mas não superior à v7.6.0.
  • uma versão do Plug-in do Android para Gradle (AGP, na sigla em inglês) na faixa da v7.4.x.

Você pode segmentar uma versão mais recente dos plug-ins. No entanto, talvez você encontre avisos de descontinuação ou alguns recursos novos não funcionem.

Para modificar a versão do Gradle, modifique a linha no arquivo /gradle/wrapper/gradle-wrapper.properties do projeto.

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip

Para modificar a versão do Plug-in do Android para Gradle, modifique o arquivo build.gradle que contém o bloco buildscript. Exemplo:

buildscript {
    repositories {
        google()
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.1'
    }
}

Migração de suporte à biblioteca do Java 7 para o Java 8

Etapa 1: ativar o suporte à biblioteca Java 8

Origem

Como o nível mínimo da API do SDK é 23 e a versão necessária do AGP é 7.4 ou mais recente, a configuração é um pouco diferente da documentação de origem mencionada.

buildscript {

    repositories {
        google()
        mavenCentral()
        jcenter()
        maven {
            url = uri("https://storage.googleapis.com/r8-releases/raw")
        }
    }
    dependencies {
        classpath 'com.android.tools:r8:8.0.46'
        classpath 'com.android.tools.build:gradle:7.4.1'
    }
}

android {
    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.3'
}

Etapa 2: migrar do Proguard ou Dexguard para o R8

R8, fonte

A AGP v7.4 ou mais recente usa o R8 como a ferramenta de redução, ofuscação e otimização padrão para o binário. Portanto, nenhuma ação especial é necessária neste momento.

Se o projeto for migrado do AGP 4.0 ou versões mais recentes, o AGP poderá emitir os seguintes avisos sobre remoções de arquivos:

  • Uso de useProguard true no arquivo build.gradle
  • Uso de android.enableR8=false no arquivo gradle.properties

A remoção dessas linhas geralmente resolve esses problemas.

Migração do Kotlin 1.6 para o 1.9

Etapa 1: migrar para o Plug-in do Kotlin para Gradle 1.9.0

Origem

Atualize a versão do plug-in do Gradle do Kotlin no arquivo build.gradle do módulo de nível superior do aplicativo. Adicione org.jetbrains.kotlin:kotlin-gradle-plugin nas dependências do bloco do buildscript, caso ele esteja ausente.

buildscript {
  dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0"
  }
}

Você precisa migrar seu aplicativo de Kotlin-synthetics caso esteja vindo do Plug-in do Kotlin para Gradle 1.6.X ou 1.7.X. Consulte o guia oficial de migração para mais informações.

Etapa 2: fazer upgrade do kotlin-stdlib para 1.9.0

Origem

Faça upgrade do kotlin-stblib para 1.9.0 no arquivo build.gradle do aplicativo.

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.0"
}

Remova todas as referências a kotlin-stdlib-jdk7 ou kotlin-stdlib-jdk8. Ambas as dependências foram consolidadas em kotlin-stdlib a partir do Kotlin 1.8.0.