expo-gaode-map 1.0.3 → 1.0.4

package/ios/managers/OverlayManager.swift

@@ -24,6 +24,14 @@ class OverlayManager {
     var onCirclePress: (([String: Any]) -> Void)?
     /// Circle ID 映射 (overlay -> id)
     private var circleIdMap: [MACircle: String] = [:]
+    /// Polygon ID 映射 (overlay -> id)
+    private var polygonIdMap: [MAPolygon: String] = [:]
+    /// Polyline ID 映射 (overlay -> id)
+    private var polylineIdMap: [MAPolyline: String] = [:]
+    /// Polygon 点击回调
+    var onPolygonPress: (([String: Any]) -> Void)?
+    /// Polyline 点击回调
+    var onPolylinePress: (([String: Any]) -> Void)?
     
     /**
      * 初始化覆盖物管理器
@@ -191,6 +199,7 @@ class OverlayManager {
         // 先保存样式和 overlay，再添加到地图
         overlayStyles[id] = props
         overlays[id] = polyline
+        polylineIdMap[polyline] = id
         mapView.add(polyline)
     }
     
@@ -199,10 +208,11 @@ class OverlayManager {
      * @param id 折线唯一标识
      */
     func removePolyline(id: String) {
-        guard let mapView = mapView, let polyline = overlays[id] else { return }
+        guard let mapView = mapView, let polyline = overlays[id] as? MAPolyline else { return }
         mapView.remove(polyline)
         overlays.removeValue(forKey: id)
         overlayStyles.removeValue(forKey: id)
+        polylineIdMap.removeValue(forKey: polyline)
     }
     
     /**
@@ -234,6 +244,7 @@ class OverlayManager {
         let polygon = MAPolygon(coordinates: &coordinates, count: UInt(coordinates.count))
         overlayStyles[id] = props
         overlays[id] = polygon
+        polygonIdMap[polygon!] = id
         mapView.add(polygon!)
     }
     
@@ -242,10 +253,11 @@ class OverlayManager {
      * @param id 多边形唯一标识
      */
     func removePolygon(id: String) {
-        guard let mapView = mapView, let polygon = overlays[id] else { return }
+        guard let mapView = mapView, let polygon = overlays[id] as? MAPolygon else { return }
         mapView.remove(polygon)
         overlays.removeValue(forKey: id)
         overlayStyles.removeValue(forKey: id)
+        polygonIdMap.removeValue(forKey: polygon)
     }
     
     /**
@@ -293,13 +305,13 @@ class OverlayManager {
             // 设置线宽
             if let width = style?["width"] as? Double {
                 renderer.lineWidth = CGFloat(width)
-                print("🔷 OverlayManager: width=\(width)")
+               
             } else if let strokeWidth = style?["strokeWidth"] as? Double {
                 renderer.lineWidth = CGFloat(strokeWidth)
-                print("🔷 OverlayManager: strokeWidth=\(strokeWidth)")
+              
             } else {
                 renderer.lineWidth = 8
-                print("🔷 OverlayManager: 使用默认 width=8")
+               
             }
             
             // 设置线条样式
@@ -337,18 +349,18 @@ class OverlayManager {
             if let fillColor = style?["fillColor"] {
                 let parsedColor = ColorParser.parseColor(fillColor)
                 renderer.fillColor = parsedColor
-                print("🔶 OverlayManager: fillColor=\(fillColor) -> \(String(describing: parsedColor))")
+              
             }
             // 设置边框颜色
             if let strokeColor = style?["strokeColor"] {
                 let parsedColor = ColorParser.parseColor(strokeColor)
                 renderer.strokeColor = parsedColor
-                print("🔶 OverlayManager: strokeColor=\(strokeColor) -> \(String(describing: parsedColor))")
+               
             }
             // 设置边框宽度
             if let strokeWidth = style?["strokeWidth"] as? Double {
                 renderer.lineWidth = CGFloat(strokeWidth)
-                print("🔶 OverlayManager: strokeWidth=\(strokeWidth)")
+              
             }
             
             return renderer
@@ -402,6 +414,99 @@ class OverlayManager {
         renderer.strokeImage = image
     }
     
+    /**
+     * 检查点击位置是否在多边形内
+     */
+    func checkPolygonPress(at coordinate: CLLocationCoordinate2D) -> Bool {
+        for (polygon, polygonId) in polygonIdMap {
+            let count = Int(polygon.pointCount)
+            guard count >= 3 else { continue }
+            
+            var coords = [CLLocationCoordinate2D](repeating: CLLocationCoordinate2D(), count: count)
+            polygon.getCoordinates(&coords, range: NSRange(location: 0, length: count))
+            
+            if isPoint(coordinate, inPolygon: coords) {
+                onPolygonPress?([
+                    "polygonId": polygonId,
+                    "latitude": coordinate.latitude,
+                    "longitude": coordinate.longitude
+                ])
+                return true
+            }
+        }
+        return false
+    }
+    
+    /**
+     * 检查点击位置是否在折线附近
+     */
+    func checkPolylinePress(at coordinate: CLLocationCoordinate2D) -> Bool {
+        let threshold: Double = 20.0
+        for (polyline, polylineId) in polylineIdMap {
+            let count = Int(polyline.pointCount)
+            guard count >= 2 else { continue }
+            
+            var coords = [CLLocationCoordinate2D](repeating: CLLocationCoordinate2D(), count: count)
+            polyline.getCoordinates(&coords, range: NSRange(location: 0, length: count))
+            
+            if isPoint(coordinate, nearPolyline: coords, threshold: threshold) {
+                onPolylinePress?([
+                    "polylineId": polylineId,
+                    "latitude": coordinate.latitude,
+                    "longitude": coordinate.longitude
+                ])
+                return true
+            }
+        }
+        return false
+    }
+    
+    private func isPoint(_ point: CLLocationCoordinate2D, inPolygon coords: [CLLocationCoordinate2D]) -> Bool {
+        var inside = false
+        var j = coords.count - 1
+        
+        for i in 0..<coords.count {
+            if ((coords[i].latitude > point.latitude) != (coords[j].latitude > point.latitude)) {
+                let slope = (coords[j].longitude - coords[i].longitude) * (point.latitude - coords[i].latitude) / (coords[j].latitude - coords[i].latitude)
+                if point.longitude < slope + coords[i].longitude {
+                    inside = !inside
+                }
+            }
+            j = i
+        }
+        return inside
+    }
+    
+    private func isPoint(_ point: CLLocationCoordinate2D, nearPolyline coords: [CLLocationCoordinate2D], threshold: Double) -> Bool {
+        for i in 0..<(coords.count - 1) {
+            let distance = distanceFromPoint(point, toLineSegment: (coords[i], coords[i + 1]))
+            if distance <= threshold {
+                return true
+            }
+        }
+        return false
+    }
+    
+    private func distanceFromPoint(_ point: CLLocationCoordinate2D, toLineSegment line: (CLLocationCoordinate2D, CLLocationCoordinate2D)) -> Double {
+        let p = CLLocation(latitude: point.latitude, longitude: point.longitude)
+        let a = CLLocation(latitude: line.0.latitude, longitude: line.0.longitude)
+        let b = CLLocation(latitude: line.1.latitude, longitude: line.1.longitude)
+        
+        let ab = a.distance(from: b)
+        if ab == 0 { return a.distance(from: p) }
+        
+        let t = max(0, min(1, ((p.coordinate.latitude - a.coordinate.latitude) * (b.coordinate.latitude - a.coordinate.latitude) +
+                               (p.coordinate.longitude - a.coordinate.longitude) * (b.coordinate.longitude - a.coordinate.longitude)) /
+                              (ab * ab)))
+        
+        let projection = CLLocationCoordinate2D(
+            latitude: a.coordinate.latitude + t * (b.coordinate.latitude - a.coordinate.latitude),
+            longitude: a.coordinate.longitude + t * (b.coordinate.longitude - a.coordinate.longitude)
+        )
+        
+        return p.distance(from: CLLocation(latitude: projection.latitude, longitude: projection.longitude))
+    }
+    
     /**
      * 清除所有覆盖物和标记点
      */
@@ -416,5 +521,8 @@ class OverlayManager {
         overlays.removeAll()
         overlayStyles.removeAll()
         annotations.removeAll()
+        circleIdMap.removeAll()
+        polygonIdMap.removeAll()
+        polylineIdMap.removeAll()
     }
 }

