Compatibilità e migrazione delle versioni di Kotlin

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

Requisiti della versione Kotlin dell'SDK Navigation

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

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

Nota: le versioni di AGP consigliate elencate 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 per Gradle e AGP.

Compatibilità della versione di Kotlin

Kotlin 2.1 supporta la compatibilità con le versioni precedenti di Kotlin 2.0. Ciò significa che se utilizzi già Kotlin 2.0 con l'SDK Navigation, dovresti essere in grado di eseguire l'upgrade a Kotlin 2.1 senza dover risolvere tutte le modifiche che causano interruzioni. Tuttavia, questo vale solo per le funzionalità linguistiche stabili. Se utilizzi funzionalità alpha, beta o sperimentali nel linguaggio Kotlin, potrebbe essere necessario apportare modifiche aggiuntive durante l'upgrade.

Facilitare la transizione: flag di compatibilità Kotlin

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

language-version X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

Un approccio più mirato

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

• Guida alla compatibilità 1.9
• Guida alla compatibilità con la versione 2.0
• 2.1 Guida alla compatibilità

Upgrade futuri di Kotlin

Kotlin rilascia una nuova versione (ovvero una nuova versione 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 e che hanno richiesto ai clienti dell'SDK Navigation 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 dell'SDK Navigation.