Kotlin 版本兼容性和迁移

bookmark_border 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页介绍了 Navigation SDK 的 Kotlin 版本兼容性，以及迁移到较新版本的指南。

Navigation SDK Kotlin 版本要求

下表概述了 Navigation SDK 最新版本的 Kotlin 版本要求以及建议的 AGP 和 Gradle 版本。

Kotlin 版本兼容性

Kotlin 2.1 支持与 Kotlin 2.0 向后兼容。这意味着，如果您已将 Kotlin 2.0 与 Navigation SDK 搭配使用，则应该能够升级到 Kotlin 2.1，而无需解决所有破坏性更改。不过，这仅适用于稳定的语言功能。如果您使用的是 Kotlin 语言的 Alpha 版、Beta 版或实验性功能，则在升级时可能需要进行其他更改。

简化过渡：Kotlin 兼容性标志

Kotlin 提供了两个标志，可帮助限制破坏性更改： https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

此标志会将破坏性更改还原为之前 Kotlin 版本的行为。例如，如果您使用的是 Kotlin 2.0，则可以指定 [ - language-version 2.0]，这样新的破坏性更改将不再生效：

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

当使用 Kotlin 版本高于 apiVersion 的 API 时，此标志会抛出 Gradle build 错误。

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

更具针对性的方法

除了使用 Kotlin 兼容性标志之外，我们还建议您查看 Kotlin 版本说明，并选择要保留的行为（从升级的版本中保留）。Kotlin 在每个版本的兼容性指南中提供了一系列破坏性更改以及可设置为保留原始行为的标志：

• 1.9 兼容性指南
• 2.0 兼容性指南
• 2.1 兼容性指南

未来的 Kotlin 升级

Kotlin 每 6 个月发布一次新版本（即语言版本），Google 通常会在 1-2 个月后将最新版本纳入我们产品的默认版本。之前的 Kotlin 版本包含破坏性更改，这要求 Navigation SDK 客户升级到较新版本。因此，我们建议您在采用最新的 Navigation SDK 版本时，每 6 个月升级一次 Kotlin。