Flutter集成测试中convertFlutterSurfaceToImage()异常及截图卡住问题

问题场景 #

在Android模拟器上执行Flutter集成测试时，调用IntegrationTestWidgetsFlutterBinding.convertFlutterSurfaceToImage()方法抛出ClassCastException，更换模拟器、调整flutter drive命令均无法解决。

截图实现代码 #

takeScreenshot(screenshotName, WidgetTester tester,
    IntegrationTestWidgetsFlutterBinding binding) async {
  if (Platform.isAndroid) {
    await binding.convertFlutterSurfaceToImage();
    await tester.pumpAndSettle();
  }
  await binding.takeScreenshot(screenshotName);
}

错误信息 #

PlatformException(error, android.widget.RelativeLayout cannot be cast to
io.flutter.embedding.android.FlutterView, null, java.lang.ClassCastException:
android.widget.RelativeLayout cannot be cast to io.flutter.embedding.android.FlutterView
    at
dev.flutter.plugins.integration_test.FlutterDeviceScreenshot.getFlutterView(FlutterDeviceScreenshot.java:55)
    at
dev.flutter.plugins.integration_test.FlutterDeviceScreenshot.convertFlutterSurfaceToImage(FlutterDeviceScreenshot.java:91)
    at
dev.flutter.plugins.integration_test.IntegrationTestPlugin.onMethodCall(IntegrationTestPlugin.java:88)
    at
io.flutter.plugin.common.MethodChannel$IncomingMethodCallHandler.onMessage(MethodChannel.java:258)
    at io.flutter.embedding.engine.dart.DartMessenger.invokeHandler(DartMessenger.java:295)
    at
io.flutter.embedding.engine.dart.DartMessenger.lambda$dispatchMessageToQueue$0$io-flutter-embedding-engine-dart-DartMessenger(DartMessenger.java:322)
    at io.flutter.embedding.engine.dart.DartMessenger$$ExternalSyntheticLambda0.run(Unknown Source:12)
    at android.os.Handler.handleCallback(Handler.java:942)
    at android.os.Handler.dispatchMessage(Handler.java:99)
    at android.os.Looper.loopOnce(Looper.java:201)
    at android.os.Looper.loop(Looper.java:288)
    at android.app.ActivityThread.main(ActivityThread.java:7872)
    at java.lang.reflect.Method.invoke(Native Method)
    at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:548)
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:936)
)

When the exception was thrown, this was the stack:
#0      StandardMethodCodec.decodeEnvelope (package:flutter/src/services/message_codecs.dart:652:7)
#1      MethodChannel._invokeMethod (package:flutter/src/services/platform_channel.dart:310:18)
<asynchronous suspension>
<asynchronous suspension>
(elided one frame from package:stack_trace)

问题原因 #

核心原因是Android项目的MainActivity继承了FlutterFragmentActivity：

• FlutterFragmentActivity的布局根视图是RelativeLayout，内部通过FlutterFragment承载Flutter内容；
• 集成测试的IntegrationTest插件在执行convertFlutterSurfaceToImage()时，会尝试直接获取根视图并强转为FlutterView，因此触发类型转换异常。

初始修复方案 #

将MainActivity的继承类从FlutterFragmentActivity改为FlutterActivity：

• FlutterActivity的布局根视图直接是FlutterView，插件可正常获取到对应实例，避免类型转换错误。

更新1：改为FlutterActivity后，convertFlutterSurfaceToImage()可正常执行，但takeScreenshot()出现卡住的情况，可尝试以下解决方向：

• 调整UI等待逻辑：替换tester.pumpAndSettle()为多次固定时长的tester.pump()，避免因未完成的无限动画导致等待超时，示例：

  await tester.pump(const Duration(seconds: 2));
  

• 检查依赖版本兼容性：确保integration_test包版本与Flutter SDK版本匹配，版本不兼容可能引发截图逻辑异常，可尝试升级到稳定版或降级到已知兼容版本。
• 手动生成截图：如果takeScreenshot()仍卡住，可通过renderView.snapshot()手动生成截图，替代官方方法：

  takeScreenshot(screenshotName, WidgetTester tester,
      IntegrationTestWidgetsFlutterBinding binding) async {
    if (Platform.isAndroid) {
      await binding.convertFlutterSurfaceToImage();
      await tester.pump(const Duration(seconds: 2));
    }
    final image = await tester.binding.renderView.snapshot();
    final bytes = await image.toByteData(format: ImageByteFormat.png);
    await File('$screenshotName.png').writeAsBytes(bytes!.buffer.asUint8List());
  }
  

• 优化模拟器配置：确保模拟器启用硬件加速，分配足够的内存（建议不少于2GB）和CPU核心数，资源不足可能导致截图操作卡顿。

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