Compose Destinations 中 ViewModel 的导航图作用域管理

理解导航图作用域的 ViewModel

在 Compose Destinations 项目中，开发者经常需要将 ViewModel 的作用域限定在特定的导航图中，以便在该导航图下的多个目的地之间共享状态。这种需求在模块化应用或复杂导航结构中尤为常见。

正确实现方式

最新版本的 Compose Destinations 提供了更优雅的解决方案：

@Composable
fun AppNavigation(activity: ComponentActivity) {
    val navController = rememberNavController()
    DestinationsNavHost(
        navController = navController,
        dependenciesContainerBuilder = {
            // 将 ViewModel 绑定到特定导航图
            navGraph(NavGraphs.settings) {
                val parentEntry = remember(navBackStackEntry) {
                    navController.getBackStackEntry(NavGraphs.settings.route)
                }
                dependency(hiltViewModel<SettingsViewModel>(parentEntry))
            }
            
            // 将 ViewModel 绑定到 Activity
            dependency(hiltViewModel<ActivityViewModel>(activity))
        }
    )
}

关键要点

1. 导航图识别：使用生成的 NavGraphs 类来引用特定导航图
2. 作用域获取：通过 navController.getBackStackEntry() 获取导航图的作用域
3. ViewModel 创建：使用 hiltViewModel() 在正确的作用域内创建 ViewModel

常见问题解决

1. 版本兼容性：确保使用最新版本的库（2.1.0及以上）
2. 作用域获取时机：使用 remember 确保只获取一次导航图作用域
3. Hilt 集成：正确配置 Hilt 以支持导航图作用域的 ViewModel

最佳实践

• 对于全局状态，考虑使用 Activity 作用域的 ViewModel
• 对于模块化导航，使用导航图作用域的 ViewModel
• 避免直接操作 navController，使用库提供的封装方法

通过这种方式，开发者可以确保 ViewModel 的生命周期与导航图保持一致，同时在不同目的地间安全地共享状态。