HERE Maps Premium SDK调用snapshot接口返回黑块问题排查

• 集成环境：通过CocoaPods集成3.20.2版本HERE Maps Premium SDK
• 异常表现：调用NMAMapView的快照接口生成指定区域地图图片时，回调返回纯黑色矩形UIImage。该功能此前运行正常，客户端侧未修改任何相关代码。
• 核心调用代码如下：

NMAMapView.snapshot(geoCoordinates: coordinates, zoomLevel: zoomLevel, orientation: orientation, size: size) { result in
    // 回调返回的result为纯黑矩形UIImage
}

• 异常效果参考：
  

该问题由3.20.2版本SDK自身的渲染逻辑适配缺陷导致，和业务代码无关：

• 3.20.2版本SDK默认将渲染后端从OpenGL切换为Metal，但离屏快照接口的实现没有同步适配Metal渲染链路，离屏渲染的帧缓冲区无法正常捕获地图渲染内容，仅返回初始状态下的黑色空帧。
• 出现“未改代码但功能突然失效”的现象，是因为CocoaPods会在执行pod install时拉取对应版本号下的最新构建包：本地之前缓存的是3.20.2早期未切换Metal后端的测试构建，重新拉取依赖后拿到了带缺陷的正式发布构建，就会触发该问题。

• 临时规避：在SDK初始化逻辑前添加配置，强制回退到OpenGL渲染后端即可恢复快照功能，配置代码：

NMASettings.setMetalRenderingEnabled(false)

• 永久修复：将HERE Maps Premium SDK升级到3.20.3及以上版本，官方已在后续补丁版本中完成Metal后端下离屏快照接口的适配修复。

内容的提问来源于stack exchange，提问作者F. Sv.