使用导航组件将参数安全地传递给嵌套图

Question

我正在使用 Android Jetpack 导航组件。我有一个带有 id 的嵌套导航图，比如说嵌套图R.id.nested_graph 的第一个Fragment接收一个参数。

<navigation
        android:id="@+id/nested_graph"
        android:label="Nested Graph"
        app:startDestination="@id/firstFragment">
        <fragment
            android:id="@+id/firstFragment"
            android:name="...."
            android:label="....">
            <argument
                android:name="item_id"
                app:argType="integer" />
        </fragment>
        [...]
    </navigation>

如何使用安全 args将参数传递给嵌套图？

目前，我需要在包中手动传递参数，使用直接接收嵌套图的 id 的 API：

        val args = Bundle()
        args.putInt("item_id", itemId)
        navController.navigate(R.id.nested_graph, args)

我想使用安全参数，并执行以下操作：

        val directions = OrigininFragmentDirections.nestedGraph(itemId)
        navController.navigate(directions)

但是在尝试时，我在构建时收到以下错误：

Too many arguments for public final fun nestedGraph(): NavDirections defined 

问题是导航图预处理正在生成工厂方法来创建没有签名中所需参数的NavDirections对象。

嵌套图的声明如下所示：

Answer 1

经过一些反复试验（我认为谷歌没有正式记录，或者至少我找不到它），我发现可以安全地导航到嵌套的导航图传递参数：

您需要argument在嵌套片段本身的根中添加第一个片段所需的XML 对象。

就我而言，带有 idfirstFragment的片段（嵌套图中的第一个片段）接收：

            <argument
                android:name="item_id"
                app:argType="integer" />

因此，我需要将该参数添加到嵌套图中：

<navigation
        android:id="@+id/nested_graph"
        android:label="Nested Graph"
        app:startDestination="@id/firstFragment">

            <argument
                android:name="item_id"
                app:argType="integer" />

        <fragment
            android:id="@+id/firstFragment"
            android:name="...."
            android:label="....">
            <argument
                android:name="item_id"
                app:argType="integer" />
        </fragment>
        [...]
    </navigation>

现在我可以导航到它：

   val directions = OrigininFragmentDirections.nestedGraph(itemId)
        navController.navigate(directions)

请注意，导航图编辑器不会为您执行此操作。这需要在 XML 代码中手动完成。

Answer 2

@GaRRaPeTa 答案几乎是正确的，但如果您使用 SafeArgs 通过操作从主图导航到嵌套图，则还必须向该操作添加一个参数：

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/graph_main"
    app:startDestination="@id/mainFragment">

    <fragment
        android:id="@+id/mainFragment"
        android:name="com.example.MainFragment">

        <action
            android:id="@+id/toNestedGraph"
            app:destination="@id/graph_nested">

            <argument
                android:name="arg_name"
                app:argType="string" />
        </action>
    </fragment>

</navigation>