Swift中Mapbox的onCameraChanged未触发，如何解决？

1. MapView未添加到视图层级 #

你的代码中创建了mapView但未将其加入控制器的视图层级，这会导致地图手势完全无法响应，相机变化也仅会在初始化时触发一次。

修复：创建mapView后添加以下代码：

view.addSubview(mapView)
// 如需自动布局，补充约束代码
mapView.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    mapView.topAnchor.constraint(equalTo: view.topAnchor),
    mapView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
    mapView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
    mapView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
])

2. mapInitOptions()未被调用的原因 #

MapInitOptionsProvider协议仅适用于通过Storyboard/XIB初始化MapView的场景。纯代码创建时，需手动将自定义的MapInitOptions传入初始化方法，协议方法不会自动触发。

修复：修改MapView初始化代码：

let initOptions = mapInitOptions()
self.mapView = MapView(frame: view.bounds, mapInitOptions: initOptions)

同时移除后续直接赋值mapStyle的代码——MapInitOptions已指定styleURI，重复设置会导致状态重置，影响监听逻辑。

3. 相机变化监听的正确方式 #

你当前监听的mapboxMap.onCameraChanged仅会在地图样式加载完成前触发一次初始化，实时相机变化需监听mapView.camera.onChanged：

修复：替换相机监听代码：

self.mapView.camera.onChanged.observe { [weak self] _ in
    guard let self else { return }
    updateMap()
    print("onCameraChange")
}.store(in: &cancellables)

4. 地图点击监听的注意事项 #

确保mapView.isUserInteractionEnabled为true（默认开启，若被意外修改会导致手势失效），同时正确处理onMapTap的上下文参数：

self.mapView.gestures.onMapTap.observe { context in
    print("onMapTap at coordinate: \(context.coordinate)")
    updateMap()
}.store(in: &cancellables)

完整修复后的核心代码示例 #

import UIKit
import MapboxMaps

class ViewController: UIViewController, URLSessionDelegate {
    
    private var mapView: MapView!
    private var cancellables: Set<AnyCancelable> = []
    
    private func mapInitOptions() -> MapInitOptions {
        let cameraOptions = CameraOptions(center: CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074), zoom: 10)
        return MapInitOptions(
            cameraOptions: cameraOptions,
            styleURI: StyleURI(rawValue: "mapbox://my-favorite-style")!
        )
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 初始化MapView并传入自定义配置
        let initOptions = mapInitOptions()
        self.mapView = MapView(frame: view.bounds, mapInitOptions: initOptions)
        // 添加到视图层级
        view.addSubview(mapView)
        // 设置自动布局
        mapView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            mapView.topAnchor.constraint(equalTo: view.topAnchor),
            mapView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            mapView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            mapView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
        ])
        
        // 监听相机实时变化
        self.mapView.camera.onChanged.observe { [weak self] _ in
            guard let self else { return }
            updateMap()
            print("onCameraChange")
        }.store(in: &cancellables)
        
        // 监听地图点击
        self.mapView.gestures.onMapTap.observe { context in
            print("onMapTap at coordinate: \(context.coordinate)")
            updateMap()
        }.store(in: &cancellables)
    }
    
    private func updateMap() {
        // 你的地图更新逻辑
    }
}

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