如何在Hilt Navigation Compose中使用Navigation Compose新特性？

• 对齐依赖版本
  Hilt Navigation Compose 1.2.0默认依赖的Navigation Compose版本可能低于2.8.0，会导致新特性无法正常使用。你需要在Module级的build.gradle中明确指定Navigation Compose的版本，统一所有Navigation相关依赖到2.8.0或更高：

  dependencies {
      implementation "androidx.navigation:navigation-compose:2.8.0"
      implementation "androidx.hilt:hilt-navigation-compose:1.2.0"
      // 其他Hilt相关依赖保持对应兼容版本即可
  }
  

  也可以用Gradle版本统一管理（比如libs.versions.toml），彻底避免版本冲突。

• 按新方式使用类型安全导航
  Navigation Compose 2.8.0的类型安全特性依赖配置Safe Args生成的路由类，配合Hilt的话，在NavHost中可以这样写：

  NavHost(navController = navController, startDestination = HomeScreen.route) {
      composable(HomeScreen.route) {
          val viewModel = hiltViewModel<HomeViewModel>()
          HomeScreen(viewModel, onNavigateToDetail = { itemId ->
              // 使用类型安全的导航方法，无需拼接字符串路由
              navController.navigate(DetailScreen.createRoute(itemId))
          })
      }
      composable(DetailScreen.route) { backStackEntry ->
          // 安全解析参数，无需手动处理arguments
          val itemId = DetailScreen.fromRoute(backStackEntry)
          val viewModel = hiltViewModel<DetailViewModel>()
          DetailScreen(viewModel, itemId)
      }
  }
  

• 解决navigateBack()报错的问题
  navigateBack()是Navigation Compose 2.7.0+新增的扩展函数，确认依赖版本无误后，按以下步骤排查：

  1. 同步Gradle：点击File -> Sync Project with Gradle Files
  2. 清理重建项目：先执行Build -> Clean Project，再执行Build -> Rebuild Project
  3. 确保你的navController是NavHostController类型，而非旧的导航控制器类

• 清除Android Studio缓存
  如果遇到自动补全异常，大概率是AS缓存导致的，直接清理缓存重启：File -> Invalidate Caches... -> Invalidate and Restart

内容的提问来源于stack exchange，提问作者The One