🧭 路由定义 · 字符串 · 占位符 · 常量管理

📌 1. 字符串路由定义

在 Compose Navigation 中，路由本质上是 字符串标识。每个屏幕对应一个唯一路径，支持静态与动态片段。

🔖 2. 路由参数占位符

// 导航路由定义 (NavHost)
composable(
    route = "article/{articleId}",
    arguments = listOf(
        navArgument("articleId") { 
            type = NavType.StringType 
            defaultValue = "0"
        }
    )
) { backStackEntry ->
    val articleId = backStackEntry.arguments?.getString("articleId") ?: "0"
    // 渲染 ArticleScreen(articleId)
}

🧩 3. 路由常量管理最佳实践 · 架构图

✅ 4. 路由常量管理最佳实践

• 集中管理 —— 使用 object RouteConstants 存放所有路由字符串，避免硬编码散落各处。
• 参数Key常量 —— 定义 object ArgKey 统一参数名，防止拼写错误。
• 模板函数 —— 提供扩展函数或顶层函数生成带参数的路由，例如 fun articleDetailRoute(id: String) = "article/$id"。
• 类型安全 —— 利用 NavType 声明参数类型，并设置默认值处理缺失情况。
• 命名规范 —— 路由使用小写 + 斜杠层级，参数占位符使用驼峰，如 user/{userId}/profile。
• 避免魔法字符串 —— 所有导航调用均引用常量，便于重构与维护。

📦 代码示例 · 路由常量 + 参数占位符

// ===== RouteConstants.kt =====
object RouteConstants {
    const val HOME = "home"
    const val ARTICLE_DETAIL = "article/{articleId}"
    const val PROFILE = "profile/{userId}"
    const val SEARCH = "search?query={query}"
}

object ArgKey {
    const val ARTICLE_ID = "articleId"
    const val USER_ID = "userId"
    const val QUERY = "query"
}

// 路由模板函数 —— 构建完整路径
fun NavGraphBuilder.articleDetailScreen(
    onBack: () -> Unit
) {
    composable(
        route = RouteConstants.ARTICLE_DETAIL,
        arguments = listOf(
            navArgument(ArgKey.ARTICLE_ID) {
                type = NavType.StringType
                defaultValue = "0"
            }
        )
    ) { entry ->
        val articleId = entry.arguments?.getString(ArgKey.ARTICLE_ID) ?: "0"
        ArticleDetailScreen(articleId = articleId, onBack = onBack)
    }
}

// 使用常量导航
navController.navigate("article/42")   // 直接字符串
navController.navigate(RouteConstants.HOME)  // 推荐：引用常量