Jetpack Navigation 3 已是稳定版

Jetpack Navigation 3 版本 1.0 已是稳定版 🎉。欢迎立即在生产应用中使用。JetBrains 已在其 KotlinConf 应用中使用该版本。

Navigation 3 是一个全新的导航库，从头开始构建，旨在支持 Jetpack Compose 状态。它让您可以完全控制返回堆栈，帮助您保留导航状态，并让您轻松创建自适应布局（如列表详情）。JetBrains 甚至还推出了跨平台版本。

为什么要推出新库？

原始 Jetpack Navigation 库（现为 Nav2）是 7 年前设计的。虽然它很好地实现了最初的目标，并且经过了迭代改进，但现在构建应用的方式已发生了根本性变化。

使用声明式界面进行响应式编程现在已成为常态。Nav3 采用了这种方法。例如，NavDisplay（显示屏幕的 Nav3 界面组件）只是观察由 Compose 状态支持的键列表（每个键代表一个屏幕），并在该列表发生变化时更新其界面。

Nav2 也有自己的内部状态，因此很难为导航状态提供单一可靠来源。借助 Nav3，您可以提供自己的状态，从而获得完全控制权。

最后，您要求提供更高的灵活性和可自定义性。Nav3 没有采用单一的整体式 API，而是提供了更小、解耦的 API（或“构建块”），这些 API 可以组合在一起以创建复杂的功能。Nav3 本身也使用这些构建块为明确定义的导航用例提供合理的默认值。

这种方法让您可以：

如需详细了解其设计和功能，请参阅发布博文。

从 Navigation 2 迁移

如果您已在使用 Nav2（尤其是 Navigation Compose），则应考虑迁移到 Nav3。为了帮助您完成此操作，我们提供了迁移指南。主要步骤如下：

添加 Navigation 3 依赖项。
更新导航路线以实现 NavKey。您的路线不必实现此接口即可使用 Nav3，但如果实现，则可以利用 Nav3 的 rememberNavBackStack 函数创建持久性返回堆栈。
创建用于保存和修改导航状态的类 - 这是保存返回堆栈的位置。
将 NavController 替换为这些类。
将目的地从 NavHost 的 NavGraph 移到 entryProvider 中。
将 NavHost 替换为 NavDisplay。

试用 AI 智能体迁移

您可能想尝试使用 AI 智能体来阅读迁移指南，并在您的项目中执行这些步骤。如需在 Android Studio 的代理模式下使用 Gemini 尝试此操作，请执行以下操作：

与往常一样，请务必仔细检查 AI 智能体所做的更改，因为 AI 智能体可能会犯错！

我们很想了解您或您的代理的表现，请点击此处发送反馈。

常见场景的实用导航配方

对于常见但细致的用例，我们提供了一个配方代码库。该代码库展示了如何以特定方式组合 Nav3 API，让您可以根据自己的特定需求选择或修改配方。如果某个配方很受欢迎，我们会考虑将其非细致部分“升级”到核心 Nav3 库或附加库。

目前有 19 个配方，包括：

我们目前正在开发一个深层链接配方和一个Koin 集成，并计划推出更多配方。JetBrains 的一位工程师还发布了配方的 Compose Multiplatform 版本。

如果您有希望看到配方的常见用例，请提交配方请求。

摘要

如需开始使用 Nav3，请查看文档和配方。此外，请留意为期一周的技术内容，包括：

Nav3 Spotlight Week 将于 2025 年 12 月 1 日开始。

与往常一样，如果您发现任何问题，请点击此处提交。

继续阅读