Android Navigation Component含参包含图参数被忽略的解决方案求助

这个问题我之前在项目里也碰到过，确实是Navigation Component使用<include>拆分导航图时容易踩的一个小坑。下面给你两种可行的解决思路：

方法一：在主图的Action中显式声明参数 #

当你用<include>引入子图时，主导航图里的Action只是指向子图的ID，Navigation的代码生成器不会自动将子图的参数同步到主图的Action中。解决的核心就是在主图的Action标签里显式添加和子图一致的参数定义，这样生成的Directions类就会包含对应的参数了。

修改你的主导航图：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools">
    <fragment android:id="@+id/listFragment" android:name="com......ListFragment">
        <action android:id="@+id/view_detail" app:destination="@id/item_detail">
            <!-- 添加与子图匹配的参数 -->
            <argument android:name="item_id" app:argType="integer" />
        </action>
    </fragment>
    <include app:graph="@navigation/included_graph"/>
</navigation>

修改后重新编译项目，生成的ListFragmentDirections就会自动包含带参数的方法：

class ListFragmentDirections private constructor() {
    companion object {
        fun viewDetail(itemId: Int): NavDirections = ActionViewDetail(itemId)
    }
}

这样你就能安全地传递item_id参数，子图里的ItemDetailFragment也能正常接收。

方法二：使用嵌套导航图替代<include> #

如果你觉得<include>的参数同步不够直观，可以改用嵌套导航图的写法——直接在主图里用<navigation>标签定义子图，本质上和<include>的拆分效果一致，但参数关联的逻辑会更清晰。

调整后的主导航图：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools">
    <fragment android:id="@+id/listFragment" android:name="com......ListFragment">
        <action android:id="@+id/view_detail" app:destination="@id/item_detail_graph">
            <!-- 同样需要在这里声明参数 -->
            <argument android:name="item_id" app:argType="integer" />
        </action>
    </fragment>
    <!-- 嵌套子图 -->
    <navigation android:id="@+id/item_detail_graph" app:startDestination="@id/itemDetailFragment">
        <argument android:name="item_id" app:argType="integer" />
        <fragment android:id="@+id/itemDetailFragment" android:name="com......ItemDetailFragment">
            <argument android:name="item_id" app:argType="integer" />
        </fragment>
        [...]
    </navigation>
</navigation>

这种写法下，你依然需要在主图的Action中声明参数，但子图的定义和主图逻辑上更连贯，后续维护起来也更直观。

补充说明 #

之所以会出现这个问题，是因为Navigation的代码生成器是基于当前导航图内的Action和参数定义来生成Directions类的，它不会自动解析<include>引入的外部子图的参数。所以无论用<include>还是嵌套图，核心都是要在触发跳转的Action里显式声明需要传递的参数，这样生成器才能识别并生成带参数的导航方法。

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