Navigation 3

Android skills

在 GitHub 上查看

Jetpack Navigation 3

使用 Android 技能，帮助您使用 Jetpack Navigation 3 进行构建。

如需从 Android CLI 安装技能，请运行以下命令：

android skills add navigation-3

Navigation 3 是一个专为与 Compose 搭配使用而设计的导航库。借助 Navigation 3，您可以完全控制返回堆栈，并通过在列表中添加和移除项来在目的地之间导航。它通过提供以下内容来创建灵活的应用导航系统：

• 用于对返回堆栈进行建模的惯例，其中返回堆栈上的每个条目都表示用户已导航到的内容
• 一个会随着返回堆栈更改（包括动画）而自动更新的界面
• 返回堆栈中各项的作用域，允许在项位于返回堆栈中时保留状态
• 一种自适应布局系统，可同时显示多个目的地，并支持在这些布局之间无缝切换
• 内容与其父布局进行通信的机制（元数据）
• 在屏幕之间进行目的地间通信以返回结果

概括来讲，您可以通过以下方式实现 Navigation 3：

1. 定义用户可在应用中导航到的内容，每个内容都有一个唯一键，并添加一个函数来将该键解析为内容。请参阅将键解析为内容。
2. 创建一个返回堆栈，当用户在应用中导航时，键会被推送到该堆栈中并从中移除。请参阅创建返回堆栈。
3. 使用 NavDisplay 显示应用的返回堆栈。每当返回堆栈发生变化时，它都会更新界面以显示相关内容。请参阅显示返回堆栈。
4. 根据需要修改 NavDisplay 的场景策略，以支持自适应布局和不同平台。
5. 支持深层链接，可直接导航到目的地。

您可以在 AOSP 上查看 Navigation 3 的完整源代码。

Jetpack Navigation 的改进

Navigation 3 在以下方面对原始 Jetpack Navigation API 进行了改进：

• 提供与 Compose 的更简单集成
• 让您能够完全控制返回堆栈
• 可以创建能够同时从返回堆栈中读取多个目的地的布局，从而使其能够适应窗口大小和其他输入的变化。

如需详细了解 Navigation 3 的原则和 API 设计选择，请参阅公告博文。

代码示例

recipes 代码库包含一些示例，展示了如何使用 Navigation 3 构建块来解决常见的导航难题。