Android Driver SDK 6.0 迁移指南

迁移到 DriverStatusListener 接口

在驱动程序 v5 中，我们宣布弃用 StatusListener 接口，改用 DriverStatusListener。今年，我们将正式删除 StatusListener 接口。如需了解迁移到新接口的指南，请参阅StatusListener弃用。

迁移到 Kotlin 2.0

如果您使用的是适用于 Android 6.0 及更高版本的 Driver SDK，则必须升级到 Kotlin 2.0。本页提供了相关指南，可帮助您轻松过渡到新的 Kotlin 版本。

Gradle 和 AGP 兼容性

Kotlin 2.0 对 Gradle 和 Android Gradle 插件 (AGP) 版本的最低版本和最高版本有要求。确保您的项目满足 Kotlin 2.0 的这些要求。

Driver SDK 6.0 及更高版本的 AGP 最低版本

建议使用 AGP 7.3 及更高版本搭配 Driver SDK 6.0。

完整 R8 模式

Driver SDK v6 及更低版本不支持完整 R8 模式。如果您的应用以 AGP 8.0 及更高版本为目标平台，则必须明确停用完整 R8 模式。

# settings.gradle
android.enableR8.fullMode=false

Kotlin 版本兼容性

Kotlin 支持与之前三个语言版本的向后兼容性。这意味着，如果您已将 Kotlin 1.7 及更高版本与 Driver SDK 搭配使用，则应该能够升级到 Kotlin 2.0，而无需解决所有重大变更。不过，Kotlin 兼容性仅适用于稳定的语言功能。如果您在 Kotlin 语言中使用的是 Alpha 版、Beta 版或实验性功能，那么在升级时可能需要进行其他更改。

Kotlin 兼容性标志

如上一部分所述，升级时，Kotlin 最多支持该语言的 3 个先前版本。Kotlin 提供了两个标志来帮助限制重大变更：

language-version X.Y

此标志可将行为还原为之前的 Kotlin 版本，从而避免重大变更。 例如，如果您使用的是 Kotlin 1.7，则可以指定 [ - language-version 1.7]，这样新的重大变更将不再生效：

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

此标志可防止在依赖的下游代码准备好纳入 Kotlin 2.0 之前使用新的 API。

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

更具针对性的方法

除了使用 Kotlin 兼容性标志之外，我们还建议您查看 Kotlin 版本说明，并选择您希望从升级前的版本中保留的行为。Kotlin 在每个版本的兼容性指南中提供了一份重大变更列表，以及可用于保留原始行为的标志：