MapKit的.convert()函数在SwiftUI macOS中触发SIGABRT错误

问题场景 #

使用Xcode15 Beta7开发时，相同代码在iOS模拟器可正常运行，但在macOS平台调用MapReader的convert(_:from:)函数时触发SIGABRT错误，控制台提示符号未找到。

代码示例 #

import MapKit
import SwiftUI

struct ContentView: View {
    
    @State var location: CLLocationCoordinate2D? = nil
    
    var body: some View {
        MapReader { reader in
            Map {
                if let location {
                    Marker("(\(location.latitude), \(location.longitude))", coordinate: location)
                }
            }
            .onTapGesture { coords in
                location = reader.convert(coords, from: .local) // 引发错误的代码
            }
        }
    }
}

控制台报错信息 #

dyld[35102]: Symbol not found: _$s15_MapKit_SwiftUI0A5ProxyV7convert_4fromSo22CLLocationCoordinate2DVSgSo7CGPointV_xt0cD023CoordinateSpaceProtocolRzlF
  Referenced from: <1B995F7F-26B0-3877-A3D8-887D05F7164E> /Users/mohalibou/Library/Developer/Xcode/DerivedData/Testlol-dqropkwgughsodffunzdvseijasi/Build/Products/Debug/Testlol.app/Contents/MacOS/Testlol
  Expected in:     <67E0E989-BDE1-384E-A80C-9297D2186069> /System/Library/Frameworks/_MapKit_SwiftUI.framework/Versions/A/_MapKit_SwiftUI

问题原因 #

这是Xcode15 Beta版本的API兼容性问题：MapReader的convert(_:from:)方法在iOS的_MapKit_SwiftUI框架中已实现，但macOS版本的该框架尚未包含此符号，导致运行时动态链接失败，触发SIGABRT。

临时解决方案 #

通过条件编译区分平台，iOS保留原生实现，macOS使用MKMapView包装器处理点击坐标转换，示例代码如下：

import MapKit
import SwiftUI

struct MapViewWrapper: UIViewRepresentable {
    @Binding var selectedLocation: CLLocationCoordinate2D?
    
    func makeUIView(context: Context) -> MKMapView {
        let mapView = MKMapView()
        let tapGesture = UITapGestureRecognizer(target: context.coordinator, action: #selector(context.coordinator.handleTap(_:)))
        mapView.addGestureRecognizer(tapGesture)
        return mapView
    }
    
    func updateUIView(_ uiView: MKMapView, context: Context) {
        uiView.removeAnnotations(uiView.annotations)
        if let location = selectedLocation {
            let annotation = MKPointAnnotation()
            annotation.coordinate = location
            annotation.title = "(\(location.latitude), \(location.longitude))"
            uiView.addAnnotation(annotation)
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(self)
    }
    
    class Coordinator: NSObject {
        var parent: MapViewWrapper
        
        init(_ parent: MapViewWrapper) {
            self.parent = parent
        }
        
        @objc func handleTap(_ gesture: UITapGestureRecognizer) {
            let mapView = gesture.view as! MKMapView
            let point = gesture.location(in: mapView)
            let coordinate = mapView.convert(point, toCoordinateFrom: mapView)
            parent.selectedLocation = coordinate
        }
    }
}

struct ContentView: View {
    @State var location: CLLocationCoordinate2D? = nil
    
    var body: some View {
        #if os(iOS)
        MapReader { reader in
            Map {
                if let location {
                    Marker("(\(location.latitude), \(location.longitude))", coordinate: location)
                }
            }
            .onTapGesture { coords in
                location = reader.convert(coords, from: .local)
            }
        }
        #elseif os(macOS)
        MapViewWrapper(selectedLocation: $location)
            .frame(maxWidth: .infinity, maxHeight: .infinity)
        #endif
    }
}

说明 #

• 该方案通过包装原生MKMapView实现macOS平台的点击坐标转换，避免Beta版本API缺失的问题。
• 待Xcode正式版修复macOS平台的MapReader.convert API支持后，可直接切换回原生实现。

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