iOS 16.4中MapKit渲染Polyline（折线）异常问题求助

问题描述 #

基于Swift开发的iOS应用，使用MapKit实现地图功能时，在iOS 16.4系统出现折线（Polyline）渲染异常：

• 自定义瓦片在更高版本系统功能正常，排除瓦片本身问题
• 地图缩放、瓦片闪烁阶段折线短暂显示，瓦片稳定后折线消失
• 控制台输出错误：[VKDefault] Missing DaVinciGroundRenderables for ground mesh layer（未创建折线时也会触发该错误）
• 当前折线渲染代码：

if overlay is MKPolyline {
    let polylineRenderer = MKPolylineRenderer(overlay: overlay)
    polylineRenderer.strokeColor = UIColor.orange
    polylineRenderer.lineWidth = 7.0
    polylineRenderer.alpha = 1.0
    return polylineRenderer
}

可能的修复方案 #

• 提升折线渲染层级：设置折线渲染器的zPosition，确保其显示在瓦片图层上方

  polylineRenderer.zPosition = 100 // 设为高于默认瓦片的层级值
  

• 自定义折线渲染逻辑：替换默认MKPolylineRenderer，手动绘制路径避免系统渲染bug

  class CustomPolylineRenderer: MKOverlayRenderer {
      override func draw(_ mapRect: MKMapRect, zoomScale: MKZoomScale, in context: CGContext) {
          guard let polyline = overlay as? MKPolyline else { return }
          
          context.setStrokeColor(UIColor.orange.cgColor)
          context.setLineWidth(7.0 / zoomScale)
          context.setAlpha(1.0)
          
          let path = UIBezierPath()
          let points = polyline.points()
          for i in 0..<polyline.pointCount {
              let point = point(for: points[i])
              i == 0 ? path.move(to: point) : path.addLine(to: point)
          }
          context.addPath(path.cgPath)
          context.strokePath()
      }
  }
  // 使用时替换原有渲染器为CustomPolylineRenderer
  

• 强制触发地图重绘：在瓦片加载完成后手动刷新地图渲染，可通过MKMapViewDelegate的mapViewDidFinishLoadingMap(_:)或mapView(_:regionDidChangeAnimated:)方法调用mapView.setNeedsDisplay()
• 针对iOS 16.4做版本适配：仅在iOS 16.4系统使用自定义渲染逻辑，其他版本保留原有实现

  if #available(iOS 16.4, *) {
      return CustomPolylineRenderer(overlay: overlay)
  } else {
      let polylineRenderer = MKPolylineRenderer(overlay: overlay)
      polylineRenderer.strokeColor = UIColor.orange
      polylineRenderer.lineWidth = 7.0
      polylineRenderer.alpha = 1.0
      return polylineRenderer
  }
  

• 重置地图渲染状态：尝试重新设置地图mapType后再切回自定义瓦片，或重新初始化地图视图，缓解底层渲染逻辑冲突

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