Compatibilità e migrazione delle versioni di Kotlin

Questa pagina fornisce informazioni sulla compatibilità delle versioni di Kotlin per Navigation SDK, nonché indicazioni per la migrazione a una versione più recente.

Requisiti della versione di Kotlin per Navigation SDK

La tabella seguente illustra i requisiti della versione di Kotlin e le versioni consigliate di AGP e Gradle per le versioni recenti di Navigation SDK.

Versione di Navigation SDK	Versione di Kotlin (obbligatoria)	Versioni di plug-in Android per Gradle (AGP) e Gradle (consigliate)
7.7+	2.3.0	AGP 8.13.2 Gradle 8.13
7.3 - 7.6	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	Ti consigliamo di utilizzare AGP 7.3 o versioni successive, che include una soluzione alternativa per JDK-8272564.

Nota: le versioni di AGP consigliate sopra tengono conto dell'utilizzo di R8/D8, incluso in AGP. Se non utilizzi R8/D8, consulta i requisiti di Kotlin per le versioni minima e massima di Gradle e AGP.

Compatibilità delle versioni di Kotlin

Kotlin 2.3 supporta la compatibilità con le versioni precedenti di Kotlin 2.2. Ciò significa che, se utilizzi già Kotlin 2.2 con Navigation SDK, dovresti essere in grado di eseguire l'upgrade a Kotlin 2.3 senza dover risolvere tutte le modifiche che provocano un errore. Tuttavia, questo vale solo per le funzionalità del linguaggio stabili. Se utilizzi funzionalità alfa, beta o sperimentali nel linguaggio Kotlin, potresti dover apportare modifiche aggiuntive durante l'upgrade.

Semplificare la transizione: flag di compatibilità di Kotlin

Kotlin fornisce due flag per limitare le modifiche che provocano un errore: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Questo flag ripristina le modifiche che provocano un errore nel comportamento di una versione precedente di Kotlin. Ad esempio, se utilizzi Kotlin 2.2, puoi specificare [ - language-version 2.2] e le nuove modifiche che provocano un errore non avranno più effetto:

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

api-version X.Y

Questo flag genera un errore di compilazione di Gradle quando viene utilizzata un'API di una versione di Kotlin più recente di apiVersion.

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

Un approccio più mirato

Oltre a utilizzare i flag di compatibilità di Kotlin, ti consigliamo di esaminare le note di rilascio di Kotlin e scegliere i comportamenti che vuoi conservare dalla versione da cui stai eseguendo l'upgrade. Kotlin fornisce un elenco di modifiche che provocano un errore e i flag che possono essere impostati per conservare il comportamento originale nelle guide alla compatibilità per ogni versione:

• Guida alla compatibilità di 2.0
• Guida alla compatibilità di 2.1
• Guida alla compatibilità di 2.2
• Guida alla compatibilità di 2.3

Upgrade futuri di Kotlin

Kotlin rilascia una nuova versione (ovvero una release del linguaggio) ogni 6 mesi e Google in genere incorpora l'ultima versione come predefinita nei suoi prodotti 1-2 mesi dopo. Le versioni precedenti di Kotlin includono modifiche che provocano un errore che hanno richiesto ai clienti di Navigation SDK di eseguire l'upgrade a una versione più recente. Per questo motivo, ti consigliamo di pianificare un upgrade di Kotlin ogni 6 mesi quando adotti l'ultima versione di Navigation SDK.