为何添加MKPolyline叠加层后编程捕获的MapView截图为旧版本？

问题根因 #

你遇到的问题核心是MKMapView的overlay渲染是异步操作：

• 调用mapView.addOverlay(polyline)后，MapKit不会立刻把折线渲染到视图layer上，只是将绘制任务提交到主线程的下一个RunLoop周期执行
• 你当前的代码是调用完addOverlay后同步执行update、log截图逻辑，所有逻辑都在同一个RunLoop周期内，截图时折线还没完成渲染，自然捕捉不到新增的叠加层
• 调试时能看到overlay已经存在是因为断点暂停时系统已经执行完了下一个RunLoop的渲染任务，和实际运行的时序不一致

解决方案 #

把截图逻辑延迟到下一个RunLoop周期执行即可，有两种实现方式：

方式1：使用GCD主队列异步派发 #

在调用log方法的时候包一层主队列异步，修改update方法里调用log的代码：

// 原代码：log(eventType: eventType)
// 修改为：
DispatchQueue.main.async { [weak self] in
    self?.log(eventType: eventType)
}

方式2：监听MKMapView的渲染完成回调 #

如果要确保地图所有元素（包括瓦片、叠加层、标注）都完全渲染完成再截图，可以实现MKMapViewDelegate的mapViewDidFinishRenderingMap方法，加个标记位判断是否需要截图：

// 新增标记属性
var needSnapshotAfterRender = false
var pendingEventType: LogEventType?

// 修改update里调用log的代码
needSnapshotAfterRender = true
pendingEventType = eventType

// 实现代理方法
func mapViewDidFinishRenderingMap(_ mapView: MKMapView, fullyRendered: Bool) {
    guard fullyRendered, needSnapshotAfterRender, let eventType = pendingEventType else { return }
    needSnapshotAfterRender = false
    pendingEventType = nil
    log(eventType: eventType)
}

额外优化（可选） #

如果还是出现渲染不全的情况，可以把截图逻辑再延迟极短的时间，确保渲染彻底完成：

DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
    guard let self = self else { return }
    guard let mapImage = self.mapView.asImage() else { return }
    // 后续的上传逻辑
}

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