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 e orientações para migrar para uma versão mais recente.

Requisitos de versão do Kotlin do SDK do Navigation

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

Versão do SDK do Navigation	Versão do Kotlin (obrigatório)	Plug-in do Android para Gradle (AGP) e versões 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 a 5.99.1	1.9	Recomendamos o uso do 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 com a versão do Kotlin

O Kotlin 2.1 oferece suporte à compatibilidade com o Kotlin 2.0. Isso significa que, se você já estiver usando o Kotlin 2.0 com o SDK de navegação, poderá fazer upgrade para o Kotlin 2.1 sem precisar resolver todas as mudanças importantes. 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 fazer upgrade.

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

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

language-version X.Y

Essa flag reverte mudanças de 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 não terão mais efeito:

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 consultar as notas da versão do Kotlin e escolher os comportamentos que você quer manter da versão que está sendo atualizada. O Kotlin fornece uma lista de mudanças importantes 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
• 2.1 Guia de compatibilidade

Futuras atualizações do Kotlin

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