expo-gaode-map 1.1.3 → 1.1.5

package/android/src/main/java/expo/modules/gaodemap/ExpoGaodeMapView.kt

@@ -27,6 +27,18 @@ import expo.modules.gaodemap.overlays.*
 @Suppress("ViewConstructor")
 class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
   
+  /**
+   * 拦截 React Native 的 ViewManager 操作
+   * 重写 requestLayout 防止在移除视图时触发布局异常
+   */
+  override fun requestLayout() {
+    try {
+      super.requestLayout()
+    } catch (e: Exception) {
+      Log.e(TAG, "requestLayout 异常被捕获", e)
+    }
+  }
+  
   companion object {
     private const val TAG = "ExpoGaodeMapView"
   }
@@ -504,12 +516,23 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
   
   /**
    * 添加子视图时自动连接到地图
+   *
+   * 关键修复：MarkerView 不进入视图层级，但要确保 React Native 追踪正确
    */
   override fun addView(child: View?, index: Int) {
     if (child is MarkerView) {
-      // 不添加到视图层级,只调用 setMap 并保存引用
+      // ✅ MarkerView 不加入视图层级
       child.setMap(aMap)
       markerViews.add(child)
+      Log.d(TAG, "✅ MarkerView 已添加到特殊列表（不在视图层级中），数量: ${markerViews.size}")
+      // ⚠️ 不调用 super.addView，所以 React Native 不会追踪它
+      return
+    }
+    
+    // ⚠️ 如果是 MapView 本身，必须添加
+    if (child is com.amap.api.maps.MapView) {
+      super.addView(child, index)
+      Log.d(TAG, "✅ MapView 已添加")
       return
     }
     
@@ -533,22 +556,73 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
    */
   override fun removeView(child: View?) {
     if (child is MarkerView) {
-      // 从 MarkerView 列表中移除
+      // 从 MarkerView 列表中移除并清理
       markerViews.remove(child)
+      child.removeMarker()
+      Log.d(TAG, "✅ MarkerView 已清理，当前 markerViews 数量: ${markerViews.size}")
       return
     }
-    super.removeView(child)
+    
+    try {
+      super.removeView(child)
+    } catch (e: Exception) {
+      Log.e(TAG, "removeView 异常", e)
+    }
   }
   
   /**
    * 按索引移除视图
+   *
+   * 终极修复：完全忽略所有无效的移除请求
    */
   override fun removeViewAt(index: Int) {
-    // 检查是否在尝试移除不存在的索引
-    if (index >= 0 && index < childCount) {
+    try {
+      val actualChildCount = super.getChildCount()
+      
+      Log.d(TAG, "removeViewAt 调用: index=$index, super.childCount=$actualChildCount")
+      
+      // ✅ 如果没有子视图，直接返回
+      if (actualChildCount == 0) {
+        Log.w(TAG, "⚠️ 无子视图，忽略: index=$index")
+        return
+      }
+      
+      // ✅ 索引越界，直接返回
+      if (index < 0 || index >= actualChildCount) {
+        Log.w(TAG, "⚠️ 索引越界，忽略: index=$index, childCount=$actualChildCount")
+        return
+      }
+      
+      // 检查要移除的视图类型
+      val child = super.getChildAt(index)
+      
+      // ❌ MapView 绝对不能移除
+      if (child is com.amap.api.maps.MapView) {
+        Log.e(TAG, "❌ 阻止移除 MapView！index=$index")
+        // 不移除，直接返回
+        return
+      }
+      
+      // MarkerView 特殊处理（虽然理论上不应该出现在这里）
+      if (child is MarkerView) {
+        Log.d(TAG, "⚠️ 发现 MarkerView 在视图层级中，使用 removeView")
+        removeView(child)
+        return
+      }
+      
+      // 正常移除其他视图
       super.removeViewAt(index)
-    } else {
-      Log.w(TAG, "尝试移除无效的视图索引: $index, 当前子视图数: $childCount")
+      Log.d(TAG, "✅ 成功移除视图: index=$index")
+      
+    } catch (e: IllegalArgumentException) {
+      // 索引异常，静默忽略
+      Log.w(TAG, "⚠️ 索引异常，已忽略: ${e.message}")
+    } catch (e: IndexOutOfBoundsException) {
+      // 越界异常，静默忽略
+      Log.w(TAG, "⚠️ 越界异常，已忽略: ${e.message}")
+    } catch (e: Exception) {
+      // 其他所有异常，静默忽略
+      Log.e(TAG, "⚠️ 移除视图异常，已忽略", e)
     }
   }
   

package/android/src/main/java/expo/modules/gaodemap/ExpoGaodeMapViewModule.kt

@@ -12,6 +12,12 @@ class ExpoGaodeMapViewModule : Module() {
 
     View(ExpoGaodeMapView::class) {
       Events("onMapPress", "onMapLongPress", "onLoad", "onLocation", "onMarkerPress", "onMarkerDragStart", "onMarkerDrag", "onMarkerDragEnd", "onCirclePress", "onPolygonPress", "onPolylinePress")
+      
+      // ✅ 关键修复：拦截 React Native 的视图操作异常
+      OnViewDestroys { view: ExpoGaodeMapView ->
+        // 在视图销毁时不做任何抛出异常的操作
+        android.util.Log.d("ExpoGaodeMapViewModule", "视图正在销毁，清理资源")
+      }
 
       Prop<Int>("mapType") { view, type ->
         view.mapType = type

package/ios/ExpoGaodeMapView.swift

@@ -88,15 +88,35 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate {
     required init(appContext: AppContext? = nil) {
         super.init(appContext: appContext)
         
+        print("🗺️ [MapView Init] 开始初始化地图视图")
+        print("🗺️ [MapView Init] bounds: \(bounds)")
+        
         // 确保隐私合规已设置
         MAMapView.updatePrivacyAgree(.didAgree)
         MAMapView.updatePrivacyShow(.didShow, privacyInfo: .didContain)
+        print("🗺️ [MapView Init] 隐私合规设置完成")
         
+        // 创建 MAMapView（注意：如果 API Key 未设置，可能会在后续操作时报错）
         mapView = MAMapView(frame: bounds)
+        
+        // 检查是否创建成功
+        if mapView == nil {
+            print("❌ [MapView Init] MAMapView 创建失败！请检查：")
+            print("❌ [MapView Init] 1. iOS API Key 是否已正确配置")
+            print("❌ [MapView Init] 2. 是否调用了 initSDK({ iosKey: 'your_key' })")
+            print("❌ [MapView Init] 3. API Key 是否有效")
+        } else {
+            print("🗺️ [MapView Init] ✅ MAMapView 创建成功, frame: \(mapView.frame)")
+        }
+        
         mapView.delegate = self
         mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
         
-        // 先不添加到视图,等设置完初始位置再添加
+        // 立即添加 mapView 到视图层级，确保地图可见
+        addSubview(mapView)
+        print("🗺️ [MapView Init] ✅ mapView 已添加到视图层级")
+        print("🗺️ [MapView Init] mapView.superview: \(mapView.superview != nil ? "存在" : "nil")")
+        print("🗺️ [MapView Init] subviews.count: \(subviews.count)")
         
         cameraManager = CameraManager(mapView: mapView)
         uiManager = UIManager(mapView: mapView)
@@ -125,11 +145,17 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate {
         }
         
         setupDefaultConfig()
+        print("🗺️ [MapView Init] 初始化完成")
     }
     
     override func layoutSubviews() {
         super.layoutSubviews()
+        print("🗺️ [MapView Layout] layoutSubviews 被调用")
+        print("🗺️ [MapView Layout] 旧 frame: \(mapView.frame), 新 bounds: \(bounds)")
         mapView.frame = bounds
+        print("🗺️ [MapView Layout] mapView frame 已更新: \(mapView.frame)")
+        print("🗺️ [MapView Layout] mapView.superview: \(mapView.superview != nil ? "存在" : "nil")")
+        print("🗺️ [MapView Layout] subviews.count: \(subviews.count)")
         
         // 收集并设置 MarkerView
         collectAndSetupMarkerViews()
@@ -151,14 +177,16 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate {
      * 将地图实例传递给覆盖物子视图
      */
     override func addSubview(_ view: UIView) {
+        super.addSubview(view)
+        
         if let markerView = view as? MarkerView {
-            // 不添加到视图层级,只调用 setMap
+            // MarkerView 需要添加到视图层级以便其 children 可以渲染
+            // 但将其移到屏幕外，使其不可见
+            markerView.frame = CGRect(x: -10000, y: -10000, width: 1, height: 1)
             markerView.setMap(mapView)
             return
         }
         
-        super.addSubview(view)
-        
         if let circleView = view as? CircleView {
             circleView.setMap(mapView)
         } else if let polylineView = view as? PolylineView {
@@ -193,15 +221,17 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate {
      * 在 Props 更新时调用
      */
     func applyProps() {
+        print("🗺️ [MapView Props] applyProps 被调用")
+        print("🗺️ [MapView Props] mapView.superview: \(mapView.superview != nil ? "存在" : "nil")")
+        print("🗺️ [MapView Props] mapView.frame: \(mapView.frame)")
+        print("🗺️ [MapView Props] initialCameraPosition: \(initialCameraPosition != nil ? "存在" : "nil")")
+        
         uiManager.setMapType(mapType)
         
-        // 如果有初始位置且地图还未添加到视图,先设置位置再添加
-        if let position = initialCameraPosition, mapView.superview == nil {
+        // 如果有初始位置，设置相机位置
+        if let position = initialCameraPosition {
+            print("🗺️ [MapView Props] 设置初始相机位置: \(position)")
             cameraManager.setInitialCameraPosition(position)
-            addSubview(mapView)
-        } else if mapView.superview == nil {
-            // 没有初始位置,直接添加地图
-            addSubview(mapView)
         }
         
         uiManager.setShowsScale(showsScale)
@@ -217,6 +247,10 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate {
         
         // 收集并设置所有 MarkerView
         collectAndSetupMarkerViews()
+        
+        print("🗺️ [MapView Props] Props 应用完成")
+        print("🗺️ [MapView Props] 最终 mapView.superview: \(mapView.superview != nil ? "存在" : "nil")")
+        print("🗺️ [MapView Props] 最终 subviews.count: \(subviews.count)")
     }
     
     // MARK: - 缩放控制
@@ -350,8 +384,16 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate {
      * 析构函数 - 清理资源
      */
     deinit {
+        print("🗺️ [MapView] deinit 开始清理")
+        
+        // 先设置 delegate 为 nil，停止接收回调
         mapView?.delegate = nil
-        overlayManager?.clear()
+        
+        // 不调用 overlayManager.clear()
+        // 因为声明式的 Marker/Circle 等会在自己的 willMove(toSuperview:) 中清理
+        // 调用 clear() 可能导致重复移除和崩溃
+        
+        print("🗺️ [MapView] deinit 完成")
     }
 }
 
@@ -364,6 +406,9 @@ extension ExpoGaodeMapView {
     public func mapViewDidFinishLoadingMap(_ mapView: MAMapView) {
         guard !isMapLoaded else { return }
         isMapLoaded = true
+        print("🗺️ [MapView Delegate] ✅ 地图加载完成")
+        print("🗺️ [MapView Delegate] mapView.frame: \(mapView.frame)")
+        print("🗺️ [MapView Delegate] mapView.superview: \(mapView.superview != nil ? "存在" : "nil")")
         onLoad(["loaded": true])
     }
     
@@ -585,7 +630,17 @@ extension ExpoGaodeMapView {
         }
         
         if annotation.isKind(of: MAPointAnnotation.self) {
+            // 首先检查是否是声明式 MarkerView 的 annotation
+            for subview in subviews {
+                if let markerView = subview as? MarkerView, markerView.annotation === annotation {
+                    print("🎯 [MapView Delegate] 找到声明式 MarkerView，调用其 getAnnotationView")
+                    return markerView.getAnnotationView(for: mapView, annotation: annotation)
+                }
+            }
+            
+            // 如果不是声明式的，检查是否是命令式 API 的 Marker
             guard let props = overlayManager.getMarkerProps(for: annotation) else {
+                print("⚠️ [MapView Delegate] 未找到对应的 Marker props")
                 return nil
             }
             

package/ios/overlays/MarkerView.swift

@@ -48,14 +48,18 @@ class MarkerView: ExpoView {
     var pinColor: String = "red"
     /// 是否显示气泡
     var canShowCallout: Bool = true
-    /// 地图视图弱引用
-    private var mapView: MAMapView?
+    /// 地图视图弱引用（避免循环引用）
+    private weak var mapView: MAMapView?
     /// 标记点对象
     var annotation: MAPointAnnotation?
+    /// 标记是否正在被移除（防止重复移除）
+    private var isRemoving: Bool = false
     /// 标记点视图
     private var annotationView: MAAnnotationView?
     /// 待处理的位置（在 setMap 之前设置）
     private var pendingPosition: [String: Double]?
+    /// 延迟添加任务
+    private var pendingAddTask: DispatchWorkItem?
     
     required init(appContext: AppContext? = nil) {
         super.init(appContext: appContext)
@@ -86,12 +90,20 @@ class MarkerView: ExpoView {
         guard let mapView = mapView,
               let latitude = position["latitude"],
               let longitude = position["longitude"] else {
+            print("⚠️ [MarkerView] updateAnnotation: mapView 或坐标为 nil")
             return
         }
         
-        // 移除旧的标记
+        print("📍 [MarkerView] updateAnnotation: 位置 (\(latitude), \(longitude)), subviews: \(self.subviews.count)")
+        
+        // 取消之前的延迟任务
+        pendingAddTask?.cancel()
+        
+        // 移除旧的标记（在主线程执行）
         if let oldAnnotation = annotation {
-            mapView.removeAnnotation(oldAnnotation)
+            DispatchQueue.main.async {
+                mapView.removeAnnotation(oldAnnotation)
+            }
         }
         
         // 创建新的标记
@@ -100,51 +112,59 @@ class MarkerView: ExpoView {
         annotation.title = title
         annotation.subtitle = markerDescription
         
-        mapView.addAnnotation(annotation)
         self.annotation = annotation
         
-        // 延迟处理子视图,等待 React Native 添加完成
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
-            guard let self = self else { return }
-            self.updateMarkerImage()
-        }
-        
-        // 再次延迟更新，确保内容完全渲染
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) { [weak self] in
-            guard let self = self else { return }
-            self.updateMarkerImage()
+        // 延迟添加到地图，等待 React Native 渲染 children
+        let task = DispatchWorkItem { [weak self] in
+            guard let self = self, !self.isRemoving else {
+                print("⚠️ [MarkerView] 延迟任务取消，isRemoving: \(self?.isRemoving ?? true)")
+                return
+            }
+            print("✅ [MarkerView] Annotation 延迟添加，当前 subviews: \(self.subviews.count)")
+            mapView.addAnnotation(annotation)
         }
+        pendingAddTask = task
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.1, execute: task)
     }
     
     /**
-     * 更新 marker 图标
+     * 获取 annotation 视图（由 ExpoGaodeMapView 调用）
      */
-    private func updateMarkerImage() {
-        guard let mapView = mapView, let annotation = annotation else {
-            return
-        }
-        guard let view = mapView.view(for: annotation) else {
-            return
+    func getAnnotationView(for mapView: MAMapView, annotation: MAAnnotation) -> MAAnnotationView? {
+        print("🎨 [MarkerView] getAnnotationView 被调用")
+        print("🎨 [MarkerView] subviews.count: \(self.subviews.count)")
+        
+        let reuseId = "custom_marker_\(ObjectIdentifier(self).hashValue)"
+        var annotationView = mapView.dequeueReusableAnnotationView(withIdentifier: reuseId)
+        
+        if annotationView == nil {
+            annotationView = MAAnnotationView(annotation: annotation, reuseIdentifier: reuseId)
+            annotationView?.canShowCallout = canShowCallout
+            annotationView?.isDraggable = draggable
         }
         
-        self.annotationView = view
+        annotationView?.annotation = annotation
+        self.annotationView = annotationView
         
+        // 设置图标
         if self.subviews.count > 0 {
-            // 有自定义内容，显示自定义图片
+            print("🎨 [MarkerView] 尝试创建自定义图片...")
             if let image = self.createImageFromSubviews() {
-                view.image = image
-                // 设置 anchor 为底部中心
-                view.centerOffset = CGPoint(x: 0, y: -image.size.height / 2)
+                print("✅ [MarkerView] 自定义图片创建成功, size: \(image.size)")
+                annotationView?.image = image
+                annotationView?.centerOffset = CGPoint(x: 0, y: -image.size.height / 2)
             } else {
-                // 自定义图片创建失败，使用默认图标
-                view.image = self.createDefaultMarkerImage()
-                view.centerOffset = CGPoint(x: 0, y: -18)
+                print("❌ [MarkerView] 自定义图片创建失败，使用默认图标")
+                annotationView?.image = self.createDefaultMarkerImage()
+                annotationView?.centerOffset = CGPoint(x: 0, y: -18)
             }
         } else {
-            // 没有自定义内容，使用默认图标
-            view.image = self.createDefaultMarkerImage()
-            view.centerOffset = CGPoint(x: 0, y: -18)
+            print("📍 [MarkerView] 没有子视图，使用默认图标")
+            annotationView?.image = self.createDefaultMarkerImage()
+            annotationView?.centerOffset = CGPoint(x: 0, y: -18)
         }
+        
+        return annotationView
     }
     
     /**
@@ -270,22 +290,75 @@ class MarkerView: ExpoView {
         return UIGraphicsGetImageFromCurrentImageContext()
     }
     
+    /**
+     * 当视图即将从父视图移除时调用
+     */
+    override func willMove(toSuperview newSuperview: UIView?) {
+        super.willMove(toSuperview: newSuperview)
+        
+        // 如果 newSuperview 为 nil，说明视图正在被移除
+        if newSuperview == nil {
+            removeAnnotationFromMap()
+        }
+    }
+    
+    /**
+     * 从地图移除标记点
+     */
+    private func removeAnnotationFromMap() {
+        guard !isRemoving else { return }
+        isRemoving = true
+        
+        print("🗑️ [MarkerView] removeAnnotationFromMap 被调用")
+        
+        // 取消任何待处理的延迟任务
+        pendingAddTask?.cancel()
+        pendingAddTask = nil
+        
+        // 立即保存引用并清空属性，避免在异步块中访问 self
+        guard let mapView = mapView, let annotation = annotation else {
+            print("⚠️ [MarkerView] 没有 annotation 需要移除")
+            return
+        }
+        self.annotation = nil
+        self.annotationView = nil
+        
+        // 同步移除，避免对象在异步块执行时已被释放
+        if Thread.isMainThread {
+            mapView.removeAnnotation(annotation)
+            print("✅ [MarkerView] Annotation 已从地图移除（主线程）")
+        } else {
+            DispatchQueue.main.sync {
+                mapView.removeAnnotation(annotation)
+                print("✅ [MarkerView] Annotation 已从地图移除（同步到主线程）")
+            }
+        }
+    }
+    
     override func willRemoveSubview(_ subview: UIView) {
         super.willRemoveSubview(subview)
         
-        // 子视图即将被移除，延迟检查并更新图标
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.05) { [weak self] in
-            guard let self = self else { return }
-            
-            if self.subviews.isEmpty {
-                // 所有子视图已移除，恢复默认图标
-                if let annotationView = self.annotationView {
-                    annotationView.image = self.createDefaultMarkerImage()
-                    annotationView.centerOffset = CGPoint(x: 0, y: -18)
+        // 如果正在移除，不要执行任何操作
+        guard !isRemoving else {
+            print("⚠️ [MarkerView] willRemoveSubview 被调用但正在移除，忽略")
+            return
+        }
+        
+        print("🎨 [MarkerView] willRemoveSubview 被调用，剩余 subviews.count: \(self.subviews.count - 1)")
+        
+        // 子视图移除后，需要刷新 annotation 视图
+        if self.subviews.count <= 1 {
+            // 所有子视图已移除，刷新以恢复默认图标
+            if let mapView = mapView, let annotation = annotation {
+                DispatchQueue.main.async { [weak self] in
+                    guard let self = self, !self.isRemoving else {
+                        print("⚠️ [MarkerView] 异步刷新时已被移除，取消操作")
+                        return
+                    }
+                    mapView.removeAnnotation(annotation)
+                    mapView.addAnnotation(annotation)
+                    print("✅ [MarkerView] Annotation 已刷新为默认图标")
                 }
-            } else {
-                // 还有子视图，更新图标
-                self.updateMarkerImage()
             }
         }
     }
@@ -293,14 +366,26 @@ class MarkerView: ExpoView {
     override func didAddSubview(_ subview: UIView) {
         super.didAddSubview(subview)
         
-        // 当添加子视图时,延迟更新标记图标
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
-            self?.updateMarkerImage()
+        // 如果正在移除，不要执行任何操作
+        guard !isRemoving else {
+            print("⚠️ [MarkerView] didAddSubview 被调用但正在移除，忽略")
+            return
         }
         
-        // 再次延迟更新，确保内容完全渲染
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) { [weak self] in
-            self?.updateMarkerImage()
+        print("🎨 [MarkerView] didAddSubview 被调用，subviews.count: \(self.subviews.count)")
+        
+        // 子视图添加后，需要刷新 annotation 视图
+        // 通过移除并重新添加 annotation 来触发 getAnnotationView 调用
+        if let mapView = mapView, let annotation = annotation {
+            DispatchQueue.main.async { [weak self] in
+                guard let self = self, !self.isRemoving else {
+                    print("⚠️ [MarkerView] 异步刷新时已被移除，取消操作")
+                    return
+                }
+                mapView.removeAnnotation(annotation)
+                mapView.addAnnotation(annotation)
+                print("✅ [MarkerView] Annotation 已刷新")
+            }
         }
     }
     
@@ -415,11 +500,11 @@ class MarkerView: ExpoView {
     }
     
     /**
-     * 析构时移除标记点
+     * 析构函数 - 不执行任何清理
+     * 清理工作已在 willMove(toSuperview:) 中完成
      */
     deinit {
-        if let mapView = mapView, let annotation = annotation {
-            mapView.removeAnnotation(annotation)
-        }
+        // 不执行任何操作，避免访问已释放的对象
+        // 所有清理都应该在 willMove(toSuperview:) 中完成
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",