Eseguire la migrazione a Kotlin 2.0
Se utilizzi l'SDK Consumer per Android 3.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 il Consumer SDK 3.0 o versioni successive
L'SDK Consumer 3.0 richiede l'utilizzo di AGP 7.3 o versioni successive.
Modalità R8 completa
La versione 3 e le versioni precedenti dell'SDK consumer non supportano la modalità R8 completa. Devi disattivare esplicitamente la modalità R8 completa se la tua applicazione ha come target AGP 8.0 o versioni successive.
# settings.gradle
android.enableR8.fullMode=false
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 Consumer, dovresti essere in grado di eseguire l'upgrade a Kotlin 2.0 senza dover risolvere tutte le modifiche incompatibili. Tuttavia, la compatibilità con Kotlin si applica solo alle funzionalità linguistiche stabili. Se utilizzi funzionalità alpha, beta o sperimentali nel linguaggio Kotlin, potresti dover apportare ulteriori modifiche durante l'upgrade.
Indicatori 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 verranno 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: