Flutter测试中设置window physicalSize和devicePixelRatio不生效问题

我参考相关方法编写了Flutter组件测试代码，试图模拟指定的屏幕物理尺寸和设备像素比，但调试时发现设置并未生效，ui.window.physicalSize和ui.window.devicePixelRatio仍显示默认值。测试代码如下：

import 'dart:ui' as ui;

testWidgets('test', (tester) async{
    // 设置物理尺寸
    tester.binding.window.physicalSizeTestValue = const Size(1366.0, 673.0);
    tester.binding.window.devicePixelRatioTestValue = 1.0;

    // 测试结束后重置设置
    addTearDown(tester.binding.window.clearPhysicalSizeTestValue);
    addTearDown(tester.binding.window.clearDevicePixelRatioTestValue);

    //////////// 调试代码
    var physicalSize = ui.window.physicalSize; // 调试显示 Size(2400.0, 1800.0)
    var pixelRatio = ui.window.devicePixelRatio; // 调试显示 3.0
    ///////////

    await tester.runAsync(() async {
      ... // 依赖屏幕尺寸的代码（使用window.size和window.devicePixelRatio）
    });

    ...
  });

问题原因及解决办法 #

• ui.window不会同步测试绑定的模拟值：测试中通过tester.binding.window设置的测试参数，仅作用于Flutter测试框架绑定的上下文，全局的ui.window是原始窗口实例，不会自动应用这些测试设置。

• 通过测试绑定实例获取窗口信息：调试和业务代码中，应使用tester.binding.window获取模拟后的屏幕参数，而非直接访问ui.window。修改调试代码如下：

  var physicalSize = tester.binding.window.physicalSize;
  var pixelRatio = tester.binding.window.devicePixelRatio;
  

• 通知框架尺寸变更：设置完测试值后，需调用dispatchMetricsChanged()让Flutter框架感知尺寸变化，确保依赖屏幕尺寸的组件更新。补充代码：

  tester.binding.window.physicalSizeTestValue = const Size(1366.0, 673.0);
  tester.binding.window.devicePixelRatioTestValue = 1.0;
  // 通知框架尺寸已更新
  tester.binding.window.dispatchMetricsChanged();
  

• 统一窗口实例访问方式：业务代码中建议使用WidgetsBinding.instance.window替代ui.window，测试环境下该实例会自动指向测试绑定的窗口，无需额外修改即可适配测试场景。

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