如何在Java中使用FragmentContainerView？替换原有代码的方法

问题场景 #

原布局使用<fragment>作为Navigation组件的宿主容器：

<fragment
    android:id="@+id/main"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_marginTop="5dp"
    android:paddingTop="5dp"
    app:defaultNavHost="true"
    app:layout_constraintBottom_toTopOf="@+id/bottomNavigation"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/adView"
    app:navGraph="@navigation/main" />

MainActivity中通过FragmentTransaction替换容器内Fragment：

FragmentManager fragmentManager = getSupportFragmentManager();
FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
fragmentTransaction.replace(R.id.main, explorefragment);
fragmentTransaction.commit();

收到提示要求：

Replace the tag with FragmentContainerView.

修改方案 #

1. 先更新布局文件 #

将<fragment>标签替换为FragmentContainerView，保留原有属性：

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/main"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_marginTop="5dp"
    android:paddingTop="5dp"
    app:defaultNavHost="true"
    app:layout_constraintBottom_toTopOf="@+id/bottomNavigation"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/adView"
    app:navGraph="@navigation/main" />

2. 调整MainActivity中的代码 #

使用FragmentContainerView作为NavHost容器时，R.id.main对应的是NavHostFragment本身，而非内部显示的Fragment，因此不能直接用原代码替换。需按以下两种方式修改：

方式一：遵循Navigation组件规范（推荐）

使用NavController管理页面跳转，需确保explorefragment已在导航图@navigation/main中定义：

NavController navController = Navigation.findNavController(this, R.id.main);
// 跳转到explorefragment对应的目的地ID
navController.navigate(R.id.explorefragment);

方式二：手动操作子FragmentManager

如果必须通过FragmentTransaction修改，需获取NavHostFragment的子FragmentManager：

// 获取NavHostFragment实例
NavHostFragment navHostFragment = (NavHostFragment) getSupportFragmentManager().findFragmentById(R.id.main);
// 使用NavHost的子FragmentManager进行操作
FragmentManager childFragmentManager = navHostFragment.getChildFragmentManager();
FragmentTransaction fragmentTransaction = childFragmentManager.beginTransaction();
fragmentTransaction.replace(R.id.main, explorefragment);
fragmentTransaction.commit();

关键说明 #

• FragmentContainerView作为NavHost容器时，getSupportFragmentManager().findFragmentById(R.id.main)返回的是NavHostFragment，而非当前显示的内容Fragment，必须通过getChildFragmentManager()操作内部Fragment。
• 优先使用Navigation组件自带的NavController进行页面切换，能自动处理回退栈、生命周期等问题，避免手动管理FragmentTransaction带来的异常。

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