Migrazione a Kotlin 2.0

Se utilizzi l'SDK Navigation per Android 6.0 e versioni successive, devi eseguire l'upgrade a Kotlin 2.0. Questa pagina fornisce indicazioni per facilitare la transizione alla nuova versione Kotlin.

Compatibilità con Gradle e AGP

Kotlin 2.0 prevede i requisiti per le versioni minima e massima per la tua versione Gradle e Android Gradle Plugin (AGP). Assicurati che il tuo progetto soddisfi questi requisiti per Kotlin 2.0.

Versione minima AGP per l'SDK di navigazione 6.0 o versioni successive

Consigliamo di utilizzare AGP 7.3 e versioni successive con Navigation SDK 6.0. Abbiamo verificato l'SDK con AGP 8.3 e Gradle 8.4 e l'SDK è compatibile con la modalità completa di R8.

Compatibilità della versione di Kotlin

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

Facilitare la transizione: flag di compatibilità di Kotlin

Come indicato nella sezione precedente, Kotlin supporta fino a 3 versioni precedenti del linguaggio durante l'upgrade. Kotlin fornisce due flag per limitare le modifiche sostanziali:

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 1.7, puoi specificare [ - language-version 1.7] e le nuove modifiche non saranno più applicate:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}

api-version X.Y

Questo flag impedisce l'utilizzo di nuove API prima che il codice a valle dipendente sia pronto per incorporare Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Un approccio più mirato

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