如何结合NavController使用MDC SearchBar实现返回导航？

问题回顾 #

使用MDC 1.9.0-rc01版本，需将SearchBar与NavController配合，实现未注册到AppBarConfiguration的Fragment中显示返回按钮并支持向上导航。此前尝试setupActionBarWithNavController或直接传入SearchBar到setupWithNavController均无效，已通过onDestinationChanged手动设置图标和点击事件临时解决，寻求官方推荐的正确配置方式。

正确配置步骤 #

1. 配置AppBarConfiguration并关联SearchBar与NavController #

AppBarConfiguration用于定义顶级目的地（无需显示向上按钮的页面），结合SearchBar的setupWithNavController方法，可自动管理导航图标状态：

// 获取NavController实例
NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment);

// 定义顶级目的地（示例为主Fragment的ID）
AppBarConfiguration appBarConfig = new AppBarConfiguration.Builder(R.id.main_fragment)
        .build();

// 关联SearchBar、NavController与AppBarConfiguration
searchBar.setupWithNavController(navController, appBarConfig);

2. 完善导航状态的自动更新（可选） #

若上述方法未自动切换导航图标，可通过NavController的目的地监听事件，规范处理图标显示逻辑：

navController.addOnDestinationChangedListener((controller, destination, arguments) -> {
    boolean isTopLevel = appBarConfig.getTopLevelDestinations().contains(destination.getId());
    // 顶级页面隐藏返回图标，显示搜索图标；二级页面反之
    if (isTopLevel) {
        searchBar.setNavigationIcon(null);
        searchBar.showSearchIcon(true);
    } else {
        searchBar.setNavigationIcon(R.drawable.ic_arrow_back);
        searchBar.showSearchIcon(false); // 可根据需求调整是否隐藏搜索图标
    }
});

3. 确保布局与主题配置正确 #

• 布局中需将SearchBar置于AppBarLayout内，保证样式与导航逻辑兼容：

<com.google.android.material.appbar.AppBarLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <com.google.android.material.search.SearchBar
        android:id="@+id/search_bar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:queryHint="搜索内容" />

</com.google.android.material.appbar.AppBarLayout>

• 确保应用主题继承自MaterialComponents系列主题（如Theme.MaterialComponents.DayNight.NoActionBar），避免样式冲突导致导航图标不显示。

关键说明 #

• setupWithNavController方法会自动处理向上导航的点击事件，无需手动设置setNavigationOnClickListener
• 若仍存在问题，可检查NavHostFragment的ID是否正确，以及AppBarConfiguration的顶级目的地是否准确

内容的提问来源于stack exchange，提问作者Iago Lourenço