Compatibilidade e migração de versão do Kotlin

Esta página fornece informações sobre a compatibilidade da versão do Kotlin com o SDK Navigation, além de orientações para migrar para uma versão mais recente.

Requisitos de versão do Kotlin do SDK Navigation

A tabela a seguir descreve os requisitos de versão do Kotlin e as versões recomendadas do AGP e do Gradle para versões recentes do SDK Navigation.

Versão do SDK Navigation	Versão do Kotlin (necessária)	Versões do Plug-in do Android para Gradle (AGP) e do Gradle (recomendadas)
7.3+	2.2.10	AGP 8.10.0 Gradle 8.11.1
6.3 - 7.2	2.1	AGP 8.7.3 Gradle 8.10.2
6.0 - 6.2	2.0	AGP 8.3.0 Gradle 8.4
5.1 - 5.99.1	1.9	Recomendamos usar o AGP 7.3 ou mais recente, que tem uma solução alternativa para o JDK-8272564.

Observação: as versões recomendadas do AGP listadas acima consideram o uso do R8/D8, que está incluído no AGP. Se você não estiver usando o R8/D8, consulte os requisitos do Kotlin para as versões mínima e máxima do Gradle e do AGP.

Compatibilidade da versão do Kotlin

O Kotlin 2.2 oferece compatibilidade com versões anteriores do Kotlin 2.1. Isso significa que, se você já estiver usando o Kotlin 2.1 com o SDK Navigation, poderá fazer upgrade para o Kotlin 2.2 sem precisar resolver todas as mudanças interruptivas. No entanto, isso 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.

Como facilitar a transição: flags de compatibilidade do Kotlin

O Kotlin fornece duas flags para ajudar a limitar as mudanças interruptivas: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Essa flag reverte as mudanças interruptivas para o comportamento de uma versão anterior do Kotlin. Por exemplo, se você estiver usando o Kotlin 2.1, poderá especificar [ - language-version 2.1] e as novas mudanças interruptivas não terão mais efeito:

android {
   kotlinOptions {
       languageVersion = '2.1'
   }
}

api-version X.Y

Essa flag gera um erro de build do Gradle quando uma API de uma versão do Kotlin mais recente que a apiVersion é usada.

android {
   kotlinOptions {
       apiVersion = '2.1'
   }
}

Uma abordagem mais direcionada

Além de usar flags de compatibilidade do Kotlin, recomendamos revisar as notas de versão do Kotlin e escolher os comportamentos que você quer manter da versão em que está fazendo upgrade. O Kotlin fornece uma lista de mudanças interruptivas e as flags que podem ser definidas para manter o comportamento original nos guias de compatibilidade de cada versão:

• Guia de compatibilidade 2.0
• Guia de compatibilidade 2.1
• Guia de compatibilidade 2.2

Upgrades futuros do Kotlin

O Kotlin lança uma nova versão (ou seja, uma versão de linguagem) a cada seis meses e o Google normalmente incorpora a versão mais recente como padrão nos nossos produtos um ou dois meses depois. As versões anteriores do Kotlin incluíram mudanças interruptivas que exigiram que os clientes do SDK Navigation fizessem upgrade para uma versão mais recente. Por isso, recomendamos que você planeje um upgrade do Kotlin a cada seis meses ao adotar a versão mais recente do SDK Navigation.