Android BottomNavigationView图标选中状态与可见Fragment同步问题

在我的Android（Java）应用中，BottomNavigationView的图标选中颜色无法准确匹配当前可见的Fragment。点击底部导航图标时，图标会变为选中状态并跳转到对应Fragment，但点击返回箭头回到主页时，之前点击的图标仍保持选中状态，而非主页图标。如何让选中图标始终与当前可见Fragment一致？

提供的代码 #

布局文件（NavigationActivity） #

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/background"
    tools:context=".activity.NavigationActivity">

    <androidx.appcompat.widget.Toolbar
        android:id="@+id/toolbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:theme="@style/ThemeOverlay.MaterialComponents.Dark.ActionBar" />


    <ImageView
        android:id="@+id/backArrow"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="20dp"
        android:layout_marginTop="54dp"
        android:layout_marginBottom="20dp"
        android:src="@drawable/arrow_left"
        android:visibility="gone" />

    <ImageView
        android:id="@+id/logo"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginStart="98dp"
        android:layout_marginTop="46dp"
        android:layout_marginBottom="20dp"
        android:layout_toEndOf="@+id/backArrow"
        android:src="@drawable/logo" />


    <fragment
        android:id="@+id/fragment"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_above="@id/bottomBar"
        android:layout_below="@+id/logo"
        app:defaultNavHost="true"
        app:navGraph="@navigation/nav_graph" />

    <com.google.android.material.bottomnavigation.BottomNavigationView
        android:id="@+id/bottomBar"
        style="@style/BottomNavTheme"
        android:layout_width="match_parent"
        android:layout_height="70dp"
        android:layout_alignParentBottom="true"
        android:paddingTop="7dp"
        android:paddingBottom="7dp"
        android:theme="@style/app_theme"
        app:itemIconTint="@drawable/bottom_nav_icon_color_selector"
        app:itemTextColor="@drawable/bottom_nav_icon_color_selector"
        app:menu="@menu/bottom_bar_nav" />
</RelativeLayout>

导航图标颜色选择器 #

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_checked="true" android:color="@android:color/white" />
    <item android:state_pressed="true" android:state_enabled="true" android:color="@android:color/white" />
    <item android:color="#8E8392" />
</selector> 

原NavigationActivity代码 #

@AndroidEntryPoint
public class NavigationActivity extends DeviceBaseActivity {
    NavController navController;
    private AppBarConfiguration appBarConfiguration;

    private ActivityNavigationBinding navigationBinding;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        getWindow().getDecorView().setSystemUiVisibility(
                View.SYSTEM_UI_FLAG_LAYOUT_STABLE);
        navigationBinding = ActivityNavigationBinding.inflate(getLayoutInflater());
        View view = navigationBinding.getRoot();
        setContentView(view);

        Toolbar toolbar = findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        navController = Navigation.findNavController(NavigationActivity.this, R.id.fragment);

        appBarConfiguration =
                new AppBarConfiguration.Builder(navController.getGraph()).build();

        setupActionBar(navController, appBarConfiguration);
        

        navigationBinding.bottomBar.setOnItemSelectedListener(new NavigationBarView.OnItemSelectedListener() {
            @Override
            public boolean onNavigationItemSelected(@NonNull MenuItem item) {
                switch (item.getItemId()) {
                    case R.id.mainFragment:
                        navController.navigate(R.id.mainFragment);
                        return true;
                    case R.id.scheduleFragment:
                        navController.navigate(R.id.scheduleFragment);
                        return true;
                    case R.id.settingsFragment:
                        navController.navigate(R.id.settingsFragment);
                        return true;
                }
                return false;
            }
        });

    }
    


    private void setupActionBar(NavController navController,
                                AppBarConfiguration appBarConfig) {

        NavigationUI.setupActionBarWithNavController(this, navController, appBarConfig);

    }


    @Override
    public boolean onSupportNavigateUp() {
        return NavigationUI.navigateUp(Navigation.findNavController(this, R.id.fragment), appBarConfiguration);
    }

}

解决方案 #

1. 替换自定义点击监听器为NavigationUI绑定方法 #

删除原代码中自定义的setOnItemSelectedListener，改用NavigationUI提供的setupWithNavController，自动同步导航栈与底部导航的选中状态：

NavigationUI.setupWithNavController(navigationBinding.bottomBar, navController);

2. 正确配置AppBarConfiguration的顶级目的地 #

原代码使用整个导航图构建AppBarConfiguration，需改为指定底部导航对应的顶级Fragment ID，确保返回逻辑和状态同步正确：

appBarConfiguration = new AppBarConfiguration.Builder(
        R.id.mainFragment, R.id.scheduleFragment, R.id.settingsFragment)
        .build();

3. 验证菜单与导航图ID一致性 #

确保bottom_bar_nav.xml中每个菜单项的android:id，与nav_graph.xml中对应Fragment的android:id完全一致，这是绑定生效的前提。

修改后的完整NavigationActivity代码 #

@AndroidEntryPoint
public class NavigationActivity extends DeviceBaseActivity {
    NavController navController;
    private AppBarConfiguration appBarConfiguration;

    private ActivityNavigationBinding navigationBinding;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        getWindow().getDecorView().setSystemUiVisibility(
                View.SYSTEM_UI_FLAG_LAYOUT_STABLE);
        navigationBinding = ActivityNavigationBinding.inflate(getLayoutInflater());
        View view = navigationBinding.getRoot();
        setContentView(view);

        Toolbar toolbar = findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        navController = Navigation.findNavController(NavigationActivity.this, R.id.fragment);

        // 配置底部导航对应的顶级目的地
        appBarConfiguration = new AppBarConfiguration.Builder(
                R.id.mainFragment, R.id.scheduleFragment, R.id.settingsFragment)
                .build();

        setupActionBar(navController, appBarConfiguration);
        
        // 绑定底部导航与导航控制器，自动同步选中状态
        NavigationUI.setupWithNavController(navigationBinding.bottomBar, navController);
    }
    

    private void setupActionBar(NavController navController,
                                AppBarConfiguration appBarConfig) {
        NavigationUI.setupActionBarWithNavController(this, navController, appBarConfig);
    }


    @Override
    public boolean onSupportNavigateUp() {
        return NavigationUI.navigateUp(Navigation.findNavController(this, R.id.fragment), appBarConfiguration);
    }
}

核心原理 #

• setupWithNavController会监听导航栈的所有变化，包括返回操作导致的Fragment切换，自动更新BottomNavigationView的选中项。
• 正确配置顶级目的地后，NavigationUI会在处于主页等顶级页面时隐藏返回箭头，非顶级页面时显示，同时保证返回后底部导航状态与当前Fragment完全匹配。

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