Se utilizzi l'SDK di navigazione per Android 6.0 o 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 minime e massime 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
Ti consigliamo di utilizzare AGP 7.3 o versioni successive con l'SDK per la navigazione 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 funzioni alpha, beta o sperimentali in lingua Kotlin, potresti dover apportare ulteriori modifiche durante l'upgrade.
Facilitazione della transizione: flag di compatibilità di Kotlin
Come indicato nella sezione precedente, Kotlin supporta fino a tre versioni precedenti del linguaggio durante l'upgrade. Kotlin fornisce due flag per contribuire a limitare le modifiche che provocano un errore:
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'
}
}
versione-api 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: