Leitfaden zur Migration zum Android Driver SDK 6.0

Zur DriverStatusListener-Schnittstelle migrieren

In Driver v5 haben wir die Einstellung der StatusListener-Schnittstelle zugunsten von DriverStatusListener angekündigt. Dieses Jahr löschen wir die Schnittstelle StatusListener offiziell. StatusListenerWeitere Informationen zur Einstellung

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 Informationen, die Ihnen die Umstellung auf die neue Kotlin-Version erleichtern sollen.

Gradle- und AGP-Kompatibilität

Für Kotlin 2.0 gelten Mindest- und Höchstversionsanforderungen für Ihre Gradle- und Android-Gradle-Plug-in-Version (AGP). Ihr Projekt muss die folgenden Anforderungen für Kotlin 2.0 erfüllen.

AGP-Mindestversion für das Driver SDK 6.0+

Wir empfehlen die Verwendung von AGP 7.3+ mit dem Driver SDK 6.0.

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

Kotlin-Versionskompatibilität

Kotlin unterstützt die Abwärtskompatibilität mit drei vorherigen Sprachversionen. 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 funktionsgefährdenden Ä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-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 Upgraden bis zu drei vorherige Versionen der Sprache. Kotlin bietet zwei Flags, mit denen sich funktionsgefährdende Änderungen einschränken lassen:

Sprachversion X.Y

Mit diesem Flag werden funktionsgefährdende Änderungen am Verhalten einer vorherigen Kotlin-Version rückgängig gemacht. Wenn Sie beispielsweise Kotlin 1.7 verwenden, können Sie [ - language-version 1.7] angeben. Die neuen funktionsgefährdenden Änderungen werden dann nicht mehr wirksam:

android {
   kotlinOptions {
       languageVersion = '1.7'
   }
}
api-version X.Y

Dieses Flag verhindert, dass neue APIs verwendet werden, bevor der abhängige Downstream-Code für die Einbindung von Kotlin 2.0 bereit ist.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Ein gezielterer Ansatz

Zusätzlich zur Verwendung von Kotlin-Kompatibilitätsflags empfehlen wir, die Kotlin-Versionshinweise zu lesen und die Verhaltensweisen auszuwählen, die Sie aus der Version, von der Sie ein Upgrade durchführen, beibehalten möchten. Kotlin bietet eine Liste der Breaking Changes und der Flags, die festgelegt werden können, um das ursprüngliche Verhalten in den Kompatibilitätsleitfäden für jede Version beizubehalten: