expo-gaode-map 1.0.2 → 1.0.4

package/docs/INITIALIZATION.md

@@ -216,9 +216,10 @@ export default function App() {
    - ✅ 提供默认位置作为后备方案
 
 3. **地图渲染**:
-   - ✅ 等待初始化完成后再渲染地图
+   - ✅ **重要**: 等待 `initialPosition` 设置后再渲染 MapView
    - ✅ 使用 `initialCameraPosition` 设置初始位置
-   - ✅ Android 和 iOS 会自动处理位置更新
+   - ⚠️ **iOS 注意**: 如果在获取位置前就渲染地图,会先显示默认位置(北京)再跳转,造成闪烁
+   - ✅ Android 和 iOS 都会在地图显示时直接定位到指定位置
 
 ## 常见问题
 
@@ -264,11 +265,18 @@ await mapRef.current?.moveCamera({
 
 ### Q: 如何配置定位参数?
 
-**A:** 使用 `configure` 函数:
+**A:** 使用 `configure` 函数,**必须在 `initSDK` 之后调用**:
 
 ```tsx
-import { configure } from 'expo-gaode-map';
+import { initSDK, configure } from 'expo-gaode-map';
 
+// 1. 先初始化 SDK
+initSDK({
+  androidKey: 'your-android-api-key',
+  iosKey: 'your-ios-api-key',
+});
+
+// 2. 再配置定位参数
 configure({
   withReGeocode: true,  // 返回地址信息
   mode: 0,              // 高精度模式
@@ -276,6 +284,8 @@ configure({
 });
 ```
 
+> ⚠️ **重要**: `configure` 必须在 `initSDK` 之后调用,否则配置可能不生效。
+
 ### Q: Android 和 iOS 的初始化有区别吗?
 
 **A:** 初始化流程相同,但有以下差异:

package/expo-module.config.json

@@ -1,5 +1,5 @@
 {
-  "platforms": ["apple", "android", "web"],
+  "platforms": ["apple", "android"],
   "apple": {
     "modules": ["ExpoGaodeMapModule"]
   },

package/ios/ExpoGaodeMapModule.swift

@@ -180,6 +180,69 @@ public class ExpoGaodeMapModule: Module {
             self.getLocationManager().stopUpdatingHeading()
         }
         
+        /**
+         * 设置逆地理语言 (iOS 实现)
+         */
+        Function("setGeoLanguage") { (language: Int) in
+            self.getLocationManager().setGeoLanguage(language)
+        }
+        
+        /**
+         * 设置是否单次定位 (Android 专用,iOS 空实现)
+         */
+        Function("setOnceLocation") { (_: Bool) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置是否使用设备传感器 (Android 专用,iOS 空实现)
+         */
+        Function("setSensorEnable") { (_: Bool) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置是否允许 WIFI 扫描 (Android 专用,iOS 空实现)
+         */
+        Function("setWifiScan") { (_: Bool) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置是否 GPS 优先 (Android 专用,iOS 空实现)
+         */
+        Function("setGpsFirst") { (_: Bool) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置是否等待 WIFI 列表刷新 (Android 专用,iOS 空实现)
+         */
+        Function("setOnceLocationLatest") { (_: Bool) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置是否使用缓存策略 (Android 专用,iOS 空实现)
+         */
+        Function("setLocationCacheEnable") { (_: Bool) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置网络请求超时时间 (Android 专用,iOS 空实现)
+         */
+        Function("setHttpTimeOut") { (_: Int) in
+            // iOS 不支持此配置
+        }
+        
+        /**
+         * 设置定位协议 (未实现)
+         */
+        Function("setLocationProtocol") { (_: Int) in
+            // 未实现
+        }
+        
         // ==================== 权限管理 ====================
         
         /**
@@ -204,10 +267,21 @@ public class ExpoGaodeMapModule: Module {
             }
             
             self.permissionManager?.requestPermission { granted, status in
-                promise.resolve([
-                    "granted": granted,
-                    "status": status
-                ])
+                print("🔐 [PermissionManager] 权限回调: granted=\(granted), status=\(status)")
+                
+                // 无论结果如何,都延迟后再次检查最终状态
+                DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
+                    let finalStatus = CLLocationManager.authorizationStatus()
+                    let finalGranted = finalStatus == .authorizedAlways || finalStatus == .authorizedWhenInUse
+                    let finalStatusString = self.getAuthorizationStatusString(finalStatus)
+                    
+                    print("🔐 [PermissionManager] 最终状态: granted=\(finalGranted), status=\(finalStatusString)")
+                    
+                    promise.resolve([
+                        "granted": finalGranted,
+                        "status": finalStatusString
+                    ])
+                }
             }
         }
         
@@ -221,7 +295,7 @@ public class ExpoGaodeMapModule: Module {
         
         View(ExpoGaodeMapView.self) {
             // 事件 - 使用 Expo 的事件命名约定
-            Events("onMapPress", "onMapLongPress", "onLoad")
+            Events("onMapPress", "onMapLongPress", "onLoad", "onMarkerPress", "onMarkerDragStart", "onMarkerDrag", "onMarkerDragEnd", "onCirclePress", "onPolygonPress", "onPolylinePress")
             
             // 地图类型
             Prop("mapType") { (view: ExpoGaodeMapView, type: Int) in
@@ -390,13 +464,41 @@ public class ExpoGaodeMapModule: Module {
                 view.setTitle(title)
             }
             
-            Prop("description") { (view: MarkerView, description: String) in
-                view.setDescription(description)
+            Prop("snippet") { (view: MarkerView, snippet: String) in
+                view.setDescription(snippet)
             }
             
             Prop("draggable") { (view: MarkerView, draggable: Bool) in
                 view.setDraggable(draggable)
             }
+            
+            Prop("icon") { (view: MarkerView, source: [String: Any]?) in
+                view.setIcon(source)
+            }
+            
+            Prop("iconWidth") { (view: MarkerView, width: Double) in
+                view.iconWidth = width
+            }
+            
+            Prop("iconHeight") { (view: MarkerView, height: Double) in
+                view.iconHeight = height
+            }
+            
+            Prop("centerOffset") { (view: MarkerView, offset: [String: Double]) in
+                view.setCenterOffset(offset)
+            }
+            
+            Prop("animatesDrop") { (view: MarkerView, animate: Bool) in
+                view.setAnimatesDrop(animate)
+            }
+            
+            Prop("pinColor") { (view: MarkerView, color: String) in
+                view.setPinColor(color)
+            }
+            
+            Prop("canShowCallout") { (view: MarkerView, show: Bool) in
+                view.setCanShowCallout(show)
+            }
         }
         
         // Circle - 圆形
@@ -411,16 +513,16 @@ public class ExpoGaodeMapModule: Module {
                 view.setRadius(radius)
             }
             
-            Prop("fillColor") { (view: CircleView, color: Int) in
+            Prop("fillColor") { (view: CircleView, color: String) in
                 view.setFillColor(color)
             }
             
-            Prop("strokeColor") { (view: CircleView, color: Int) in
+            Prop("strokeColor") { (view: CircleView, color: String) in
                 view.setStrokeColor(color)
             }
             
-            Prop("strokeWidth") { (view: CircleView, width: Float) in
-                view.setStrokeWidth(width)
+            Prop("strokeWidth") { (view: CircleView, width: Double) in
+                view.setStrokeWidth(Float(width))
             }
         }
         
@@ -432,17 +534,29 @@ public class ExpoGaodeMapModule: Module {
                 view.setPoints(points)
             }
             
-            Prop("strokeWidth") { (view: PolylineView, width: Float) in
-                view.setStrokeWidth(width)
+            Prop("width") { (view: PolylineView, width: Double) in
+                view.setStrokeWidth(Float(width))
             }
             
-            Prop("strokeColor") { (view: PolylineView, color: Int) in
+            Prop("strokeWidth") { (view: PolylineView, width: Double) in
+                view.setStrokeWidth(Float(width))
+            }
+            
+            Prop("color") { (view: PolylineView, color: String) in
+                view.setStrokeColor(color)
+            }
+            
+            Prop("strokeColor") { (view: PolylineView, color: String) in
                 view.setStrokeColor(color)
             }
             
             Prop("texture") { (view: PolylineView, url: String?) in
                 view.setTexture(url)
             }
+            
+            Prop("dotted") { (view: PolylineView, dotted: Bool) in
+                view.setDotted(dotted)
+            }
         }
         
         // Polygon - 多边形
@@ -453,16 +567,16 @@ public class ExpoGaodeMapModule: Module {
                 view.setPoints(points)
             }
             
-            Prop("fillColor") { (view: PolygonView, color: Int) in
+            Prop("fillColor") { (view: PolygonView, color: String) in
                 view.setFillColor(color)
             }
             
-            Prop("strokeColor") { (view: PolygonView, color: Int) in
+            Prop("strokeColor") { (view: PolygonView, color: String) in
                 view.setStrokeColor(color)
             }
             
-            Prop("strokeWidth") { (view: PolygonView, width: Float) in
-                view.setStrokeWidth(width)
+            Prop("strokeWidth") { (view: PolygonView, width: Double) in
+                view.setStrokeWidth(Float(width))
             }
         }