如何为Navigation架构下Fragment的Toolbar添加按钮？

我想要在下图所示的位置添加按钮：

该底部导航菜单在navigation/mobile_navigation.xml中声明：

<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"
    android:id="@+id/mobile_navigation"
    app:startDestination="@+id/navigation_home">

    <fragment
        android:id="@+id/navigation_home"
        android:name=".ui.home.HomeFragment"
        android:label="@string/title_home"
        tools:layout="@layout/fragment_home" />

    <fragment
        android:id="@+id/navigation_dashboard"
        android:name=".ui.dashboard.DashboardFragment"
        android:label="@string/title_dashboard"
        tools:layout="@layout/fragment_dashboard" />

    <fragment
        android:id="@+id/navigation_notifications"
        android:name=".ui.notifications.NotificationsFragment"
        android:label="@string/title_notifications"
        tools:layout="@layout/fragment_notifications" />
</navigation>

在主布局中通过NavHostFragment使用该导航图：

<fragment
    android:id="@+id/nav_host_fragment_activity_main"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:defaultNavHost="true"
    app:layout_constraintBottom_toTopOf="@id/nav_view"
    app:layout_constraintLeft_toLeftOf="parent"
    app:layout_constraintRight_toRightOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    app:navGraph="@navigation/mobile_navigation" />

这是谷歌提供的默认示例项目，我尝试直接在<fragment>标签里添加内容但没效果，找到的视频教程都太老，也没覆盖Fragment相关场景。现在的问题是，顶部显示标题的Toolbar不是我直接管理的，请问怎么给当前Fragment对应的Toolbar添加按钮？

在Navigation组件的默认架构中，Toolbar通常由宿主Activity管理，但你可以通过以下步骤在Fragment中控制Toolbar的菜单按钮：

1. 绑定Activity的Toolbar与NavController #

先确认主Activity（如MainActivity）已将Toolbar和NavController关联，确保Navigation能自动同步Fragment标题：

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment_activity_main) as NavHostFragment
        val navController = navHostFragment.navController
        
        // 绑定Toolbar到NavController
        val toolbar = findViewById<Toolbar>(R.id.toolbar)
        setSupportActionBar(toolbar)
        setupActionBarWithNavController(navController)
    }

    // 处理返回按钮逻辑
    override fun onSupportNavigateUp(): Boolean {
        val navController = findNavController(R.id.nav_host_fragment_activity_main)
        return navController.navigateUp() || super.onSupportNavigateUp()
    }
}

2. 创建Fragment专属菜单资源 #

在res/menu目录下新建菜单文件，比如menu_home_fragment.xml：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <!-- 定义你需要的Toolbar按钮 -->
    <item
        android:id="@+id/action_settings"
        android:icon="@drawable/ic_settings"
        android:title="@string/action_settings"
        app:showAsAction="ifRoom" />
</menu>

3. 在Fragment中加载并处理菜单 #

在目标Fragment（如HomeFragment）中重写菜单相关方法，获取菜单控制权：

class HomeFragment : Fragment() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 声明Fragment参与Toolbar菜单的创建
        setHasOptionsMenu(true)
    }

    override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
        // 加载当前Fragment的菜单资源
        inflater.inflate(R.menu.menu_home_fragment, menu)
        super.onCreateOptionsMenu(menu, inflater)
    }

    override fun onOptionsItemSelected(item: MenuItem): Boolean {
        // 处理按钮点击事件
        return when (item.itemId) {
            R.id.action_settings -> {
                Toast.makeText(context, "设置按钮被点击", Toast.LENGTH_SHORT).show()
                true
            }
            else -> super.onOptionsItemSelected(item)
        }
    }
}

4. 多Fragment的菜单切换 #

如果不同Fragment需要显示不同的Toolbar按钮，只需在对应Fragment中重复步骤2和3即可。Navigation组件会在Fragment切换时自动刷新Toolbar的菜单内容。

关键说明 #

• 导航图的<fragment>标签仅负责页面路由配置，无法直接添加视图元素，所以直接修改该标签不会生效。
• 通过setHasOptionsMenu(true)让Fragment获得菜单控制权，Activity的Toolbar会自动合并并显示Fragment提供的菜单。

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