Eseguire la migrazione all'interfaccia DriverStatusListener
Nella versione 5 di Driver abbiamo annunciato il ritiro dell'interfaccia StatusListener in favore di DriverStatusListener. Quest'anno elimineremo ufficialmente l'interfacciaStatusListener. Fai riferimento al ritiro di StatusListener per una guida alla migrazione alla nuova interfaccia.
Eseguire la migrazione a Kotlin 2.0
Se utilizzi l'SDK Driver 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 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 Driver 6.0 e versioni successive
Ti consigliamo di utilizzare AGP 7.3 e versioni successive con Driver SDK 6.0.
Modalità R8 completa
La versione 6 e precedenti dell'SDK Driver non supporta 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 fino a tre. Ciò significa che se utilizzi già Kotlin 1.7 o versioni successive con l'SDK Driver, 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 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: