页面过渡由 ZoomPageTransitionsBuilder 替代

为了确保库遵循最新的 OEM 行为，默认的页面过渡构建器现在在所有平台（iOS 和 macOS 除外）上使用 ZoomPageTransitionsBuilder，而不是 FadeUpwardsPageTransitionsBuilder。

FadeUpwardsPageTransitionsBuilder (随 Flutter 首次发布提供) 定义了一种页面过渡，类似于 Android O 提供的效果。根据 Flutter 的弃用策略，此页面过渡构建器最终将在 Android 上弃用。

ZoomPageTransitionsBuilder 是 Android、Linux 和 Windows 的新页面过渡构建器，它定义了一种类似于 Android Q 和 R 提供的页面过渡效果。

根据 Flutter 仓库样式指南，该框架将遵循最新的 OEM 行为。所有使用 FadeUpwardsPageTransitionsBuilder 的页面过渡构建器都已切换到 ZoomPageTransitionsBuilder。当当前的 TargetPlatform 在 ThemeData.pageTransitionsTheme 中没有定义 PageTransitionsBuilder 时，ZoomPageTransitionsBuilder 将用作默认值。

PageTransitionsTheme._defaultBuilders 中定义的 PageTransitionsBuilders 已从 FadeUpwardsPageTransitionsBuilder 更改为 ZoomPageTransitionsBuilder，适用于 TargetPlatform.android、TargetPlatform.linux 和 TargetPlatform.windows。

如果您想切换回先前的页面过渡构建器 (FadeUpwardsPageTransitionsBuilder)，您应该为目标平台明确定义构建器。

迁移前的代码

dartMaterialApp(
  theme: ThemeData(colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple)),
)

迁移后的代码

dartMaterialApp(
  theme: ThemeData(
    pageTransitionsTheme: const PageTransitionsTheme(
      builders: <TargetPlatform, PageTransitionsBuilder>{
        TargetPlatform.android: FadeUpwardsPageTransitionsBuilder(), // Apply this to every platforms you need.
      },
    ),
  ),
)

如果您想将相同的页面过渡构建器应用于所有平台

dartMaterialApp(
  theme: ThemeData(
    pageTransitionsTheme: PageTransitionsTheme(
      builders: Map<TargetPlatform, PageTransitionsBuilder>.fromIterable(
        TargetPlatform.values,
        value: (dynamic _) => const FadeUpwardsPageTransitionsBuilder(),
      ),
    ),
  ),
)

如果您过去尝试查找小部件但使用新过渡时因 Too many elements 而失败，并看到类似以下错误

══╡ EXCEPTION CAUGHT BY FLUTTER TEST FRAMEWORK ╞════════════════════════════════════════════════════
The following StateError was thrown running a test:
Bad state: Too many elements

When the exception was thrown, this was the stack:
#0      Iterable.single (dart:core/iterable.dart:656:24)
#1      WidgetController.widget (package:flutter_test/src/controller.dart:69:30)
#2      main.<anonymous closure> (file:///path/to/your/test.dart:1:2)

您应该通过对具有特定小部件类型的 Finder 使用 descendant 范围来迁移您的测试。以下是 DataTable 测试的示例

迁移前测试

dart

final Finder finder = find.widgetWithIcon(Transform, Icons.arrow_upward);

迁移后测试

dartfinal Finder finder = find.descendant(
  of: find.byType(DataTable),
  matching: find.widgetWithIcon(Transform, Icons.arrow_upward),
);

通常需要迁移查找器范围的小部件有：Transform、FadeTransition、ScaleTransition 和 ColoredBox。

发布版本：2.13.0-1.0.pre
稳定版本：3.0.0

API 文档

页面过渡由 ZoomPageTransitionsBuilder 替代

概述

背景

变更说明

迁移指南

测试迁移

时间线

参考资料