expo-gaode-map 0.1.6 → 1.0.0

package/ios/managers/UIManager.swift

@@ -1,49 +1,100 @@
 import MAMapKit
 
+/**
+ * UI 和手势管理器
+ * 
+ * 负责:
+ * - 地图类型设置
+ * - 控件显示控制
+ * - 手势交互控制
+ * - 图层显示管理
+ * - 用户位置样式配置
+ */
 class UIManager {
+    /// 弱引用地图视图,避免循环引用
     private weak var mapView: MAMapView?
     
     init(mapView: MAMapView) {
         self.mapView = mapView
     }
     
+    // MARK: - 地图类型
+    
+    /**
+     * 设置地图类型
+     * @param type 0:标准 1:卫星 2:夜间 3:导航
+     */
     func setMapType(_ type: Int) {
         guard let mapView = mapView else { return }
         switch type {
         case 1: mapView.mapType = .satellite
         case 2: mapView.mapType = .standardNight
+        case 3: mapView.mapType = .navi
         default: mapView.mapType = .standard
         }
     }
     
+    // MARK: - 控件显示
+    
+    /**
+     * 设置是否显示缩放控件
+     * iOS 高德地图不支持缩放控件
+     */
     func setShowsZoomControls(_ show: Bool) {
-        // iOS 高德地图不支持缩放控件
+        // iOS 不支持
     }
     
+    /**
+     * 设置是否显示指南针
+     */
     func setShowsCompass(_ show: Bool) {
         mapView?.showsCompass = show
     }
     
+    /**
+     * 设置是否显示比例尺
+     */
     func setShowsScale(_ show: Bool) {
         mapView?.showsScale = show
     }
     
+    // MARK: - 手势控制
+    
+    /**
+     * 设置是否启用缩放手势
+     */
     func setZoomEnabled(_ enabled: Bool) {
         mapView?.isZoomEnabled = enabled
     }
     
+    /**
+     * 设置是否启用滚动手势
+     */
     func setScrollEnabled(_ enabled: Bool) {
         mapView?.isScrollEnabled = enabled
     }
     
+    /**
+     * 设置是否启用旋转手势
+     */
     func setRotateEnabled(_ enabled: Bool) {
         mapView?.isRotateEnabled = enabled
     }
     
+    /**
+     * 设置是否启用倾斜手势
+     */
     func setTiltEnabled(_ enabled: Bool) {
         mapView?.isRotateCameraEnabled = enabled
     }
     
+    // MARK: - 用户位置
+    
+    /**
+     * 设置是否显示用户位置
+     * @param show 是否显示
+     * @param followUser 是否跟随用户
+     */
     func setShowsUserLocation(_ show: Bool, followUser: Bool) {
         guard let mapView = mapView else { return }
         mapView.showsUserLocation = show
@@ -54,6 +105,10 @@ class UIManager {
         }
     }
     
+    /**
+     * 设置用户位置样式
+     * @param config 样式配置字典
+     */
     func setUserLocationRepresentation(_ config: [String: Any]) {
         guard let mapView = mapView else { return }
         let representation = MAUserLocationRepresentation()
@@ -142,6 +197,12 @@ class UIManager {
         mapView.update(representation)
     }
     
+    /**
+     * 调整图片大小
+     * @param image 原始图片
+     * @param targetSize 目标大小
+     * @return 调整后的图片
+     */
     private func resizeImage(_ image: UIImage, targetSize: CGSize) -> UIImage {
         let renderer = UIGraphicsImageRenderer(size: targetSize)
         return renderer.image { _ in
@@ -149,14 +210,25 @@ class UIManager {
         }
     }
     
+    // MARK: - 图层显示
+    
+    /**
+     * 设置是否显示交通路况
+     */
     func setShowsTraffic(_ show: Bool) {
         mapView?.isShowTraffic = show
     }
     
+    /**
+     * 设置是否显示建筑物
+     */
     func setShowsBuildings(_ show: Bool) {
         mapView?.isShowsBuildings = show
     }
     
+    /**
+     * 设置是否显示室内地图
+     */
     func setShowsIndoorMap(_ show: Bool) {
         mapView?.isShowsIndoorMap = show
     }

package/ios/modules/LocationManager.swift

@@ -2,10 +2,23 @@ import Foundation
 import AMapLocationKit
 import CoreLocation
 
+/**
+ * 定位管理器
+ * 
+ * 负责:
+ * - 连续定位和单次定位
+ * - 定位配置管理
+ * - 方向传感器管理
+ * - 定位结果回调
+ */
 class LocationManager: NSObject, AMapLocationManagerDelegate {
+    /// 高德定位管理器实例
     var locationManager: AMapLocationManager?
+    /// 定位是否已启动
     private var isLocationStarted = false
+    /// 定位更新回调
     var onLocationUpdate: (([String: Any]) -> Void)?
+    /// 方向更新回调
     var onHeadingUpdate: (([String: Any]) -> Void)?
     
     override init() {
@@ -13,36 +26,76 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
         initLocationManager()
     }
     
+    // MARK: - 定位控制
+    
+    /**
+     * 开始连续定位
+     */
     func start() {
         locationManager?.startUpdatingLocation()
         isLocationStarted = true
     }
     
+    /**
+     * 停止定位
+     */
     func stop() {
         locationManager?.stopUpdatingLocation()
         isLocationStarted = false
     }
     
+    /**
+     * 检查定位是否已启动
+     * @return 是否正在定位
+     */
     func isStarted() -> Bool {
         return isLocationStarted
     }
     
+    // MARK: - 定位配置
+    
+    /**
+     * 设置是否返回逆地理信息
+     * @param isReGeocode 是否返回逆地理信息
+     */
     func setLocatingWithReGeocode(_ isReGeocode: Bool) {
         locationManager?.locatingWithReGeocode = isReGeocode
     }
     
+    /**
+     * 设置定位距离过滤器(米)
+     * @param distance 最小距离变化才触发定位更新
+     */
     func setDistanceFilter(_ distance: Double) {
         locationManager?.distanceFilter = distance
     }
     
+    /**
+     * 设置定位超时时间(秒)
+     * @param timeout 超时时间
+     */
     func setLocationTimeout(_ timeout: Int) {
         locationManager?.locationTimeout = timeout
     }
     
+    /**
+     * 设置逆地理超时时间(秒)
+     * @param timeout 超时时间
+     */
     func setReGeocodeTimeout(_ timeout: Int) {
         locationManager?.reGeocodeTimeout = timeout
     }
     
+    /**
+     * 设置定位精度
+     * @param accuracy 精度级别
+     *   - 0: 最适合导航
+     *   - 1: 最佳精度
+     *   - 2: 10米精度
+     *   - 3: 100米精度
+     *   - 4: 1公里精度
+     *   - 5: 3公里精度
+     */
     func setDesiredAccuracy(_ accuracy: Int) {
         let accuracyValue: CLLocationAccuracy
         switch accuracy {
@@ -57,13 +110,29 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
         locationManager?.desiredAccuracy = accuracyValue
     }
     
+    /**
+     * 设置是否自动暂停定位更新
+     * @param pauses 是否自动暂停
+     */
     func setPausesLocationUpdatesAutomatically(_ pauses: Bool) {
         locationManager?.pausesLocationUpdatesAutomatically = pauses
     }
     
+    /**
+     * 设置是否允许后台定位
+     * @param allows 是否允许后台定位
+     */
     func setAllowsBackgroundLocationUpdates(_ allows: Bool) {
         locationManager?.allowsBackgroundLocationUpdates = allows
     }
+    
+    /**
+     * 设置逆地理语言
+     * @param language 语言类型
+     *   - 0: 默认
+     *   - 1: 中文
+     *   - 2: 英文
+     */
     func setGeoLanguage(_ language: Int) {
         switch language {
         case 0: locationManager?.reGeocodeLanguage = .default
@@ -73,32 +142,53 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
         }
     }
     
+    // MARK: - 方向传感器
     
+    /**
+     * 开始更新设备方向
+     */
     func startUpdatingHeading() {
         locationManager?.startUpdatingHeading()
     }
     
+    /**
+     * 停止更新设备方向
+     */
     func stopUpdatingHeading() {
         locationManager?.stopUpdatingHeading()
     }
     
+    // MARK: - 生命周期
+    
+    /**
+     * 销毁定位管理器
+     */
     func destroy() {
         locationManager?.stopUpdatingLocation()
         locationManager = nil
     }
     
+    /**
+     * 初始化定位管理器
+     */
     private func initLocationManager() {
         locationManager = AMapLocationManager()
         locationManager?.delegate = self
         locationManager?.desiredAccuracy = kCLLocationAccuracyBest
         locationManager?.distanceFilter = 10
-        locationManager?.locationTimeout = 2
-        locationManager?.reGeocodeTimeout = 2
+        locationManager?.locationTimeout = 1
+        locationManager?.reGeocodeTimeout = 1
         locationManager?.locatingWithReGeocode = true
     }
     
     // MARK: - AMapLocationManagerDelegate
     
+    /**
+     * 定位更新回调
+     * @param manager 定位管理器
+     * @param location 位置信息
+     * @param reGeocode 逆地理信息
+     */
     func amapLocationManager(_ manager: AMapLocationManager!, didUpdate location: CLLocation!, reGeocode: AMapLocationReGeocode!) {
         var locationData: [String: Any] = [
             "latitude": location.coordinate.latitude,
@@ -110,6 +200,7 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
             "timestamp": location.timestamp.timeIntervalSince1970 * 1000
         ]
         
+        // 添加逆地理信息
         if let reGeocode = reGeocode {
             locationData["address"] = reGeocode.formattedAddress
             locationData["province"] = reGeocode.province
@@ -125,6 +216,11 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
         onLocationUpdate?(locationData)
     }
     
+    /**
+     * 方向更新回调
+     * @param manager 定位管理器
+     * @param heading 方向信息
+     */
     func amapLocationManager(_ manager: AMapLocationManager!, didUpdate heading: CLHeading!) {
         let headingData: [String: Any] = [
             "heading": heading.trueHeading,
@@ -134,11 +230,21 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
         onHeadingUpdate?(headingData)
     }
     
+    /**
+     * 需要定位权限回调
+     * @param manager 定位管理器
+     * @param locationManager 系统定位管理器
+     */
     func amapLocationManager(_ manager: AMapLocationManager!, doRequireLocationAuth locationManager: CLLocationManager!) {
         locationManager.requestAlwaysAuthorization()
     }
     
+    /**
+     * 定位失败回调
+     * @param manager 定位管理器
+     * @param error 错误信息
+     */
     func amapLocationManager(_ manager: AMapLocationManager!, didFailWithError error: Error!) {
-        print("定位失败: \(error.localizedDescription)")
+        // 定位失败 - 静默处理
     }
 }

package/ios/overlays/CircleView.swift

@@ -1,15 +1,31 @@
 import ExpoModulesCore
 import MAMapKit
 
+/**
+ * 圆形覆盖物视图
+ * 
+ * 负责:
+ * - 在地图上绘制圆形
+ * - 管理圆形的样式(填充色、边框色、边框宽度)
+ * - 响应属性变化并更新渲染
+ */
 class CircleView: ExpoView {
+    /// 圆心坐标
     var circleCenter: [String: Double] = [:]
+    /// 半径(米)
     var radius: Double = 0
+    /// 填充颜色
     var fillColor: Any?
+    /// 边框颜色
     var strokeColor: Any?
+    /// 边框宽度
     var strokeWidth: Float = 0
     
+    /// 地图视图弱引用
     private var mapView: MAMapView?
+    /// 圆形覆盖物对象
     var circle: MACircle?
+    /// 圆形渲染器
     private var renderer: MACircleRenderer?
     
     required init(appContext: AppContext? = nil) {
@@ -17,6 +33,10 @@ class CircleView: ExpoView {
         circle = MACircle()
     }
     
+    /**
+     * 设置地图实例
+     * @param map 地图视图
+     */
     func setMap(_ map: MAMapView) {
         self.mapView = map
         if let circle = circle {
@@ -24,6 +44,9 @@ class CircleView: ExpoView {
         }
     }
     
+    /**
+     * 更新圆形覆盖物
+     */
     private func updateCircle() {
         guard let latitude = circleCenter["latitude"],
               let longitude = circleCenter["longitude"] else { return }
@@ -31,6 +54,10 @@ class CircleView: ExpoView {
         circle?.radius = radius
     }
     
+    /**
+     * 获取圆形渲染器
+     * @return 渲染器实例
+     */
     func getRenderer() -> MAOverlayRenderer {
         if renderer == nil, let circle = circle {
             renderer = MACircleRenderer(circle: circle)
@@ -43,6 +70,7 @@ class CircleView: ExpoView {
     
     /**
      * 设置中心点
+     * @param center 中心点坐标 {latitude, longitude}
      */
     func setCenter(_ center: [String: Double]) {
         circleCenter = center
@@ -50,27 +78,52 @@ class CircleView: ExpoView {
         updateCircle()
     }
     
+    /**
+     * 设置半径
+     * @param radius 半径(米)
+     */
     func setRadius(_ radius: Double) {
         self.radius = radius
         renderer = nil
         updateCircle()
     }
     
+    /**
+     * 设置填充颜色
+     * @param color 颜色值
+     */
     func setFillColor(_ color: Any?) {
         fillColor = color
         renderer = nil
         updateCircle()
     }
     
+    /**
+     * 设置边框颜色
+     * @param color 颜色值
+     */
     func setStrokeColor(_ color: Any?) {
         strokeColor = color
         renderer = nil
         updateCircle()
     }
     
+    /**
+     * 设置边框宽度
+     * @param width 宽度值
+     */
     func setStrokeWidth(_ width: Float) {
         strokeWidth = width
         renderer = nil
         updateCircle()
     }
+    
+    /**
+     * 析构时移除圆形
+     */
+    deinit {
+        if let mapView = mapView, let circle = circle {
+            mapView.remove(circle)
+        }
+    }
 }

package/ios/overlays/HeatMapView.swift

@@ -1,12 +1,25 @@
 import ExpoModulesCore
 import MAMapKit
 
+/**
+ * 热力图视图
+ * 
+ * 负责:
+ * - 在地图上显示热力图
+ * - 管理热力图数据和样式
+ * - 支持半径和透明度配置
+ */
 class HeatMapView: ExpoView {
+    /// 热力图数据点数组
     var data: [[String: Any]] = []
+    /// 热力图半径
     var radius: Int = 50
+    /// 透明度
     var opacity: Double = 0.6
     
+    /// 地图视图弱引用
     private var mapView: MAMapView?
+    /// 热力图图层
     private var heatmapOverlay: MAHeatMapTileOverlay?
     
     required init(appContext: AppContext? = nil) {
@@ -15,6 +28,7 @@ class HeatMapView: ExpoView {
     
     /**
      * 设置地图实例
+     * @param map 地图视图
      */
     func setMap(_ map: MAMapView) {
         self.mapView = map
@@ -23,6 +37,7 @@ class HeatMapView: ExpoView {
     
     /**
      * 设置热力图数据
+     * @param data 数据点数组，每个点包含 latitude、longitude
      */
     func setData(_ data: [[String: Any]]) {
         self.data = data
@@ -31,6 +46,7 @@ class HeatMapView: ExpoView {
     
     /**
      * 设置热力图半径
+     * @param radius 半径值(像素)
      */
     func setRadius(_ radius: Int) {
         self.radius = radius
@@ -39,6 +55,7 @@ class HeatMapView: ExpoView {
     
     /**
      * 设置透明度
+     * @param opacity 透明度值 (0.0-1.0)
      */
     func setOpacity(_ opacity: Double) {
         self.opacity = opacity
@@ -91,8 +108,18 @@ class HeatMapView: ExpoView {
         heatmapOverlay = nil
     }
     
+    /**
+     * 从父视图移除时清理热力图
+     */
     override func removeFromSuperview() {
         super.removeFromSuperview()
         removeHeatMap()
     }
+    
+    /**
+     * 析构时移除热力图
+     */
+    deinit {
+        removeHeatMap()
+    }
 }

package/ios/overlays/MarkerView.swift

@@ -1,13 +1,27 @@
 import ExpoModulesCore
 import MAMapKit
 
+/**
+ * 标记点视图
+ * 
+ * 负责:
+ * - 在地图上显示标记点
+ * - 管理标记点属性(位置、标题、描述)
+ * - 支持拖拽功能
+ */
 class MarkerView: ExpoView {
+    /// 标记点位置
     var position: [String: Double] = [:]
+    /// 标题
     var title: String = ""
+    /// 描述
     var markerDescription: String = ""
+    /// 是否可拖拽
     var draggable: Bool = false
     
+    /// 地图视图弱引用
     private var mapView: MAMapView?
+    /// 标记点对象
     private var annotation: MAPointAnnotation?
     
     required init(appContext: AppContext? = nil) {
@@ -16,6 +30,7 @@ class MarkerView: ExpoView {
     
     /**
      * 设置地图实例
+     * @param map 地图视图
      */
     func setMap(_ map: MAMapView) {
         self.mapView = map
@@ -23,7 +38,7 @@ class MarkerView: ExpoView {
     }
     
     /**
-     * 更新标记
+     * 更新标记点
      */
     private func updateAnnotation() {
         guard let mapView = mapView,
@@ -49,6 +64,7 @@ class MarkerView: ExpoView {
     
     /**
      * 设置位置
+     * @param position 位置坐标 {latitude, longitude}
      */
     func setPosition(_ position: [String: Double]) {
         self.position = position
@@ -57,6 +73,7 @@ class MarkerView: ExpoView {
     
     /**
      * 设置标题
+     * @param title 标题文本
      */
     func setTitle(_ title: String) {
         self.title = title
@@ -65,6 +82,7 @@ class MarkerView: ExpoView {
     
     /**
      * 设置描述
+     * @param description 描述文本
      */
     func setDescription(_ description: String) {
         self.markerDescription = description
@@ -73,9 +91,19 @@ class MarkerView: ExpoView {
     
     /**
      * 设置是否可拖拽
+     * @param draggable 是否可拖拽
      */
     func setDraggable(_ draggable: Bool) {
         self.draggable = draggable
         // iOS 高德地图标记默认不可拖拽，需要自定义实现
     }
+    
+    /**
+     * 析构时移除标记点
+     */
+    deinit {
+        if let mapView = mapView, let annotation = annotation {
+            mapView.removeAnnotation(annotation)
+        }
+    }
 }