iOS端使用maplibre_gl加载本地自定义样式失败问题求助

针对iOS端无法加载本地自定义样式的问题，你可以尝试以下几个针对性的排查和修复步骤：

1. 捕获样式加载错误信息 #

首先给MapLibreMap添加错误回调，明确iOS端加载失败的具体原因，这是定位问题的关键：

MapLibreMap(
    styleString: _localStyle ?? '',
    onStyleLoadedFailure: (error) {
        debugPrint('iOS样式加载失败详情: $error');
    },
    // 其他参数
);

运行iOS项目后查看控制台输出，根据错误提示进一步处理。

2. 检查文件名大小写 #

iOS系统对文件路径和文件名是大小写敏感的，而Android不敏感。确认你的style-default.json文件名和代码中引用的完全一致（包括大小写），比如不要出现代码里写style-default.json但实际文件是Style-Default.json的情况。

3. 改用styleUri加载本地样式 #

尝试替换styleString为styleUri加载本地资源，iOS端对Uri加载的兼容性可能更好：

// 直接使用asset协议的Uri
final localStyleUri = Uri.parse('asset:///assets/styles/style-default.json');

// 在MapLibreMap中配置
MapLibreMap(
    styleUri: localStyleUri,
    // 其他参数
);

4. 确保JSON字符串编码正确 #

显式指定UTF-8编码加载JSON文件，避免iOS端出现编码解析问题：

import 'dart:convert';

// ...

String style = await rootBundle.loadString(
    'assets/styles/style-default.json',
    encoding: Encoding.getByName('utf-8'),
);
setState(() {
    _localStyle = style;
});

5. 修正JSON中的tiles URL格式 #

你的style.json中tiles URL使用了URL转义的%7Bz%7D，可以尝试替换为未转义的{z}/{x}/{y}（JSON支持直接包含大括号），避免iOS端解析转义字符时出现异常：

"tiles": [
    "https://mon-serveur.raster/tiles/{z}/{x}/{y}.png"
]

"tiles": ["https://mon-serveur.mvt/tiles/{z}/{x}/{y}.mvt"]

6. 重新配置iOS依赖 #

执行以下步骤确保iOS端依赖配置正确：

• 执行flutter clean清理项目缓存
• 进入ios目录，执行pod deintegrate && pod install重新安装依赖
• 重新运行iOS项目

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