Eseguire la migrazione all'interfaccia DriverStatusListener
In Driver v5 abbiamo annunciato il ritiro dell'interfaccia StatusListener a
favore di DriverStatusListener. Quest'anno elimineremo ufficialmente l'interfaccia StatusListener. Consulta la sezione StatusListener
ritiro
per una guida alla migrazione alla nuova interfaccia.
Eseguire la migrazione a Kotlin 2.0
Se utilizzi Driver SDK 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à di Gradle e AGP
Kotlin 2.0 ha requisiti per le versioni minima e massima 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 Driver SDK 6.0 e versioni successive
Ti consigliamo di utilizzare AGP 7.3 o versioni successive con Driver SDK 6.0.
Modalità R8 completa
Driver SDK v6 e versioni precedenti non supportano la modalità R8 completa. Devi disattivare esplicitamente la modalità R8 completa se la tua applicazione è destinata ad AGP 8.0 o versioni successive.
# settings.gradle
android.enableR8.fullMode=false
Compatibilità delle versioni di Kotlin
Kotlin supporta la compatibilità con le versioni precedenti di tre versioni del linguaggio versioni. Ciò significa che, se utilizzi già Kotlin 1.7 o versioni successive con Driver SDK, dovresti essere in grado di eseguire l'upgrade a Kotlin 2.0 senza dover risolvere tutte le modifiche che causano interruzioni. Tuttavia, la compatibilità di Kotlin si applica solo alle funzionalità del linguaggio stabili features. Se utilizzi funzionalità alpha, beta o sperimentali nel linguaggio Kotlin, potresti dover apportare modifiche aggiuntive durante l'upgrade.
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 che causano interruzioni:
language-version X.Y
Questo flag ripristina le modifiche che causano interruzioni al comportamento di una versione precedente di Kotlin.
Ad esempio, se utilizzi Kotlin 1.7, puoi specificare [ -
language-version 1.7] e le nuove modifiche che causano interruzioni non avranno più effetto:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version X.Y
Questo flag impedisce l'utilizzo di nuove API prima che il codice downstream 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 scegliere i comportamenti che vuoi conservare dalla versione da cui stai eseguendo 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: