Fragment 管理器

FragmentManager 类负责在应用的 fragment 上执行一些操作，如添加、移除或替换操作，以及将操作添加到返回堆栈。

如果您使用的是 Jetpack Navigation 库，则您可能永远都不会与 FragmentManager 直接进行交互，因为该库会代表您来使用 FragmentManager。不过，任何使用 fragment 的应用都在某种程度上使用了 FragmentManager，因此您需要了解它是什么以及如何工作。

本页将介绍以下内容：

• 如何访问 FragmentManager。
• FragmentManager 与 activity 和 fragment 相关的角色。
• 如何使用 FragmentManager 管理返回堆栈。
• 如何为 fragment 提供数据和依赖项。

访问 FragmentManager

您可以从 activity 或 fragment 访问 FragmentManager。

FragmentActivity 及其子类（如 AppCompatActivity）都可以通过 getSupportFragmentManager() 方法访问 FragmentManager。

fragment 可以托管一个或多个子 fragment。在 fragment 内，您可以通过 getChildFragmentManager() 获取对管理 fragment 子级的 FragmentManager 的引用。如果您需要访问其宿主 FragmentManager，可以使用 getParentFragmentManager()。

下面几个示例展示了 fragment、其宿主以及与每个 fragment 关联的 FragmentManager 实例之间的关系。

图 1 显示了两个示例，每个示例中都有一个 activity 宿主。这两个示例中的宿主 activity 都以 BottomNavigationView 的形式向用户显示顶级导航，该视图负责使用不同的屏幕在应用中换出宿主 fragment。每个屏幕都作为一个独立的 fragment 实现。

示例 1 中的宿主 fragment 托管两个子 fragment，这些子 fragment 构成拆分视图屏幕。示例 2 中的宿主 fragment 托管一个子 fragment，该子 fragment 构成滑动视图的显示 fragment。

基于此设置，您可以将每个宿主视为具有与其关联的 FragmentManager，用于管理其子 fragment。图 2 说明了这一点，并显示了 supportFragmentManager、parentFragmentManager 和 childFragmentManager 之间的属性映射。

需要引用的相应 FragmentManager 属性取决于调用点在 fragment 层次结构中的位置，以及您尝试访问的 fragment 管理器。

对 FragmentManager 进行引用后，您就可以使用它来操纵向用户显示的 fragment。

子 fragment

一般来说，应用由应用项目中的一个或少数几个 activity 组成，其中每个 activity 表示一组相关的屏幕。activity 可能会提供一个点来放置顶级导航，并提供一个位置来限定 ViewModel 对象以及 fragment 之间的其他视图状态的范围。fragment 表示应用中的单个目的地。

如果您想要一次显示多个 fragment（如在拆分视图中或信息中心内），可以使用子 fragment，它们由目的地 fragment 及其子 fragment 管理器进行管理。

子 fragment 的其他用例如下：

• 屏幕滑动，使用父 fragment 中的 ViewPager2 管理一系列子 fragment 视图。
• 一组相关屏幕中的子导航。
• Jetpack Navigation 将子 fragment 用作各个目的地。一个 activity 托管一个父 NavHostFragment，并在用户浏览应用时以不同的子目的地 fragment 填充它的空间。

使用 FragmentManager

FragmentManager 管理 fragment 返回堆栈。在运行时，FragmentManager 可以执行添加或移除 fragment 等返回堆栈操作来响应用户互动。每一组更改作为一个单元（称为 FragmentTransaction）一起提交。如需更深入地了解 fragment 事务，请参阅 fragment 事务指南。

当用户点按设备上的“返回”按钮时，或者当您调用 FragmentManager.popBackStack() 时，最上面的 fragment 事务会从堆栈中弹出。如果堆栈上没有更多 fragment 事务，并且您没有使用子 fragment，则返回事件会向上传递到 activity。如果您使用子 fragment，请参阅有关子 fragment 和同级 fragment 的特殊注意事项。

当您对事务调用 addToBackStack() 时，事务可以包括任意数量的操作，如添加多个 fragment、替换多个容器中的 fragment。

弹出返回堆栈时，所有这些操作会作为一项原子化操作反转。不过，如果您在调用 popBackStack() 之前提交了其他事务，并且您没有对事务使用 addToBackStack()，则这些操作不会反转。因此，在一个 FragmentTransaction 中，应避免让影响返回堆栈的事务与不影响返回堆栈的事务交织在一起。

执行事务

如需在布局容器中显示 fragment，请使用 FragmentManager 创建 FragmentTransaction。在事务中，您随后可以对容器执行 add() 或 replace() 操作。

例如，一个简单的 FragmentTransaction 可能如下所示：

supportFragmentManager.commit {
   replace<ExampleFragment>(R.id.fragment_container)
   setReorderingAllowed(true)
   addToBackStack("name") // Name can be null
}

FragmentManager fragmentManager = getSupportFragmentManager();
fragmentManager.beginTransaction()
    .replace(R.id.fragment_container, ExampleFragment.class, null)
    .setReorderingAllowed(true)
    .addToBackStack("name") // Name can be null
    .commit();

在本例中，ExampleFragment 会替换当前在布局容器中的 fragment（如有），该布局容器由 R.id.fragment_container ID 进行标识。将 fragment 的类提供给 replace() 方法可让 FragmentManager 使用其 FragmentFactory 处理实例化。如需了解详情，请参阅为 fragment 提供依赖项部分。

setReorderingAllowed(true) 可优化事务中涉及的 fragment 的状态变化，以使动画和过渡正常运行。如需详细了解如何使用动画和过渡进行导航，请参阅 fragment 事务和使用动画在 fragment 之间导航。

调用 addToBackStack() 会将事务提交到返回堆栈。用户稍后可以通过点按“返回”按钮反转事务，并恢复上一个 fragment。如果您在一个事务中添加或移除了多个 fragment，弹出返回堆栈时，所有这些操作都会撤消。在 addToBackStack() 调用中提供的可选名称能让您使用 popBackStack() 弹回到该特定事务。

如果您在执行移除 fragment 的事务时未调用 addToBackStack()，则提交事务时会销毁已移除的 fragment，用户无法返回到该 fragment。如果您在移除某个 fragment 时调用 addToBackStack()，则该 fragment 只是 STOPPED，稍后当用户返回时，其 fragment 为 RESUMED。在这种情况下，其视图会被销毁。如需了解详情，请参阅 fragment 生命周期。

查找现有 fragment

您可以使用 findFragmentById() 获取对布局容器中当前 fragment 的引用。从 XML 扩充时，可使用 findFragmentById() 按给定的 ID 查找 fragment；在 FragmentTransaction 中添加时，可使用它按容器 ID 进行查找。示例如下：

supportFragmentManager.commit {
   replace<ExampleFragment>(R.id.fragment_container)
   setReorderingAllowed(true)
   addToBackStack(null)
}
...
val fragment: ExampleFragment =
        supportFragmentManager.findFragmentById(R.id.fragment_container) as ExampleFragment

FragmentManager fragmentManager = getSupportFragmentManager();
fragmentManager.beginTransaction()
    .replace(R.id.fragment_container, ExampleFragment.class, null)
    .setReorderingAllowed(true)
    .addToBackStack(null)
    .commit();
...
ExampleFragment fragment =
        (ExampleFragment) fragmentManager.findFragmentById(R.id.fragment_container);

或者，您也可以为 fragment 分配一个唯一的标记，并使用 findFragmentByTag() 获取引用。您可以在布局中定义的 fragment 上使用 android:tag XML 属性来分配标记，也可以在 FragmentTransaction 中的 add() 或 replace() 操作期间分配标记。

supportFragmentManager.commit {
   replace<ExampleFragment>(R.id.fragment_container, "tag")
   setReorderingAllowed(true)
   addToBackStack(null)
}
...
val fragment: ExampleFragment =
        supportFragmentManager.findFragmentByTag("tag") as ExampleFragment

FragmentManager fragmentManager = getSupportFragmentManager();
fragmentManager.beginTransaction()
    .replace(R.id.fragment_container, ExampleFragment.class, null, "tag")
    .setReorderingAllowed(true)
    .addToBackStack(null)
    .commit();
...
ExampleFragment fragment = (ExampleFragment) fragmentManager.findFragmentByTag("tag");

有关子 fragment 和同级 fragment 的特殊注意事项

在任何给定的时间点，只有一个 FragmentManager 可以控制 fragment 返回堆栈。如果应用在屏幕上同时显示多个同级 fragment，或者应用使用子 fragment，则指定一个 FragmentManager 来处理应用的主要导航。

如需在 fragment 事务内定义主要导航 fragment，请对事务调用 setPrimaryNavigationFragment() 方法，并传入一个 fragment 的实例，该 fragment 的 childFragmentManager 具有主要控制权。

将导航结构视为一系列层，其中 activity 作为最外层，封装下面的每一层子 fragment。每一层都有一个主要导航 fragment。

当发生返回事件时，最内层控制导航行为。一旦最内层再也没有可从其弹回的 fragment 事务，控制权就会向外回一层，此过程会一直重复，直至到达 activity 为止。

当同时显示两个或更多 fragment 时，其中只有一个是主要导航 fragment。如果将某个 fragment 设为主要导航 fragment，会移除对先前 fragment 的指定。在上述示例中，如果您将详情 fragment 设为主要导航 fragment，就会移除对主 fragment 的指定。

支持多个返回堆栈

在某些情况下，您的应用可能需要支持多个返回堆栈。一个常见示例是，您的应用使用底部导航栏。FragmentManager 可让您通过 saveBackStack() 和 restoreBackStack() 方法支持多个返回堆栈。这两种方法让您可以通过保存一个返回堆栈并恢复另一个返回堆栈来在返回堆栈之间进行交换。

saveBackStack() 的工作方式类似于使用可选 name 参数调用 popBackStack()：弹出指定事务以及堆栈上在此之后的所有事务。不同之处在于 saveBackStack() 会保存弹出事务中所有 fragment 的状态。

例如，假设您之前使用 addToBackStack() 提交 FragmentTransaction，从而将 fragment 添加到返回堆栈，如以下示例所示：

supportFragmentManager.commit {
  replace<ExampleFragment>(R.id.fragment_container)
  setReorderingAllowed(true)
  addToBackStack("replacement")
}

supportFragmentManager.beginTransaction()
  .replace(R.id.fragment_container, ExampleFragment.class, null)
  // setReorderingAllowed(true) and the optional string argument for
  // addToBackStack() are both required if you want to use saveBackStack()
  .setReorderingAllowed(true)
  .addToBackStack("replacement")
  .commit();

在这种情况下，您可以通过调用 saveBackStack() 来保存此 fragment 事务和 ExampleFragment 的状态：

supportFragmentManager.saveBackStack("replacement")

supportFragmentManager.saveBackStack("replacement");

您可以使用相同的名称参数调用 restoreBackStack()，以恢复所有弹出的事务以及所有保存的 fragment 状态：

supportFragmentManager.restoreBackStack("replacement")

supportFragmentManager.restoreBackStack("replacement");

为 fragment 提供依赖项

添加 fragment 时，您可以手动实例化 fragment 并将其添加到 FragmentTransaction。

fragmentManager.commit {
    // Instantiate a new instance before adding
    val myFragment = ExampleFragment()
    add(R.id.fragment_view_container, myFragment)
    setReorderingAllowed(true)
}

// Instantiate a new instance before adding
ExampleFragment myFragment = new ExampleFragment();
fragmentManager.beginTransaction()
    .add(R.id.fragment_view_container, myFragment)
    .setReorderingAllowed(true)
    .commit();

当您提交 fragment 事务时，您创建的 fragment 实例就是使用的实例。不过，在配置更改期间，activity 及其所有 fragment 都会被销毁，然后使用最适用的 Android 资源重新创建。FragmentManager 会为您处理所有这些操作：它会重新创建 fragment 的实例，将其附加到宿主，并重新创建返回堆栈状态。

默认情况下，FragmentManager 会使用框架提供的 FragmentFactory 来实例化 fragment 的新实例。此默认工厂使用反射来查找和调用 fragment 的无参数构造函数。这意味着，您无法使用此默认工厂为 fragment 提供依赖项。这也意味着，默认情况下，在重新创建过程中，不会使用您首次创建 fragment 时所用的任何自定义构造函数。

如需为 fragment 提供依赖项或使用任何自定义构造函数，请改为创建自定义 FragmentFactory 子类，然后替换 FragmentFactory.instantiate。您随后可以将 FragmentManager 的默认工厂替换为您的自定义工厂，该自定义工厂随后将用于实例化 fragment。

假设您有一个 DessertsFragment，负责显示您家乡受欢迎的甜点；并且 DessertsFragment 依赖于 DessertsRepository 类，该类可为其提供向用户显示正确界面所需的信息。

您可以将 DessertsFragment 定义为在其构造函数中需要 DessertsRepository 实例。

class DessertsFragment(val dessertsRepository: DessertsRepository) : Fragment() {
    ...
}

public class DessertsFragment extends Fragment {
    private DessertsRepository dessertsRepository;

    public DessertsFragment(DessertsRepository dessertsRepository) {
        super();
        this.dessertsRepository = dessertsRepository;
    }

    // Getter omitted.

    ...
}

FragmentFactory 的简单实现可能与以下代码类似。

class MyFragmentFactory(val repository: DessertsRepository) : FragmentFactory() {
    override fun instantiate(classLoader: ClassLoader, className: String): Fragment =
            when (loadFragmentClass(classLoader, className)) {
                DessertsFragment::class.java -> DessertsFragment(repository)
                else -> super.instantiate(classLoader, className)
            }
}

public class MyFragmentFactory extends FragmentFactory {
    private DessertsRepository repository;

    public MyFragmentFactory(DessertsRepository repository) {
        super();
        this.repository = repository;
    }

    @NonNull
    @Override
    public Fragment instantiate(@NonNull ClassLoader classLoader, @NonNull String className) {
        Class<? extends Fragment> fragmentClass = loadFragmentClass(classLoader, className);
        if (fragmentClass == DessertsFragment.class) {
            return new DessertsFragment(repository);
        } else {
            return super.instantiate(classLoader, className);
        }
    }
}

此示例创建了 FragmentFactory 的子类，替换了 instantiate() 方法，以便为 DessertsFragment 提供自定义 fragment 创建逻辑。 其他 fragment 类通过 super.instantiate() 由 FragmentFactory 的默认行为进行处理。

您随后可以通过在 FragmentManager 上设置一个属性，将 MyFragmentFactory 指定为要在构造应用的 fragment 时使用的工厂。您必须在 activity 的 super.onCreate() 之前设置此属性，以确保在重新创建 fragment 时使用 MyFragmentFactory。

class MealActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        supportFragmentManager.fragmentFactory = MyFragmentFactory(DessertsRepository.getInstance())
        super.onCreate(savedInstanceState)
    }
}

public class MealActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        DessertsRepository repository = DessertsRepository.getInstance();
        getSupportFragmentManager().setFragmentFactory(new MyFragmentFactory(repository));
        super.onCreate(savedInstanceState);
    }
}

在 activity 中设置 FragmentFactory 会替换整个 activity 的 fragment 层次结构中的 fragment 创建。换句话说，您添加的任何子 fragment 的 childFragmentManager 都会使用此处设置的自定义 fragment 工厂，除非在较低的级别被替换。

使用 FragmentFactory 进行测试

在一个 activity 架构中，可以使用 FragmentScenario 类在隔离环境中测试 fragment。由于您无法依赖于 activity 的自定义 onCreate 逻辑，因此可以改为将 FragmentFactory 作为参数传入 fragment 测试，如以下示例所示：

// Inside your test
val dessertRepository = mock(DessertsRepository::class.java)
launchFragment<DessertsFragment>(factory = MyFragmentFactory(dessertRepository)).onFragment {
    // Test Fragment logic
}

如需详细了解此测试过程和完整示例，请参阅测试 fragment。