如何在Fragment中用新Menu Provider添加含SearchView的选项菜单？代码未生效

你当前的代码用了Fragment旧的菜单回调方法，而AndroidX已弃用这套方式，改用MenuProvider管理菜单，这就是菜单没加载的核心原因。下面是完整实现步骤：

1. 注册MenuProvider #

在Fragment的onViewCreated方法中，通过Activity注册MenuProvider，这是菜单能被加载的关键步骤：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    requireActivity().addMenuProvider(object : MenuProvider {
        override fun onCreateMenu(menu: Menu, menuInflater: MenuInflater) {
            // 加载菜单布局
            menuInflater.inflate(R.menu.explore, menu)
            
            // 初始化并配置SearchView
            val searchItem = menu.findItem(R.id.btn_search_menu)
            val searchView = searchItem.actionView as SearchView
            
            searchView.queryHint = "输入搜索内容"
            // 设置搜索提交监听
            searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
                override fun onQueryTextSubmit(query: String?): Boolean {
                    query?.let {
                        Log.d(TAG, "搜索提交内容: $it")
                    }
                    searchView.clearFocus() // 收起软键盘
                    return true
                }

                override fun onQueryTextChange(newText: String?): Boolean {
                    newText?.let {
                        Log.d(TAG, "实时搜索内容: $it")
                    }
                    return true
                }
            })
        }

        override fun onMenuItemSelected(menuItem: MenuItem): Boolean {
            return when (menuItem.itemId) {
                R.id.btn_search_menu -> {
                    // SearchView点击展开的逻辑无需额外处理，系统会自动完成
                    true
                }
                // 其他菜单选项的处理逻辑
                else -> false
            }
        }
    }, viewLifecycleOwner) // 绑定Fragment生命周期，避免内存泄漏
}

2. 检查菜单布局文件（res/menu/explore.xml） #

确保菜单项正确配置属性，否则SearchView可能无法正常显示：

<?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">
    <item
        android:id="@+id/btn_search_menu"
        android:title="搜索"
        android:icon="@drawable/ic_search"
        app:showAsAction="ifRoom|collapseActionView"
        app:actionViewClass="androidx.appcompat.widget.SearchView"/>
</menu>

• app:showAsAction="ifRoom|collapseActionView"：确保SearchView在空间充足时显示为图标，点击后展开搜索框
• app:actionViewClass：指定使用AndroidX兼容版SearchView，避免系统版本兼容问题

3. 额外注意事项 #

• 确保Activity使用支持ActionBar的主题（如Theme.MaterialComponents.DayNight.DarkActionBar），如果用自定义Toolbar，需在Activity中调用setSupportActionBar(toolbar)关联到ActionBar系统
• 不要再重写Fragment旧的onCreateMenu和onOptionsItemSelected方法，这些方法已被弃用，不会被系统调用
• 使用viewLifecycleOwner绑定MenuProvider生命周期，Fragment销毁时会自动移除，防止内存泄漏

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