package/ios/modules/LocationManager.swift

@@ -179,6 +179,9 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
         locationManager?.locationTimeout = 1
         locationManager?.reGeocodeTimeout = 1
         locationManager?.locatingWithReGeocode = true
+        
+        // iOS 9 之前:防止后台被系统挂起(默认关闭,用户可通过 setPausesLocationUpdatesAutomatically 配置)
+        locationManager?.pausesLocationUpdatesAutomatically = false
     }
     
     // MARK: - AMapLocationManagerDelegate

package/ios/overlays/PolygonView.swift

@@ -10,6 +10,8 @@ import MAMapKit
  * - 响应属性变化并更新渲染
  */
 class PolygonView: ExpoView {
+    let onPress = EventDispatcher()
+    
     /// 多边形点数组
     var points: [[String: Double]] = []
     /// 填充颜色

package/ios/overlays/PolylineView.swift

@@ -16,9 +16,14 @@ class PolylineView: ExpoView {
     var strokeWidth: Float = 0
     /// 线条颜色
     var strokeColor: Any?
+    /// 是否虚线
+    var isDotted: Bool = false
     /// 纹理图片 URL
     var textureUrl: String?
     
+    /// 点击事件派发器
+    let onPress = EventDispatcher()
+    
     /// 地图视图弱引用
     private var mapView: MAMapView?
     /// 折线覆盖物对象
@@ -77,6 +82,9 @@ class PolylineView: ExpoView {
             renderer = MAPolylineRenderer(polyline: polyline)
             renderer?.lineWidth = CGFloat(strokeWidth)
             
+            // 注意: iOS 高德地图 SDK 不支持简单的虚线设置
+            // 需要使用 MAMultiPolyline 实现虚线,暂不支持
+            
             if let url = textureUrl {
                 print("🔷 PolylineView.getRenderer: 加载纹理 \(url)")
                 loadTexture(url: url, renderer: renderer!)
@@ -179,6 +187,12 @@ class PolylineView: ExpoView {
         updatePolyline()
     }
     
+    func setDotted(_ dotted: Bool) {
+        isDotted = dotted
+        renderer = nil
+        updatePolyline()
+    }
+    
     /**
      * 析构时移除折线
      */

package/ios/utils/PermissionManager.swift

@@ -20,24 +20,79 @@ class PermissionManager: NSObject, CLLocationManagerDelegate {
      * @param callback 权限结果回调 (granted, status)
      */
     func requestPermission(callback: @escaping (Bool, String) -> Void) {
+        print("🔐 [PermissionManager] requestPermission 被调用")
         self.permissionCallback = callback
         
-        if locationManager == nil {
-            locationManager = CLLocationManager()
-            locationManager?.delegate = self
+        // 确保在主线程操作
+        DispatchQueue.main.async { [weak self] in
+            guard let self = self else { return }
+            
+            if self.locationManager == nil {
+                print("🔐 [PermissionManager] 创建 CLLocationManager")
+                self.locationManager = CLLocationManager()
+                self.locationManager?.delegate = self
+                print("🔐 [PermissionManager] delegate 已设置: \(self.locationManager?.delegate != nil)")
+            }
+            
+            let currentStatus = CLLocationManager.authorizationStatus()
+            print("🔐 [PermissionManager] 当前权限状态: \(self.getAuthorizationStatusString(currentStatus))")
+            
+            // 如果已经有权限,直接返回
+            if currentStatus == .authorizedAlways || currentStatus == .authorizedWhenInUse {
+                print("🔐 [PermissionManager] 已有权限,直接返回")
+                self.permissionCallback?(true, self.getAuthorizationStatusString(currentStatus))
+                self.permissionCallback = nil
+                return
+            }
+            
+            // 如果已经被拒绝,直接返回
+            if currentStatus == .denied || currentStatus == .restricted {
+                print("🔐 [PermissionManager] 权限已被拒绝")
+                self.permissionCallback?(false, self.getAuthorizationStatusString(currentStatus))
+                self.permissionCallback = nil
+                return
+            }
+            
+            print("🔐 [PermissionManager] 调用 requestWhenInUseAuthorization()")
+            self.locationManager?.requestWhenInUseAuthorization()
+            print("🔐 [PermissionManager] requestWhenInUseAuthorization() 调用完成")
         }
-        
-        locationManager?.requestWhenInUseAuthorization()
     }
     
     /**
-     * 权限状态变化回调
+     * 权限状态变化回调 (iOS 14+)
      */
     func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
-        let status = manager.authorizationStatus
+        print("🔐 [PermissionManager] locationManagerDidChangeAuthorization 被调用")
+        handleAuthorizationChange(manager.authorizationStatus)
+    }
+    
+    /**
+     * 权限状态变化回调 (iOS 13 及以下,兼容旧版本)
+     */
+    func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
+        print("🔐 [PermissionManager] didChangeAuthorization 被调用")
+        handleAuthorizationChange(status)
+    }
+    
+    /**
+     * 处理权限状态变化
+     */
+    private func handleAuthorizationChange(_ status: CLAuthorizationStatus) {
+        print("🔐 [PermissionManager] 当前状态: \(getAuthorizationStatusString(status))")
+        
+        // 如果状态仍是 notDetermined,说明用户还没有做出选择,忽略这次回调
+        if status == .notDetermined {
+            print("🔐 [PermissionManager] 状态仍为 notDetermined,等待用户选择")
+            return
+        }
+        
+        // 状态已确定(授予或拒绝),返回结果
         let granted = status == .authorizedAlways || status == .authorizedWhenInUse
         let statusString = getAuthorizationStatusString(status)
         
+        print("🔐 [PermissionManager] 返回结果: granted=\(granted), status=\(statusString)")
+        
         permissionCallback?(granted, statusString)
         permissionCallback = nil
     }

package/package.json

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

package/src/ExpoGaodeMapView.tsx

@@ -77,6 +77,58 @@ class CircleEventManager {
 
 export const CircleEventContext = React.createContext<CircleEventManager | null>(null);
 
+// Polygon 事件管理器
+type PolygonEventCallbacks = {
+  onPress?: () => void;
+};
+
+class PolygonEventManager {
+  private callbacks = new Map<string, PolygonEventCallbacks>();
+  
+  register(polygonId: string, callbacks: PolygonEventCallbacks) {
+    this.callbacks.set(polygonId, callbacks);
+  }
+  
+  unregister(polygonId: string) {
+    this.callbacks.delete(polygonId);
+  }
+  
+  trigger(polygonId: string, eventType: keyof PolygonEventCallbacks) {
+    const callbacks = this.callbacks.get(polygonId);
+    if (callbacks && callbacks[eventType]) {
+      callbacks[eventType]!();
+    }
+  }
+}
+
+export const PolygonEventContext = React.createContext<PolygonEventManager | null>(null);
+
+// Polyline 事件管理器
+type PolylineEventCallbacks = {
+  onPress?: () => void;
+};
+
+class PolylineEventManager {
+  private callbacks = new Map<string, PolylineEventCallbacks>();
+  
+  register(polylineId: string, callbacks: PolylineEventCallbacks) {
+    this.callbacks.set(polylineId, callbacks);
+  }
+  
+  unregister(polylineId: string) {
+    this.callbacks.delete(polylineId);
+  }
+  
+  trigger(polylineId: string, eventType: keyof PolylineEventCallbacks) {
+    const callbacks = this.callbacks.get(polylineId);
+    if (callbacks && callbacks[eventType]) {
+      callbacks[eventType]!();
+    }
+  }
+}
+
+export const PolylineEventContext = React.createContext<PolylineEventManager | null>(null);
+
 /**
  * 高德地图视图组件，提供地图操作API和覆盖物管理功能
  * 
@@ -100,6 +152,8 @@ const ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref)
   const internalRef = React.useRef<MapViewRef | null>(null);
   const markerEventManager = React.useRef(new MarkerEventManager()).current;
   const circleEventManager = React.useRef(new CircleEventManager()).current;
+  const polygonEventManager = React.useRef(new PolygonEventManager()).current;
+  const polylineEventManager = React.useRef(new PolylineEventManager()).current;
   
   // 处理 Marker 事件
   const handleMarkerPress = React.useCallback((event: any) => {
@@ -146,6 +200,22 @@ const ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref)
     }
     props.onCirclePress?.(event);
   }, [props.onCirclePress]);
+  
+  const handlePolygonPress = React.useCallback((event: any) => {
+    const polygonId = event.nativeEvent?.polygonId;
+    if (polygonId) {
+      polygonEventManager.trigger(polygonId, 'onPress');
+    }
+    props.onPolygonPress?.(event);
+  }, [props.onPolygonPress]);
+  
+  const handlePolylinePress = React.useCallback((event: any) => {
+    const polylineId = event.nativeEvent?.polylineId;
+    if (polylineId) {
+      polylineEventManager.trigger(polylineId, 'onPress');
+    }
+    props.onPolylinePress?.(event);
+  }, [props.onPolylinePress]);
 
   const apiRef: MapViewRef = React.useMemo(() => ({
     /**
@@ -348,17 +418,23 @@ const ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref)
     <MapContext.Provider value={internalRef}>
       <MarkerEventContext.Provider value={markerEventManager}>
         <CircleEventContext.Provider value={circleEventManager}>
-          <NativeView
-            ref={nativeRef}
-            {...props}
-            onMarkerPress={handleMarkerPress}
-            onMarkerDragStart={handleMarkerDragStart}
-            onMarkerDrag={handleMarkerDrag}
-            onMarkerDragEnd={handleMarkerDragEnd}
-            onCirclePress={handleCirclePress}
-          >
-            {props.children}
-          </NativeView>
+          <PolygonEventContext.Provider value={polygonEventManager}>
+            <PolylineEventContext.Provider value={polylineEventManager}>
+              <NativeView
+                ref={nativeRef}
+                {...props}
+                onMarkerPress={handleMarkerPress}
+                onMarkerDragStart={handleMarkerDragStart}
+                onMarkerDrag={handleMarkerDrag}
+                onMarkerDragEnd={handleMarkerDragEnd}
+                onCirclePress={handleCirclePress}
+                onPolygonPress={handlePolygonPress}
+                onPolylinePress={handlePolylinePress}
+              >
+                {props.children}
+              </NativeView>
+            </PolylineEventContext.Provider>
+          </PolygonEventContext.Provider>
         </CircleEventContext.Provider>
       </MarkerEventContext.Provider>
     </MapContext.Provider>

package/src/components/overlays/Polygon.tsx

@@ -1,6 +1,6 @@
 import { useContext, useEffect, useRef } from 'react';
 import type { PolygonProps } from '../../types';
-import { MapContext } from '../../ExpoGaodeMapView';
+import { MapContext, PolygonEventContext } from '../../ExpoGaodeMapView';
 
 
 /**
@@ -12,6 +12,7 @@ import { MapContext } from '../../ExpoGaodeMapView';
  * @param props.strokeColor - 多边形边框颜色，默认-16776961
  * @param props.strokeWidth - 多边形边框宽度，默认10
  * @param props.zIndex - 多边形层级，默认0
+ * @param props.onPress - 多边形点击事件
  * 
  * @remarks
  * 组件内部会自动生成唯一ID用于标识多边形，并在组件挂载时添加到地图，
@@ -22,6 +23,7 @@ import { MapContext } from '../../ExpoGaodeMapView';
 export default function Polygon(props: PolygonProps) {
   const { points, fillColor, strokeColor, strokeWidth, zIndex } = props;
   const nativeRef = useContext(MapContext);
+  const eventManager = useContext(PolygonEventContext);
   const polygonIdRef = useRef<string | null>(null);
   const propsRef = useRef(props);
   
@@ -39,6 +41,12 @@ export default function Polygon(props: PolygonProps) {
       const polygonId = `polygon_${Date.now()}_${Math.random()}`;
       polygonIdRef.current = polygonId;
       
+      if (eventManager && props.onPress) {
+        eventManager.register(polygonId, {
+          onPress: props.onPress,
+        });
+      }
+      
       const { points, fillColor, strokeColor, strokeWidth, zIndex } = propsRef.current;
       
       if (points && points.length >= 3) {
@@ -55,8 +63,13 @@ export default function Polygon(props: PolygonProps) {
     checkAndAdd();
     
     return () => {
-      if (polygonIdRef.current && nativeRef?.current) {
-        nativeRef.current.removePolygon(polygonIdRef.current);
+      if (polygonIdRef.current) {
+        if (eventManager) {
+          eventManager.unregister(polygonIdRef.current);
+        }
+        if (nativeRef?.current) {
+          nativeRef.current.removePolygon(polygonIdRef.current);
+        }
       }
     };
   }, []);

package/src/components/overlays/Polyline.tsx

@@ -1,6 +1,6 @@
 
 import * as React from 'react';
-import { MapContext } from '../../ExpoGaodeMapView';
+import { MapContext, PolylineEventContext } from '../../ExpoGaodeMapView';
 import type { PolylineProps } from '../../types';
 
 
@@ -11,6 +11,7 @@ import type { PolylineProps } from '../../types';
  * @param props.points - 折线的坐标点数组
  * @param props.width - 折线的宽度（像素）
  * @param props.color - 折线的颜色（十六进制或RGBA）
+ * @param props.onPress - 折线点击事件回调函数
  * @param [props.texture] - 可选，折线的纹理样式
  * 
  * @remarks
@@ -21,6 +22,7 @@ import type { PolylineProps } from '../../types';
  */
 export default function Polyline(props: PolylineProps) {
   const mapRef = React.useContext(MapContext);
+  const eventManager = React.useContext(PolylineEventContext);
   const polylineIdRef = React.useRef<string | null>(null);
   const propsRef = React.useRef(props);
   
@@ -38,11 +40,20 @@ export default function Polyline(props: PolylineProps) {
       const polylineId = `polyline_${Date.now()}_${Math.random()}`;
       polylineIdRef.current = polylineId;
       
+      if (eventManager && props.onPress) {
+        eventManager.register(polylineId, {
+          onPress: props.onPress,
+        });
+      }
+      
       const polylineProps = {
         points: propsRef.current.points,
         width: propsRef.current.width,
         color: propsRef.current.color,
         ...(propsRef.current.texture && { texture: propsRef.current.texture }),
+        ...(propsRef.current.dotted !== undefined && { dotted: propsRef.current.dotted }),
+        ...(propsRef.current.geodesic !== undefined && { geodesic: propsRef.current.geodesic }),
+        ...(propsRef.current.zIndex !== undefined && { zIndex: propsRef.current.zIndex }),
       };
       
       mapRef.current.addPolyline(polylineId, polylineProps);
@@ -51,8 +62,13 @@ export default function Polyline(props: PolylineProps) {
     checkAndAdd();
     
     return () => {
-      if (polylineIdRef.current && mapRef?.current) {
-        mapRef.current.removePolyline(polylineIdRef.current);
+      if (polylineIdRef.current) {
+        if (eventManager) {
+          eventManager.unregister(polylineIdRef.current);
+        }
+        if (mapRef?.current) {
+          mapRef.current.removePolyline(polylineIdRef.current);
+        }
       }
     };
   }, []);

package/src/types/map-view.types.ts

@@ -224,6 +224,16 @@ export interface MapViewProps {
    */
   onCirclePress?: (event: { circleId: string } & LatLng) => void;
 
+  /**
+   * Polygon 点击事件
+   */
+  onPolygonPress?: (event: { polygonId: string } & LatLng) => void;
+
+  /**
+   * Polyline 点击事件
+   */
+  onPolylinePress?: (event: { polylineId: string } & LatLng) => void;
+
   /**
    * 子组件
    */

package/src/types/overlays.types.ts

@@ -149,16 +149,22 @@ export interface PolylineProps {
 
   /**
    * 是否使用渐变色
+   * @platform android
+   * @note iOS 不支持
    */
   gradient?: boolean;
 
   /**
    * 是否绘制大地线
+   * @platform android
+   * @note iOS 不支持
    */
   geodesic?: boolean;
 
   /**
    * 是否绘制虚线
+   * @platform android
+   * @note iOS 不支持
    */
   dotted?: boolean;