Android Studio Kotlin中BottomAppBar切换Fragment失效求助

问题描述 #

在activity_main.xml中通过BottomAppBar加载多个Fragment，导航项ID为bottom_home、bottom_message等，但OnNavigationItemSelectedListener及R.id.bottom_xxx系列ID无法正常工作，导致Fragment无法加载。相关MainActivity代码如下：

class MainActivity : AppCompatActivity() {
    private val onNavigationItemSelectedListener =
        BottomAppBar.OnNavigationItemSelectedListener { item ->
            when (item.itemId) {
                R.id.bottom_home -> {
                    replaceFragment(HomeFragment())
                    return@OnNavigationItemSelectedListener true
                }
                R.id.bottom_message -> {
                    replaceFragment(MessageFragment())
                    return@OnNavigationItemSelectedListener true
                }
                R.id.bottom_shelf -> {
                    replaceFragment(ShelfFragment())
                    return@OnNavigationItemSelectedListener true
                }
                R.id.bottom_account -> {
                    replaceFragment(AccountFragment())
                    return@OnNavigationItemSelectedListener true
                }
                else -> false
            }
        }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val navView: BottomAppBar = findViewById(R.id.BottomAppBar)
        navView.setOnNavigationItemSelectedListener(onNavigationItemSelectedListener)

        // Set the initial fragment
        if (savedInstanceState == null) {
            replaceFragment(HomeFragment())
        }
    }

    private fun replaceFragment(fragment: Fragment) {
        supportFragmentManager.beginTransaction()
            .replace(R.id.fragmentContainer, fragment)
            .commit()
    }
}

排查与修复步骤 #

1. 验证菜单ID与XML配置的一致性 #

• 确保BottomAppBar绑定的menu文件中，每个导航项的android:id和代码中使用的R.id.bottom_xxx完全一致，Android资源ID大小写敏感，不能有拼写错误。
• 示例menu文件（如res/menu/menu_bottom_app_bar.xml）的正确写法：

<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/bottom_home"
        android:icon="@drawable/ic_home"
        android:title="首页"/>
    <item
        android:id="@+id/bottom_message"
        android:icon="@drawable/ic_message"
        android:title="消息"/>
    <item
        android:id="@+id/bottom_shelf"
        android:icon="@drawable/ic_shelf"
        android:title="书架"/>
    <item
        android:id="@+id/bottom_account"
        android:icon="@drawable/ic_account"
        android:title="我的"/>
</menu>

• 同时确认activity_main.xml中BottomAppBar正确引用该menu：

<com.google.android.material.bottomappbar.BottomAppBar
    android:id="@+id/BottomAppBar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_gravity="bottom"
    app:menu="@menu/menu_bottom_app_bar"/>

2. 检查Fragment容器ID的正确性 #

• 确认activity_main.xml中存在ID为fragmentContainer的布局容器，比如FrameLayout：

<FrameLayout
    android:id="@+id/fragmentContainer"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_above="@id/BottomAppBar"/>

• 如果容器ID不匹配，replaceFragment方法无法找到目标容器，Fragment自然无法加载。

3. 替换废弃的监听方法 #

• 若使用Material Components 1.4.0+版本，setOnNavigationItemSelectedListener已被废弃，兼容性存在问题，建议使用setOnItemSelectedListener替代：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val navView: BottomAppBar = findViewById(R.id.BottomAppBar)
    // 替换为新的监听方法
    navView.setOnItemSelectedListener { item ->
        when (item.itemId) {
            R.id.bottom_home -> {
                replaceFragment(HomeFragment())
                true
            }
            R.id.bottom_message -> {
                replaceFragment(MessageFragment())
                true
            }
            R.id.bottom_shelf -> {
                replaceFragment(ShelfFragment())
                true
            }
            R.id.bottom_account -> {
                replaceFragment(AccountFragment())
                true
            }
            else -> false
        }
    }

    if (savedInstanceState == null) {
        replaceFragment(HomeFragment())
    }
}

4. 优化Fragment切换逻辑（可选） #

• 每次切换都创建新Fragment实例会浪费资源，建议缓存实例避免重复创建：

class MainActivity : AppCompatActivity() {
    // 缓存Fragment实例
    private val homeFragment = HomeFragment()
    private val messageFragment = MessageFragment()
    private val shelfFragment = ShelfFragment()
    private val accountFragment = AccountFragment()
    private var currentFragment: Fragment = homeFragment

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val navView: BottomAppBar = findViewById(R.id.BottomAppBar)
        navView.setOnItemSelectedListener { item ->
            when (item.itemId) {
                R.id.bottom_home -> {
                    replaceFragment(homeFragment)
                    true
                }
                R.id.bottom_message -> {
                    replaceFragment(messageFragment)
                    true
                }
                R.id.bottom_shelf -> {
                    replaceFragment(shelfFragment)
                    true
                }
                R.id.bottom_account -> {
                    replaceFragment(accountFragment)
                    true
                }
                else -> false
            }
        }

        if (savedInstanceState == null) {
            replaceFragment(homeFragment)
        }
    }

    private fun replaceFragment(fragment: Fragment) {
        if (currentFragment == fragment) return
        supportFragmentManager.beginTransaction()
            .replace(R.id.fragmentContainer, fragment)
            .commit()
        currentFragment = fragment
    }
}

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