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 semplificare la transizione alla nuova versione di Kotlin.
Compatibilità con Gradle e AGP
Kotlin 2.0 ha requisiti per le versioni minima e massima per la versione di Gradle e del plug-in Android per Gradle (AGP). Assicurati che il tuo progetto soddisfi questi requisiti per Kotlin 2.0.
Versione minima di AGP per l'SDK Navigation 6.0 e versioni successive
Consigliamo di utilizzare AGP 8.3 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à con le versioni 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 causano un errore al comportamento di una versione Kotlin precedente.
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 di modifiche che comportano interruzioni e gli indicatori che possono essere impostati per mantenere il comportamento originale nelle sue guide alla compatibilità per ogni versione: