Flutter库更新后CustomPainter在图片上绘制的旧代码失效问题求助

核心原因说明 #

该问题90%以上由Flutter 3.10+版本对dart:ui图片编解码API的破坏性变更导致，旧版本可用的部分方法已被正式移除，会出现运行时找不到函数、编译报错的现象。

对应修复方法 #

• 替换已废弃的图片编解码方法
  旧代码中如果用到ui.instantiateImageCodec方法，按照如下逻辑替换：

  // 旧写法（3.10+已移除）
  // final codec = await ui.instantiateImageCodec(imageBytes);
  
  // 新写法（兼容3.10及以上版本）
  final buffer = await ui.ImmutableBuffer.fromUint8List(imageBytes);
  final imageDescriptor = await ui.ImageDescriptor.encoded(buffer);
  final codec = await imageDescriptor.instantiateCodec(
    targetWidth: 你需要的目标宽度,
    targetHeight: 你需要的目标高度
  );
  // 用完主动释放buffer避免内存泄漏
  buffer.dispose();
  

• 调整图片流监听逻辑
  如果你通过ImageProvider加载图片资源，旧版直接传入回调的addListener写法已失效，需改为传入ImageStreamListener对象：

  final ImageStream imageStream = AssetImage('你的图片路径').resolve(ImageConfiguration.empty);
  imageStream.addListener(ImageStreamListener((ImageInfo imageInfo, bool syncCall) {
    // 此处拿到imageInfo.image即可用于CustomPainter绘制
  }));
  

• 第三方依赖兼容
  如果你用到了image、flutter_image等第三方图片处理库，将其升级到官方发布的适配Flutter 3.10+的最新版本即可。

快速验证方法 #

将本地Flutter SDK切换到3.7.x稳定版运行项目，如果代码恢复正常，即可确认是API兼容性问题，按上述方案适配即可。

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