Flutter谷歌地图分辨率自适应图片标记跨端适配失效问题求助

问题根源 #

1. 初始按官方目录组织资源双端均失效的核心原因：调用BitmapDescriptor.fromAssetImage时传入了无参数的ImageConfiguration，没有携带当前设备的像素密度、平台等匹配信息，Flutter无法自动适配对应分辨率的资源变体，默认加载1x图。
2. 改为@2x命名后仅iOS生效的原因：iOS原生资源加载规则本身支持@2x/@3x命名格式，安卓无该原生规则，仍需依赖Flutter的ImageConfiguration做资源匹配，因此安卓始终加载1x图。

修复方案 #

第一步：恢复官方标准资源结构

改回 Flutter 官方推荐的目录结构，无需使用@2x命名，避免双端规则冲突：

assets/pinLocationIcons/house.png（1x图）
assets/pinLocationIcons/2.0x/house.png（2x图）
assets/pinLocationIcons/3.0x/house.png（3x图）

第二步：修正代码传入正确的ImageConfiguration

需要给ImageConfiguration传入当前设备的像素密度参数，两种实现方式可选：

• 有上下文context时优先使用官方提供的createLocalImageConfiguration自动生成配置：

static Future<BitmapDescriptor> makeBitmapDescriptor(BuildContext context, String path) async {
  final ImageConfiguration config = createLocalImageConfiguration(context);
  return await BitmapDescriptor.fromAssetImage(
    config, 
    "assets/pinLocationIcons/house.png"
  );
}

• 无法获取上下文时，手动读取设备像素比传入：

import 'dart:ui' as ui;

static Future<BitmapDescriptor> makeBitmapDescriptor(String path) async {
  final ImageConfiguration config = ImageConfiguration(
    devicePixelRatio: ui.window.devicePixelRatio,
  );
  return await BitmapDescriptor.fromAssetImage(
    config, 
    "assets/pinLocationIcons/house.png"
  );
}

第三步：简化pubspec.yaml配置

无需单独声明各分辨率变体，仅声明根路径资源即可：

flutter:
  assets:
    - assets/pinLocationIcons/house.png

如果同目录下有多个资源，也可直接声明目录：

flutter:
  assets:
    - assets/pinLocationIcons/

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