Руководство по миграции Android Driver SDK 6.0

Переход на интерфейс DriverStatusListener

В версии Driver v5 мы объявили об устаревании интерфейса StatusListener в пользу DriverStatusListener . В этом году мы официально удаляем интерфейс StatusListener . Руководство по миграции на новый интерфейс см. в разделе «Устаревание StatusListener .

Переход на Kotlin 2.0

Если вы используете Driver SDK для Android 6.0 и выше, вам необходимо обновиться до Kotlin 2.0. На этой странице приведены инструкции, которые помогут упростить переход на новую версию Kotlin.

Совместимость с Gradle и AGP

Kotlin 2.0 предъявляет требования к минимальной и максимальной версиям Gradle и Android Gradle Plugin (AGP). Убедитесь, что ваш проект соответствует этим требованиям для Kotlin 2.0.

Минимальная версия AGP для Driver SDK: 6.0+

Мы рекомендуем использовать AGP 7.3+ с Driver SDK 6.0.

Полный режим R8

В версиях Driver SDK 6 и ниже режим Full R8 не поддерживается. Если ваше приложение ориентировано на AGP 8.0+, необходимо явно отключить режим Full R8.

# settings.gradle
android.enableR8.fullMode=false

совместимость версий Kotlin

Kotlin supports backwards compatibility with three previous language versions . This means that if you are already using Kotlin 1.7+ with the Driver SDK, you should be able to upgrade to Kotlin 2.0 without having to resolve all of the breaking changes. However, Kotlin compatibility only applies to stable language features . If you are using alpha, beta or experimental features in the Kotlin language, then you may have to make additional changes when upgrading.

Флаги совместимости Kotlin

Как отмечалось в предыдущем разделе, Kotlin поддерживает до 3 предыдущих версий языка при обновлении. Kotlin предоставляет два флага, которые помогают ограничить внесение критических изменений :

языковая версия XY

Этот флаг отменяет изменения, нарушающие обратную совместимость, и возвращает поведение к предыдущей версии Kotlin. Например, если вы используете Kotlin 1.7, вы можете указать [ - language-version 1.7] , и новые изменения, нарушающие обратную совместимость, больше не будут действовать:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version XY

Этот флаг предотвращает использование новых API до тех пор, пока зависимый код не будет готов к интеграции с Kotlin 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Более целенаправленный подход

Помимо использования флагов совместимости Kotlin, мы рекомендуем ознакомиться с примечаниями к выпуску Kotlin и выбрать те параметры поведения, которые вы хотите сохранить из версии, с которой вы обновляетесь. Kotlin предоставляет список критических изменений и флагов, которые можно установить для сохранения исходного поведения, в своих руководствах по совместимости для каждой версии: