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

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

Requisitos da versão 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 (obrigatório)	Versões do Plug-in do Android para Gradle (AGP) e do Gradle (recomendado)
6.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 de versões do Kotlin

O Kotlin 2.1 é compatível com versões anteriores do Kotlin 2.0. Isso significa que, se você já estiver usando o Kotlin 2.0 com o SDK Navigation, poderá fazer upgrade para o Kotlin 2.1 sem precisar resolver todas as mudanças incompatíveis. No entanto, isso se aplica apenas 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 atualizar.

Facilitando a transição: flags de compatibilidade com Kotlin

O Kotlin oferece duas flags para ajudar a limitar mudanças incompatíveis: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Essa flag reverte mudanças significativas no comportamento de uma versão anterior do Kotlin. Por exemplo, se você estiver usando o Kotlin 2.0, poderá especificar [ - language-version 2.0], e as novas mudanças incompatíveis não vão mais entrar em vigor:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

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

Uma abordagem mais direcionada

Além de usar flags de compatibilidade do Kotlin, recomendamos revisar as notas da versão do Kotlin e escolher os comportamentos que você quer manter da versão de origem. O Kotlin oferece 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 1.9
• Guia de compatibilidade 2.0
• guia de compatibilidade 2.1

Futuras atualizações do Kotlin

O Kotlin lança uma nova versão (ou seja, uma versão da 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.