Compose Destinations 嵌套导航实现指南

理解Compose Destinations的导航结构

Compose Destinations是一个强大的Jetpack Compose导航库，它通过注解处理器简化了导航逻辑。在v2版本中，嵌套导航的实现方式有了显著变化，开发者需要理解其核心概念才能正确实现。

导航图类型区分

Compose Destinations v2中定义了两种主要的导航图类型：

1. 根导航图：使用@NavHostGraph注解标记，作为整个导航结构的入口点
2. 嵌套导航图：使用@NavGraph<ParentGraph>注解标记，必须指定父导航图

这种明确的区分确保了导航结构的清晰性和可维护性。

实现单NavHost的嵌套导航

要实现单NavHost的嵌套导航结构，需要遵循以下步骤：

1. 定义根导航图

@NavHostGraph
annotation class RootGraph(
    val start: Boolean = true
)

根导航图必须使用@NavHostGraph注解，并且可以设置start参数来标记是否为起始导航图。

2. 定义嵌套导航图

@NavGraph<RootGraph>
annotation class MainGraph

嵌套导航图必须指定其父导航图，这里MainGraph是RootGraph的子图。

3. 在Composable中使用

@Composable
fun RootNavHost() {
    DestinationsNavHost(navGraph = RootGraph)
}

@Destination<MainGraph>
@Composable
fun MainScreen() {
    // 主屏幕内容
}

常见问题解决方案

类型不匹配错误

当遇到"navGraph参数类型不匹配"错误时，通常是因为：

1. 尝试将嵌套导航图(@NavGraph)传递给DestinationsNavHost
2. 没有正确定义导航图的层次结构

解决方案是确保只将根导航图(@NavHostGraph)传递给DestinationsNavHost。

多NavHost的使用场景

虽然官方推荐使用单NavHost，但在某些特定场景下可能需要多个NavHost：

1. 完全独立的导航流（如主应用和登录流程）
2. 需要保持各自导航状态的并行导航结构

在这些情况下，使用多NavHost是合理的解决方案。

最佳实践建议

1. 保持导航结构扁平化：尽量减少嵌套层级，通常2-3层足够
2. 明确导航边界：为不同的功能模块定义清晰的导航图
3. 合理使用参数：通过导航参数而非全局状态传递数据
4. 考虑后退栈行为：理解不同导航结构对后退行为的影响

通过遵循这些原则，可以构建出既清晰又高效的导航结构，充分利用Compose Destinations v2提供的功能。