Zur DriverStatusListener-Schnittstelle migrieren
In Driver v5 haben wir die Einstellung der StatusListener-Schnittstelle zugunsten von DriverStatusListener angekündigt. Dieses Jahr wird die StatusListener-Schnittstelle offiziell entfernt. Im Migrationsleitfaden zur Einstellung von StatusListener
finden Sie Informationen zur Migration zur neuen Schnittstelle.
Zu Kotlin 2.0 migrieren
Wenn Sie das Driver SDK für Android 6.0 oder höher verwenden, müssen Sie ein Upgrade auf Kotlin 2.0 durchführen. Auf dieser Seite finden Sie eine Anleitung, die den Übergang zur neuen Kotlin-Version erleichtern soll.
Gradle- und AGP-Kompatibilität
Für Kotlin 2.0 gelten Anforderungen an die Mindest- und Höchst versionen für Ihre Gradle- und Android-Gradle-Plug-in-Version (AGP). 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 oder höher
Wir empfehlen, AGP 7.3 oder höher mit dem Driver SDK 6.0 zu verwenden.
Vollständiger R8-Modus
Das Driver SDK v6 und niedriger unterstützt den vollständigen R8-Modus nicht. Sie müssen den vollständigen R8-Modus 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 vorherigen Sprach versionen. Wenn Sie also bereits Kotlin 1.7 oder höher mit dem Driver SDK verwenden, sollten Sie ein Upgrade auf Kotlin 2.0 durchführen können, ohne alle Breaking Changes beheben zu müssen. Die Kotlin-Kompatibilität gilt jedoch nur für stabile Sprach funktionen. Wenn Sie Alpha-, Beta- oder Testfunktionen in der Kotlin-Sprache 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 Sie Breaking Changes begrenzen können:
Sprachversion X.Y
Dieses Flag setzt Breaking Changes auf das Verhalten einer vorherigen Kotlin-Version zurück.
Wenn Sie beispielsweise Kotlin 1.7 verwenden, können Sie [ -
language-version 1.7] angeben. Die neuen Breaking Changes werden dann nicht mehr angewendet:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
API-Version X.Y
Dieses Flag verhindert, dass neue APIs verwendet werden, bevor der abhängige Downstream-Code bereit ist, Kotlin 2.0 zu verwenden.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
Gezielterer Ansatz
Zusätzlich zur Verwendung von Kotlin-Kompatibilitäts-Flags empfehlen wir, die Versionshinweise zu Kotlin zu lesen und die Verhaltensweisen auszuwählen, die Sie aus der Version beibehalten möchten, von der Sie ein Upgrade durchführen. Kotlin bietet in den Kompatibilitätsleitfäden für jede Version eine Liste der Breaking Changes und der Flags, die festgelegt werden können, um das ursprüngliche Verhalten beizubehalten: