OverlayEntries 和 Routes 的重建优化

此优化提高了路由过渡的性能，但可能会暴露您应用中缺失的 setState 调用。

在此更改之前，当一个新的不透明条目添加到 OverlayEntry 之上或从其上方移除时，该 OverlayEntry 会重建。这些重建是不必要的，因为它们不是由受影响 OverlayEntry 的状态更改触发的。此破坏性更改优化了我们处理 OverlayEntry 添加和移除的方式，并消除了不必要的重建以提高性能。

由于 Navigator 在内部将每个 Route 放入 OverlayEntry，因此此更改也适用于 Route 过渡：如果一个不透明的 Route 被推到另一个 Route 之上或从其上方移除，则不透明 Route 下方的 Route 不再不必要地重建。

在大多数情况下，此更改不需要您更改任何代码。但是，如果您的应用错误地依赖于隐式重建，您可能会遇到问题，可以通过将任何状态更改包装在 setState 调用中来解决这些问题。

此外，此更改略微修改了 widget 树的形状：在此更改之前，OverlayEntry 被包装在一个 Stack widget 中。显式 Stack widget 已从 widget 层次结构中移除。

如果您在升级到包含此更改的 Flutter 版本后遇到问题，请审计您的代码以查找缺失的 setState 调用。在下面的示例中，将 Navigator.pushNamed 的返回值分配给 buttonLabel 会隐式修改状态，并且应该将其包装在显式的 setState 调用中。

迁移前的代码

dartclass FooState extends State<Foo> {
  String buttonLabel = 'Click Me';
  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () async {
        // Illegal state modification that should be wrapped in setState.
        buttonLabel = await Navigator.pushNamed(context, '/bar');
      },
      child: Text(buttonLabel),
    );
  }
}

迁移后的代码

dartclass FooState extends State<Foo> {
  String buttonLabel = 'Click Me';
  @override
  Widget build(BuildContext context) {
    return ElevatedButton(
      onPressed: () async {
        final newLabel = await Navigator.pushNamed(context, '/bar');
        setState(() {
          buttonLabel = newLabel;
        });
      },
      child: Text(buttonLabel),
    );
  }
}

发布版本: 1.16.3
稳定版本: 1.17

API 文档

OverlayEntries 和 Routes 的重建优化

概述

背景

变更说明

迁移指南

时间线

参考资料