Zur DriverStatusListener-Oberfläche migrieren
In Driver v5 haben wir die Einstellung der StatusListener-Benutzeroberfläche zugunsten von DriverStatusListener angekündigt. Dieses Jahr wird die StatusListener-Benutzeroberfläche offiziell eingestellt. Eine Anleitung zur Migration zur neuen Benutzeroberfläche finden Sie unter StatusListener.
Zu Kotlin 2.0 migrieren
Wenn Sie das Driver SDK für Android 6.0 oder höher verwenden, müssen Sie auf Kotlin 2.0 umstellen. Auf dieser Seite finden Sie eine Anleitung, die den Übergang zur neuen Kotlin-Version erleichtern soll.
Kompatibilität mit Gradle und AGP
Für Kotlin 2.0 gelten Anforderungen an die Mindest- und Höchstversionen für Ihre Gradle- und Android Gradle Plugin (AGP)-Version. Achten Sie darauf, dass Ihr Projekt diese Anforderungen für Kotlin 2.0 erfüllt.
Mindestversion von AGP für das Driver SDK 6.0 und höher
Wir empfehlen die Verwendung von AGP 7.3 oder höher mit dem Driver SDK 6.0.
Vollständiger R8-Modus
Das Driver SDK 6 und niedriger unterstützt den Full R8-Modus nicht. Sie müssen den Modus „Full R8“ explizit deaktivieren, wenn Ihre Anwendung auf AGP 8.0 oder höher ausgerichtet ist.
# settings.gradle
android.enableR8.fullMode=false
Kompatibilität mit Kotlin-Versionen
Kotlin unterstützt die Abwärtskompatibilität mit drei früheren Sprachversionen. Wenn Sie also bereits Kotlin 1.7 oder höher mit dem Driver SDK verwenden, sollten Sie auf Kotlin 2.0 umstellen können, ohne alle bahnbrechenden Änderungen beheben zu müssen. Die Kotlin-Kompatibilität gilt jedoch nur für stabile Sprachfunktionen. Wenn Sie Alpha-, Beta- oder experimentelle Funktionen in der Kotlin-Programmiersprache verwenden, müssen Sie beim Upgrade möglicherweise zusätzliche Änderungen vornehmen.
Kotlin-Kompatibilitäts-Flags
Wie im vorherigen Abschnitt erwähnt, unterstützt Kotlin beim Upgrade bis zu drei vorherige Versionen der Sprache. Kotlin bietet zwei Flags, mit denen sich bahnbrechende Änderungen einschränken lassen:
language-version X.Y
Mit diesem Flag werden bahnbrechende Änderungen am Verhalten einer früheren Kotlin-Version rückgängig gemacht.
Wenn Sie beispielsweise Kotlin 1.7 verwenden, können Sie [ -
language-version 1.7] angeben. Die neuen bahnbrechenden Änderungen werden dann nicht mehr angewendet:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version X.Y
Dieses Flag verhindert, dass neue APIs verwendet werden, bevor abhängiger Downstream-Code für die Einbindung von Kotlin 2.0 bereit ist.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
Ein zielgerichteterer Ansatz
Neben der Verwendung von Kotlin-Kompatibilitätsflags empfehlen wir Ihnen, die Kotlin-Releasenotes zu lesen und die Verhaltensweisen auszuwählen, die Sie aus der Version beibehalten möchten, von der Sie ein Upgrade durchführen. In den Kompatibilitätsleitfäden für jede Version von Kotlin finden Sie eine Liste der bahnbrechenden Änderungen und die Flags, die festgelegt werden können, um das ursprüngliche Verhalten beizubehalten: