expo-gaode-map 2.2.38 → 2.2.40-next.0

package/ios/ExpoGaodeMapView.swift

@@ -28,6 +28,12 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     var showsScale: Bool = true
     /// 是否启用缩放手势
     var isZoomEnabled: Bool = true
+    /// 缩放手势锚点：gesture 跟随手势中心点；center 固定地图中心点
+    var zoomGestureAnchor: String = "gesture" {
+        didSet {
+            applyZoomGestureSettings()
+        }
+    }
     /// 是否启用滚动手势
     var isScrollEnabled: Bool = true
     /// 是否启用旋转手势
@@ -96,6 +102,8 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     private var uiManager: UIManager!
     /// 地图是否已加载完成
     private var isMapLoaded = false
+    /// 定位 annotation 首次出现后是否已补应用定位样式
+    private var hasAppliedUserLocationStyleAfterLocationUpdate = false
     /// 初始相机是否已应用（仅应用一次，避免与运行时相机控制冲突）
     private var hasAppliedInitialCameraPosition = false
     /// 是否正在处理 annotation 选择事件
@@ -113,9 +121,15 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     private var pendingCameraMoveData: [String: Any]?
     private var cameraMoveDispatchWorkItem: DispatchWorkItem?
     private var lastCameraMoveDispatchTime: CFTimeInterval = 0
+    /// iOS 缩放惯性/连续 setZoom 可能多次触发 regionDidChange，合并后再派发 idle。
+    private var pendingCameraIdleData: [String: Any]?
+    private var cameraIdleDispatchWorkItem: DispatchWorkItem?
+    private let cameraIdleDebounceMs = 160
     
     /// 缩放手势识别器（用于模拟惯性）
     private var pinchGesture: UIPinchGestureRecognizer!
+    private var centerAnchoredPinchStartZoom: CGFloat?
+    private var centerAnchoredZoomCoordinate: CLLocationCoordinate2D?
     
     // 惯性动画相关属性
     private var displayLink: CADisplayLink?
@@ -361,12 +375,12 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         uiManager.setMapType(1)
         uiManager.setShowsScale(showsScale)
         uiManager.setShowsCompass(showsCompass)
-        uiManager.setZoomEnabled(isZoomEnabled)
+        applyZoomGestureSettings()
         uiManager.setScrollEnabled(isScrollEnabled)
         uiManager.setRotateEnabled(isRotateEnabled)
         uiManager.setTiltEnabled(isTiltEnabled)
         uiManager.setShowsUserLocation(showsUserLocation, followUser: followUserLocation)
-        updatePinchGestureState()
+        applyUserLocationStyle()
     }
     
     /**
@@ -390,21 +404,21 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         
         uiManager.setShowsScale(showsScale)
         uiManager.setShowsCompass(showsCompass)
-        uiManager.setZoomEnabled(isZoomEnabled)
+        applyZoomGestureSettings()
         uiManager.setScrollEnabled(isScrollEnabled)
         uiManager.setRotateEnabled(isRotateEnabled)
         uiManager.setTiltEnabled(isTiltEnabled)
         uiManager.setShowsUserLocation(showsUserLocation, followUser: followUserLocation)
+        applyUserLocationStyle()
         uiManager.setShowsTraffic(showsTraffic)
         uiManager.setShowsBuildings(showsBuildings)
         uiManager.setShowsIndoorMap(showsIndoorMap)
-        updatePinchGestureState()
         mapView.distanceFilter = distanceFilter
         mapView.headingFilter = headingFilter
         if let customMapStyleData {
             uiManager.setCustomMapStyle(customMapStyleData)
         }
-        
+
         // 更新苹果地图样式
         updateAppleMapStyle()
         
@@ -439,6 +453,13 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     // MARK: - 手势处理
     
     @objc func handlePinch(_ gesture: UIPinchGestureRecognizer) {
+        guard isZoomEnabled else { return }
+
+        if zoomGestureAnchor == "center" {
+            handleCenterAnchoredPinch(gesture)
+            return
+        }
+
         if gesture.state == .began {
             // 手势开始，立即停止之前的惯性动画，避免冲突
             stopInertiaAnimation()
@@ -455,6 +476,44 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
             }
         }
     }
+
+    private func handleCenterAnchoredPinch(_ gesture: UIPinchGestureRecognizer) {
+        switch gesture.state {
+        case .began:
+            stopInertiaAnimation()
+            centerAnchoredPinchStartZoom = mapView.zoomLevel
+            centerAnchoredZoomCoordinate = mapView.centerCoordinate
+        case .changed:
+            let startZoom = centerAnchoredPinchStartZoom ?? mapView.zoomLevel
+            let center = centerAnchoredZoomCoordinate ?? mapView.centerCoordinate
+            let zoomDelta = log2(Double(max(gesture.scale, 0.0001)))
+            applyCenterAnchoredZoom(CGFloat(Double(startZoom) + zoomDelta), center: center)
+        case .ended, .cancelled, .failed:
+            centerAnchoredPinchStartZoom = nil
+            let velocity = gesture.velocity
+            if abs(velocity) > 0.1 {
+                zoomVelocity = Double(velocity) * 0.02
+                if centerAnchoredZoomCoordinate == nil {
+                    centerAnchoredZoomCoordinate = mapView.centerCoordinate
+                }
+                startInertiaAnimation()
+            } else {
+                centerAnchoredZoomCoordinate = nil
+            }
+        default:
+            break
+        }
+    }
+
+    private func applyCenterAnchoredZoom(_ zoom: CGFloat, center: CLLocationCoordinate2D) {
+        let validZoom = max(mapView.minZoomLevel, min(mapView.maxZoomLevel, zoom))
+        let status = MAMapStatus()
+        status.centerCoordinate = center
+        status.zoomLevel = validZoom
+        status.rotationDegree = mapView.rotationDegree
+        status.cameraDegree = mapView.cameraDegree
+        mapView.setMapStatus(status, animated: false, duration: 0)
+    }
     
     private func startInertiaAnimation() {
         stopInertiaAnimation()
@@ -476,12 +535,21 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
             // 碰到边界，停止动画
             newZoom = max(mapView.minZoomLevel, min(mapView.maxZoomLevel, newZoom))
             stopInertiaAnimation()
-            mapView.setZoomLevel(newZoom, animated: false)
+            if zoomGestureAnchor == "center" {
+                applyCenterAnchoredZoom(newZoom, center: centerAnchoredZoomCoordinate ?? mapView.centerCoordinate)
+                centerAnchoredZoomCoordinate = nil
+            } else {
+                mapView.setZoomLevel(newZoom, animated: false)
+            }
             return
         }
         
         // 更新地图缩放级别（animated: false 以保证逐帧控制的流畅性）
-        mapView.setZoomLevel(newZoom, animated: false)
+        if zoomGestureAnchor == "center" {
+            applyCenterAnchoredZoom(newZoom, center: centerAnchoredZoomCoordinate ?? mapView.centerCoordinate)
+        } else {
+            mapView.setZoomLevel(newZoom, animated: false)
+        }
         
         // 减速（应用摩擦力）
         zoomVelocity *= friction
@@ -489,6 +557,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         // 停止条件
         if abs(zoomVelocity) < velocityThreshold {
             stopInertiaAnimation()
+            centerAnchoredZoomCoordinate = nil
         }
     }
     
@@ -568,6 +637,9 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     func setFollowUserLocation(_ follow: Bool) {
         followUserLocation = follow
         uiManager?.setShowsUserLocation(showsUserLocation, followUser: follow)
+        if showsUserLocation {
+            applyUserLocationStyle()
+        }
     }
     
     func setShowsUserLocation(_ show: Bool) {
@@ -580,6 +652,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     
     func setUserLocationRepresentation(_ config: [String: Any]) {
         userLocationRepresentation = config
+        hasAppliedUserLocationStyleAfterLocationUpdate = false
         if showsUserLocation {
             uiManager?.setUserLocationRepresentation(config)
         }
@@ -589,7 +662,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
      * 应用用户位置样式
      */
     private func applyUserLocationStyle() {
-        guard let config = userLocationRepresentation else { return }
+        guard showsUserLocation, let config = userLocationRepresentation else { return }
         uiManager?.setUserLocationRepresentation(config)
     }
     
@@ -806,6 +879,9 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         pendingCameraMoveData = nil
         cameraMoveDispatchWorkItem?.cancel()
         cameraMoveDispatchWorkItem = nil
+        pendingCameraIdleData = nil
+        cameraIdleDispatchWorkItem?.cancel()
+        cameraIdleDispatchWorkItem = nil
         if let privacyObserver {
             NotificationCenter.default.removeObserver(privacyObserver)
         }
@@ -861,6 +937,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         super.addSubview(resolvedMapView)
         isMapLoaded = false
         hasAppliedInitialCameraPosition = false
+        hasAppliedUserLocationStyleAfterLocationUpdate = false
 
         cameraManager = CameraManager(mapView: resolvedMapView)
         uiManager = UIManager(mapView: resolvedMapView)
@@ -879,13 +956,20 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         pinchGesture.delegate = self
         resolvedMapView.addGestureRecognizer(pinchGesture)
         self.pinchGesture = pinchGesture
-        updatePinchGestureState()
+        applyZoomGestureSettings()
     }
 
-    private func updatePinchGestureState() {
+    private func applyZoomGestureSettings() {
+        uiManager?.setZoomEnabled(isZoomEnabled && zoomGestureAnchor != "center")
         pinchGesture?.isEnabled = isZoomEnabled
+        if zoomGestureAnchor != "center" {
+            centerAnchoredPinchStartZoom = nil
+            centerAnchoredZoomCoordinate = nil
+        }
         if !isZoomEnabled {
             stopInertiaAnimation()
+            centerAnchoredPinchStartZoom = nil
+            centerAnchoredZoomCoordinate = nil
         }
     }
 }
@@ -937,9 +1021,37 @@ extension ExpoGaodeMapView {
         if let styleData = customMapStyleData {
             uiManager?.setCustomMapStyle(styleData)
         }
+
+        applyUserLocationStyle()
         
         onLoad(["loaded": true])
     }
+
+    /**
+     * 定位更新回调
+     */
+    public func mapView(_ mapView: MAMapView, didUpdate userLocation: MAUserLocation, updatingLocation: Bool) {
+        guard updatingLocation, let location = userLocation.location else { return }
+
+        if !hasAppliedUserLocationStyleAfterLocationUpdate {
+            applyUserLocationStyle()
+            hasAppliedUserLocationStyleAfterLocationUpdate = true
+        }
+
+        let latitude = location.coordinate.latitude
+        let longitude = location.coordinate.longitude
+        guard latitude >= -90 && latitude <= 90,
+              longitude >= -180 && longitude <= 180 else {
+            return
+        }
+
+        onLocation([
+            "latitude": latitude,
+            "longitude": longitude,
+            "accuracy": location.horizontalAccuracy,
+            "timestamp": Date().timeIntervalSince1970 * 1000
+        ])
+    }
     
     /**
      * 地图区域即将改变时触发
@@ -958,7 +1070,7 @@ extension ExpoGaodeMapView {
      */
     public func mapView(_ mapView: MAMapView, regionDidChangeAnimated animated: Bool) {
         flushPendingCameraMoveEvent()
-        onCameraIdle(buildCameraEventData(for: mapView))
+        scheduleCameraIdleEvent(buildCameraEventData(for: mapView))
 
         // 这里的 overlayViews 是 [UIView] 类型，可能包含 ClusterView
         for view in overlayViews {
@@ -1038,6 +1150,27 @@ extension ExpoGaodeMapView {
         lastCameraMoveDispatchTime = timestamp
         onCameraMove(eventData)
     }
+
+    private func scheduleCameraIdleEvent(_ eventData: [String: Any]) {
+        pendingCameraIdleData = eventData
+        cameraIdleDispatchWorkItem?.cancel()
+
+        let workItem = DispatchWorkItem { [weak self] in
+            guard let self = self, let latestEventData = self.pendingCameraIdleData else {
+                return
+            }
+
+            self.pendingCameraIdleData = nil
+            self.cameraIdleDispatchWorkItem = nil
+            self.onCameraIdle(latestEventData)
+        }
+
+        cameraIdleDispatchWorkItem = workItem
+        DispatchQueue.main.asyncAfter(
+            deadline: .now() + Double(cameraIdleDebounceMs) / 1000.0,
+            execute: workItem
+        )
+    }
     
     /**
      * 地图单击事件
@@ -1262,13 +1395,118 @@ extension ExpoGaodeMapView {
         handleGaodePoiTouch(pois)
     }
     
+    private func getUserLocationAnnotationView(for mapView: MAMapView, annotation: MAAnnotation) -> MAAnnotationView? {
+        guard let config = userLocationRepresentation,
+              let imagePath = config["image"] as? String,
+              !imagePath.isEmpty else {
+            return nil
+        }
+
+        let reuseId = "ExpoGaodeMapUserLocationStyleReuseIdentifier"
+        let annotationView: MAAnnotationView
+        if let reusableView = mapView.dequeueReusableAnnotationView(withIdentifier: reuseId) {
+            annotationView = reusableView
+        } else {
+            annotationView = MAAnnotationView(annotation: annotation, reuseIdentifier: reuseId)
+        }
+        annotationView.annotation = annotation
+        annotationView.canShowCallout = false
+
+        let imageWidth = config["imageWidth"] as? Double
+        let imageHeight = config["imageHeight"] as? Double
+        let cacheKey = userLocationImageCacheKey(imagePath: imagePath, imageWidth: imageWidth, imageHeight: imageHeight)
+        annotationView.accessibilityIdentifier = cacheKey
+
+        if let cached = IconBitmapCache.shared.image(forKey: cacheKey) {
+            annotationView.image = cached
+            return annotationView
+        }
+
+        annotationView.image = nil
+        loadUserLocationImage(imagePath: imagePath, imageWidth: imageWidth, imageHeight: imageHeight, cacheKey: cacheKey) { [weak annotationView] image in
+            guard let annotationView = annotationView,
+                  annotationView.accessibilityIdentifier == cacheKey else {
+                return
+            }
+            annotationView.image = image
+        }
+
+        return annotationView
+    }
+
+    private func userLocationImageCacheKey(imagePath: String, imageWidth: Double?, imageHeight: Double?) -> String {
+        let widthPart = imageWidth.map { String(Int($0.rounded())) } ?? "auto"
+        let heightPart = imageHeight.map { String(Int($0.rounded())) } ?? "auto"
+        return "userLocation|\(imagePath)|\(widthPart)x\(heightPart)"
+    }
+
+    private func loadUserLocationImage(
+        imagePath: String,
+        imageWidth: Double?,
+        imageHeight: Double?,
+        cacheKey: String,
+        completion: @escaping (UIImage?) -> Void
+    ) {
+        let finish: (UIImage?) -> Void = { image in
+            if let image = image {
+                IconBitmapCache.shared.setImage(image, forKey: cacheKey)
+            }
+            DispatchQueue.main.async {
+                completion(image)
+            }
+        }
+
+        if imagePath.hasPrefix("http://") || imagePath.hasPrefix("https://") {
+            DispatchQueue.global(qos: .userInitiated).async { [weak self] in
+                guard let self = self,
+                      let url = URL(string: imagePath),
+                      let data = try? Data(contentsOf: url),
+                      let image = UIImage(data: data) else {
+                    finish(nil)
+                    return
+                }
+                finish(self.resizeUserLocationImage(image, imageWidth: imageWidth, imageHeight: imageHeight))
+            }
+            return
+        }
+
+        let image: UIImage?
+        if imagePath.hasPrefix("file://") {
+            let path = String(imagePath.dropFirst(7))
+            image = UIImage(contentsOfFile: path)
+        } else {
+            image = UIImage(named: imagePath)
+        }
+
+        guard let image = image else {
+            finish(nil)
+            return
+        }
+        finish(resizeUserLocationImage(image, imageWidth: imageWidth, imageHeight: imageHeight))
+    }
+
+    private func resizeUserLocationImage(_ image: UIImage, imageWidth: Double?, imageHeight: Double?) -> UIImage {
+        guard let imageWidth = imageWidth,
+              let imageHeight = imageHeight,
+              imageWidth > 0,
+              imageHeight > 0 else {
+            return image
+        }
+
+        let targetSize = CGSize(width: imageWidth, height: imageHeight)
+        let renderer = UIGraphicsImageRenderer(size: targetSize)
+        return renderer.image { _ in
+            image.draw(in: CGRect(origin: .zero, size: targetSize))
+        }
+    }
+
     /**
      * 创建标注视图
-     * 定位蓝点返回 nil 使用系统默认样式
+     * 定位蓝点默认返回 nil 使用系统样式；传入 image 时按官方建议自定义定位 annotationView。
      */
     public func mapView(_ mapView: MAMapView, viewFor annotation: MAAnnotation) -> MAAnnotationView? {
         if annotation.isKind(of: MAUserLocation.self) {
-            return nil
+            return getUserLocationAnnotationView(for: mapView, annotation: annotation)
         }
         
         // 🔑 支持 MAAnimatedAnnotation（平滑移动）

package/ios/ExpoGaodeMapViewModule.swift

@@ -43,6 +43,11 @@ public class ExpoGaodeMapViewModule: Module {
             Prop("zoomGesturesEnabled") { (view: ExpoGaodeMapView, enabled: Bool) in
                 view.isZoomEnabled = enabled
             }
+
+            // 缩放手势锚点：gesture 使用手势焦点，center 固定地图中心点
+            Prop("zoomGestureAnchor") { (view: ExpoGaodeMapView, anchor: String?) in
+                view.zoomGestureAnchor = anchor == "center" ? "center" : "gesture"
+            }
             
             Prop("scrollGesturesEnabled") { (view: ExpoGaodeMapView, enabled: Bool) in
                 view.isScrollEnabled = enabled

package/ios/managers/UIManager.swift

@@ -172,6 +172,9 @@ class UIManager: NSObject, MAMapViewDelegate {
         // 是否显示方向指示
         if let showsHeadingIndicator = config["showsHeadingIndicator"] as? Bool {
             representation.showsHeadingIndicator = showsHeadingIndicator
+            if showsHeadingIndicator {
+                mapView.userTrackingMode = .followWithHeading
+            }
         }
         
         // 精度圈填充颜色