Guia de migração do SDK Driver do Android 6.0

Interface do Migrate to DriverStatusListener

No Driver v5, anunciamos a descontinuação da interface StatusListener em favor de DriverStatusListener. Este ano, vamos excluir oficialmente a interface StatusListener. Consulte a descontinuação de StatusListener para ver um guia de migração para a nova interface.

Migrar para o Kotlin 2.0

Se você estiver usando o SDK do Driver para Android 6.0 ou mais recente, faça upgrade para o Kotlin 2.0. Esta página fornece orientações para facilitar a transição para a nova versão do Kotlin.

Compatibilidade do Gradle e do AGP

O Kotlin 2.0 tem requisitos para as versões mínima e máxima do Gradle e do Plug-in do Android para Gradle (AGP). Verifique se o projeto atende a esses requisitos para o Kotlin 2.0.

Versão mínima do AGP para o SDK do Driver 6.0+

Recomendamos usar o AGP 7.3+ com o SDK para Driver 6.0.

Modo completo do R8

O SDK do Driver v6 e versões anteriores não são compatíveis com o modo R8 completo. É necessário desativar explicitamente o modo completo do R8 se o aplicativo for direcionado ao AGP 8.0+.

# settings.gradle
android.enableR8.fullMode=false

Compatibilidade de versões do Kotlin

O Kotlin é compatível com versões anteriores de três versões de linguagem anteriores (link em inglês). Isso significa que, se você já estiver usando o Kotlin 1.7+ com o SDK do Driver, poderá fazer upgrade para o Kotlin 2.0 sem precisar resolver todas as alterações interruptivas. No entanto, a compatibilidade com o Kotlin só se aplica a recursos de linguagem estáveis. Se você estiver usando recursos Alfa, Beta ou experimentais na linguagem Kotlin, talvez seja necessário fazer outras mudanças ao fazer upgrade.

Sinalizações de compatibilidade do Kotlin

Como observado na seção anterior, o Kotlin oferece suporte a até três versões anteriores da linguagem ao fazer upgrade. O Kotlin fornece duas flags para ajudar a limitar as alterações interruptivas:

language-version X.Y

Essa flag reverte as alterações interruptivas no comportamento de uma versão anterior do Kotlin. Por exemplo, se você estiver usando o Kotlin 1.7, poderá especificar [ - language-version 1.7], e as novas alterações interruptivas não vão mais entrar em vigor:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

Essa flag impede que novas APIs sejam usadas antes que o código downstream dependente esteja pronto para incorporar o Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Uma abordagem mais direcionada

Além de usar as flags de compatibilidade do Kotlin, recomendamos que você consulte as notas da versão do Kotlin e escolha os comportamentos que quer manter da versão que está sendo atualizada. O Kotlin fornece uma lista de alterações interruptivas e as flags que podem ser definidas para manter o comportamento original nos guias de compatibilidade de cada versão: