Jetpack Compose Navigation - 将参数传递给 startDestination

Question

我正在构建的应用程序使用带有路线的组合导航。挑战在于起点是动态的。

这是一个最小的例子：

class MainActivity : ComponentActivity()
{
    override fun onCreate(savedInstanceState: Bundle?)
    {
        super.onCreate(savedInstanceState)

        setContent {
            val navController = rememberNavController()

            NavHost(
                navController = navController,
                startDestination = "dynamic/1", // doesn't work
                // startDestination = "static", // workaround
            ) {
                composable(
                    route = "dynamic/{$ARG_ID}",
                    arguments = listOf(navArgument(ARG_ID) { type = NavType.StringType }),
                ) {
                    val id = it.arguments?.getString(ARG_ID)
                    Text("dynamic route, received argument: $id!")
                }
                // part of the workaround
                // composable(
                //  route = "static",
                // ) {
                //  LaunchedEffect(this) {
                //      navController.navigate("dynamic/1")
                //  }
                // }
            }
        }
    }

    companion object
    {
        const val ARG_ID = "id"
    }
}

应用程序崩溃

java.lang.IllegalArgumentException: navigation destination route/1 is not a direct child of this NavGraph

仅当“动态”路由用作起始目的地时才会存在问题。这可以通过使用startDestination = "static" 来验证。

虽然，“静态”路由解决方法有效，但我正在寻找没有它的解决方案，因为它会混淆代码并在后台堆栈中创建一个额外的条目。

-> Full code sample 重现问题

相关的 SO 问题

• Navigation Architecture Component- Passing argument data to the startDestination - 答案似乎不适用于撰写导航。
• Pass an argument to a nested navigation graph in Jetpack Compose - 没有给出答案。
• Compose Navigation - navigation destination ... is not a direct child of this NavGraph - 接受的答案不能解决问题。

编辑：

我想强调的是，原始样本过去不包含“静态”可组合。我只添加了“静态”可组合项以使 startDestination 正常工作并证明“动态”可组合项可以导航到。

更新：

即使切换到query parameter syntax for optional arguments，提供默认值，不带任何参数设置起始目的地也不起作用。

以下变化

NavHost(
    navController = navController,
    startDestination = "dynamic",
) {
    composable(
        route = "dynamic?$ARG_ID={$ARG_ID}",
        arguments = listOf(navArgument(ARG_ID) { type = NavType.StringType; defaultValue = "1" }),
    ) {
        val id = it.arguments?.getString(ARG_ID)
        Text("dynamic route, received argument: $id!")
    }
}

导致异常

java.lang.IllegalArgumentException: navigation destination dynamic is not a direct child of this NavGraph

Answer 1

完全归功于ianhanniballake，他在评论中向我解释了解决方案。我将在这里展示我的代码示例的工作版本。

对我来说最大的见解是：

startDestination 不能匹配模式匹配意义上的可组合route，但它必须是完全相同的字符串。

这意味着不能直接通过startDestination 设置参数，而必须通过参数的defaultValue 设置。

这是工作示例：

class MainActivity : ComponentActivity()
{
    override fun onCreate(savedInstanceState: Bundle?)
    {
        super.onCreate(savedInstanceState)

        setContent {
            val navController = rememberNavController()

            NavHost(
                navController = navController,
                // 1st change: Set startDestination to the exact string of route
                startDestination = "dynamic/{$ARG_ID}", // NOT "dynamic/1", provide arguments via defaultValue
            ) {
                composable(
                    route = "dynamic/{$ARG_ID}",
                    // 2nd change: Set startDestination argument via defaultValue
                    arguments = listOf(navArgument(ARG_ID) { type = NavType.StringType; defaultValue = "1" }),
                ) {
                    val id = it.arguments?.getString(ARG_ID)
                    Text("dynamic route, received argument: $id!")
                }
            }
        }
    }

    companion object
    {
        const val ARG_ID = "id"
    }
}

该方法同样适用于以查询参数形式提供的参数。

老实说，我认为这是一个小限制，因为现在开始路线决定了必须是 defaultValue。我可能想设置一个不同的defaultValue 或根本没有。然而，在大多数情况下，这应该是最优雅的解决方案。