expo-gaode-map-navigation 1.0.1-next.0

package/android/src/main/java/expo/modules/gaodemap/map/modules/LocationManager.kt

@@ -0,0 +1,324 @@
+package expo.modules.gaodemap.map.modules
+
+import android.content.Context
+import com.amap.api.location.AMapLocation
+import com.amap.api.location.AMapLocationClient
+import com.amap.api.location.AMapLocationClientOption
+import com.amap.api.maps.model.LatLng
+import expo.modules.kotlin.Promise
+import expo.modules.gaodemap.map.services.LocationForegroundService
+
+/**
+ * 定位管理器
+ * 
+ * 负责:
+ * - 连续定位和单次定位
+ * - 定位配置管理
+ * - 坐标转换
+ * - 定位结果回调
+ */
+class LocationManager(context: Context) {
+
+
+    /** 应用上下文(避免 Activity 泄露) */
+    private val appContext: Context = context.applicationContext
+    /** 定位客户端 */
+    private var locationClient: AMapLocationClient? = null
+    /** 定位配置选项 */
+    private var locationOption: AMapLocationClientOption? = null
+    /** 定位是否已启动 */
+    private var isLocationStarted = false
+    /** 定位更新回调 */
+    private var onLocationUpdate: ((Map<String, Any?>) -> Unit)? = null
+    /** 是否启用后台定位 */
+    private var allowsBackgroundLocationUpdates = false
+
+    init {
+        initLocationClient()
+    }
+
+    /**
+     * 设置定位更新回调
+     * @param callback 回调函数
+     */
+    fun setOnLocationUpdate(callback: (Map<String, Any?>) -> Unit) {
+        onLocationUpdate = callback
+    }
+
+    /**
+     * 开始连续定位
+     */
+    fun start() {
+        if (locationClient == null) {
+            initLocationClient()
+        }
+        
+        // 如果启用后台定位,启动前台服务
+        if (allowsBackgroundLocationUpdates) {
+            LocationForegroundService.start(appContext)
+        }
+        
+        locationClient?.startLocation()
+        isLocationStarted = true
+    }
+
+    /**
+     * 停止定位
+     */
+    fun stop() {
+        locationClient?.stopLocation()
+        isLocationStarted = false
+        
+        // 停止前台服务
+        if (allowsBackgroundLocationUpdates) {
+            LocationForegroundService.stop(appContext)
+        }
+    }
+
+    /**
+     * 检查是否正在定位
+     * @return 是否正在定位
+     */
+    fun isStarted(): Boolean = isLocationStarted
+
+    /**
+     * 获取当前位置（单次定位）
+     * @param promise Promise 对象用于返回结果
+     */
+    fun getCurrentLocation(promise: Promise) {
+        val onceOption = AMapLocationClientOption().apply {
+            isOnceLocation = true
+            locationOption?.let { opt ->
+                locationMode = opt.locationMode
+                isNeedAddress = opt.isNeedAddress
+                httpTimeOut = opt.httpTimeOut
+            }
+        }
+
+        val tempClient = AMapLocationClient(appContext)
+        tempClient.setLocationOption(onceOption)
+        tempClient.setLocationListener { location ->
+            if (location != null && location.errorCode == 0) {
+                promise.resolve(formatLocation(location))
+            } else {
+                promise.reject("LOCATION_ERROR", location?.errorInfo ?: "定位失败", null)
+            }
+            tempClient.stopLocation()
+            tempClient.onDestroy()
+        }
+        tempClient.startLocation()
+    }
+
+    /**
+     * 坐标转换
+     * @param coordinate 原始坐标
+     * @param type 坐标类型
+     * @param promise Promise 对象用于返回结果
+     */
+    fun coordinateConvert(
+        coordinate: Map<String, Double>,
+        type: Int,
+        promise: Promise
+    ) {
+        val lat = coordinate["latitude"] ?: 0.0
+        val lng = coordinate["longitude"] ?: 0.0
+
+        // 坐标验证
+        if (lat < -90 || lat > 90) {
+            promise.reject("INVALID_COORDINATE", "纬度必须在 -90 到 90 之间", null)
+            return
+        }
+        if (lng < -180 || lng > 180) {
+            promise.reject("INVALID_COORDINATE", "经度必须在 -180 到 180 之间", null)
+            return
+        }
+
+        try {
+            val sourceLatLng = LatLng(lat, lng)
+            // 高德 SDK 会自动处理坐标转换
+            promise.resolve(
+                mapOf(
+                    "latitude" to sourceLatLng.latitude,
+                    "longitude" to sourceLatLng.longitude
+                )
+            )
+        } catch (e: Exception) {
+            promise.reject("CONVERT_ERROR", "坐标转换失败: ${e.message}", e)
+        }
+    }
+
+    // ==================== 配置方法 ====================
+
+    /** 设置是否返回逆地理信息 */
+    fun setLocatingWithReGeocode(isReGeocode: Boolean) {
+        getOrCreateLocationOption().isNeedAddress = isReGeocode
+        applyLocationOption()
+    }
+
+    /** 设置定位模式 */
+    fun setLocationMode(mode: Int) {
+        val locationMode = when (mode) {
+            1 -> AMapLocationClientOption.AMapLocationMode.Hight_Accuracy
+            2 -> AMapLocationClientOption.AMapLocationMode.Battery_Saving
+            3 -> AMapLocationClientOption.AMapLocationMode.Device_Sensors
+            else -> AMapLocationClientOption.AMapLocationMode.Hight_Accuracy
+        }
+        getOrCreateLocationOption().locationMode = locationMode
+        applyLocationOption()
+    }
+
+    /** 设置定位间隔(毫秒) */
+    fun setInterval(interval: Int) {
+        getOrCreateLocationOption().interval = interval.toLong()
+        applyLocationOption()
+    }
+
+    /** 设置是否单次定位 */
+    fun setOnceLocation(isOnceLocation: Boolean) {
+        getOrCreateLocationOption().isOnceLocation = isOnceLocation
+        applyLocationOption()
+    }
+
+    /** 设置是否使用设备传感器 */
+    fun setSensorEnable(sensorEnable: Boolean) {
+        getOrCreateLocationOption().isSensorEnable = sensorEnable
+        applyLocationOption()
+    }
+
+    /** 设置是否允许 WIFI 扫描 */
+    fun setWifiScan(wifiScan: Boolean) {
+        getOrCreateLocationOption().isWifiScan = wifiScan
+        applyLocationOption()
+    }
+
+    /** 设置是否 GPS 优先 */
+    fun setGpsFirst(gpsFirst: Boolean) {
+        getOrCreateLocationOption().isGpsFirst = gpsFirst
+        applyLocationOption()
+    }
+
+    /** 设置是否等待 WIFI 列表刷新 */
+    fun setOnceLocationLatest(onceLocationLatest: Boolean) {
+        getOrCreateLocationOption().isOnceLocationLatest = onceLocationLatest
+        applyLocationOption()
+    }
+
+    /** 设置逆地理语言 */
+    fun setGeoLanguage(language: String) {
+        val geoLanguage = when (language) {
+            "EN" -> AMapLocationClientOption.GeoLanguage.EN
+            "ZH" -> AMapLocationClientOption.GeoLanguage.ZH
+            else -> AMapLocationClientOption.GeoLanguage.DEFAULT
+        }
+        getOrCreateLocationOption().geoLanguage = geoLanguage
+        applyLocationOption()
+    }
+
+    /** 设置是否使用缓存策略 */
+    fun setLocationCacheEnable(locationCacheEnable: Boolean) {
+        getOrCreateLocationOption().isLocationCacheEnable = locationCacheEnable
+        applyLocationOption()
+    }
+
+    /** 设置网络请求超时时间(毫秒) */
+    fun setHttpTimeOut(httpTimeOut: Int) {
+        getOrCreateLocationOption().httpTimeOut = httpTimeOut.toLong()
+        applyLocationOption()
+    }
+
+    /** 设置是否允许后台定位 */
+    fun setAllowsBackgroundLocationUpdates(allows: Boolean) {
+        allowsBackgroundLocationUpdates = allows
+    }
+
+    /**
+     * 销毁资源
+     */
+    fun destroy() {
+        onLocationUpdate = null
+        locationClient?.stopLocation()
+        locationClient?.onDestroy()
+        locationClient = null
+        locationOption = null
+        
+        // 确保停止前台服务
+        if (allowsBackgroundLocationUpdates) {
+            LocationForegroundService.stop(appContext)
+        }
+    }
+
+    // ==================== 私有方法 ====================
+
+    /**
+     * 初始化定位客户端
+     */
+    private fun initLocationClient() {
+        if (locationClient == null) {
+            locationClient = AMapLocationClient(appContext).apply {
+                setLocationListener { location ->
+                    if (location != null && location.errorCode == 0) {
+                        onLocationUpdate?.invoke(formatLocation(location))
+                    }
+                }
+                
+            }
+
+            locationOption = AMapLocationClientOption().apply {
+                locationMode = AMapLocationClientOption.AMapLocationMode.Hight_Accuracy
+                isNeedAddress = true
+                interval = 2000
+                httpTimeOut = 30000
+            }
+            locationClient?.setLocationOption(locationOption)
+        }
+    }
+
+    /**
+     * 获取或创建定位配置选项
+     * @return 定位配置选项
+     */
+    private fun getOrCreateLocationOption(): AMapLocationClientOption {
+        if (locationOption == null) {
+            locationOption = AMapLocationClientOption()
+        }
+        return locationOption!!
+    }
+
+    /**
+     * 应用定位配置
+     */
+    private fun applyLocationOption() {
+        locationClient?.setLocationOption(locationOption)
+    }
+
+    /**
+     * 格式化定位结果
+     * @param location 定位对象
+     * @return 格式化后的定位信息
+     */
+    private fun formatLocation(location: AMapLocation): Map<String, Any?> {
+        return mapOf(
+            "latitude" to location.latitude,
+            "longitude" to location.longitude,
+            "altitude" to location.altitude,
+            "accuracy" to location.accuracy,
+            "heading" to location.bearing,
+            "speed" to location.speed,
+            "timestamp" to location.time,
+            "address" to location.address,
+            "country" to location.country,
+            "province" to location.province,
+            "city" to location.city,
+            "district" to location.district,
+            "cityCode" to location.cityCode,
+            "adCode" to location.adCode,
+            "street" to location.street,
+            "streetNumber" to location.streetNum,
+            "poiName" to location.poiName,
+            "aoiName" to location.aoiName,
+            "description" to location.locationDetail,
+            "coordType" to location.coordType,
+            "buildingId" to location.buildingId
+        )
+    }
+}

package/android/src/main/java/expo/modules/gaodemap/map/modules/SDKInitializer.kt

@@ -0,0 +1,88 @@
+package expo.modules.gaodemap.map.modules
+
+import android.content.Context
+import com.amap.api.location.AMapLocationClient
+import com.amap.api.maps.MapsInitializer
+
+/**
+ * SDK 初始化管理器
+ * 
+ * 负责:
+ * - 初始化高德地图 SDK
+ * - 初始化高德定位 SDK
+ * - 设置隐私合规
+ * - 获取 SDK 版本信息
+ */
+object SDKInitializer {
+    
+    /** 隐私协议是否已同意 */
+    private var privacyAgreed = false
+    
+    /**
+     * 更新隐私合规状态
+     * 必须在用户同意隐私协议后调用
+     *
+     * @param context 应用上下文
+     * @param hasAgreed 用户是否已同意隐私协议
+     */
+    fun updatePrivacyCompliance(context: Context, hasAgreed: Boolean) {
+        privacyAgreed = hasAgreed
+        
+        // 先更新隐私信息显示状态
+        MapsInitializer.updatePrivacyShow(context, true, true)
+        AMapLocationClient.updatePrivacyShow(context, true, true)
+        
+        // 根据用户选择更新同意状态
+        if (hasAgreed) {
+            MapsInitializer.updatePrivacyAgree(context, true)
+            AMapLocationClient.updatePrivacyAgree(context, true)
+            android.util.Log.d("ExpoGaodeMap", "✅ 用户已同意隐私协议，可以使用 SDK")
+        } else {
+            MapsInitializer.updatePrivacyAgree(context, false)
+            AMapLocationClient.updatePrivacyAgree(context, false)
+            android.util.Log.w("ExpoGaodeMap", "⚠️ 用户未同意隐私协议，SDK 功能将受限")
+        }
+    }
+    
+    /**
+     * 检查隐私协议是否已同意
+     *
+     * @return 是否已同意隐私协议
+     */
+    fun isPrivacyAgreed(): Boolean = privacyAgreed
+
+    /**
+     * 初始化高德地图和定位 SDK
+     *
+     * @param context 应用上下文
+     * @param androidKey Android 平台的 API Key
+     * @throws Exception 初始化失败时抛出异常
+     */
+    fun initSDK(context: Context, androidKey: String) {
+        // 检查隐私协议状态
+        if (!privacyAgreed) {
+            // 使用 Kotlin 模块的 CodedException，让 JS 能收到标准化异常
+            throw expo.modules.kotlin.exception.CodedException("用户未同意隐私协议，无法初始化 SDK")
+        }
+        
+        try {
+            // 设置 API Key
+            MapsInitializer.setApiKey(androidKey)
+            AMapLocationClient.setApiKey(androidKey)
+            
+            android.util.Log.d("ExpoGaodeMap", "✅ SDK 初始化成功")
+            
+        } catch (e: Exception) {
+            throw Exception("SDK 初始化失败: ${e.message}")
+        }
+    }
+
+    /**
+     * 获取 SDK 版本号
+     * 
+     * @return SDK 版本字符串
+     */
+    fun getVersion(): String {
+        return MapsInitializer.getVersion()
+    }
+}

package/android/src/main/java/expo/modules/gaodemap/map/overlays/CircleView.kt

@@ -0,0 +1,169 @@
+package expo.modules.gaodemap.map.overlays
+
+import android.content.Context
+import android.graphics.Color
+import com.amap.api.maps.AMap
+import com.amap.api.maps.model.Circle
+import com.amap.api.maps.model.CircleOptions
+import com.amap.api.maps.model.LatLng
+import expo.modules.gaodemap.map.utils.ColorParser
+import expo.modules.kotlin.AppContext
+import expo.modules.kotlin.viewevent.EventDispatcher
+import expo.modules.kotlin.views.ExpoView
+
+class CircleView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
+  
+  @Suppress("unused")
+  private val onCirclePress by EventDispatcher()
+  
+  private var circle: Circle? = null
+  private var aMap: AMap? = null
+  private var center: LatLng? = null
+  private var radius: Double = 1000.0
+  private var fillColor: Int = Color.argb(50, 0, 0, 255)
+  private var strokeColor: Int = Color.BLUE
+  private var strokeWidth: Float = 10f
+
+  private var _zIndex: Float = 0f
+  
+  /**
+   * 设置地图实例
+   */
+  @Suppress("unused")
+  fun setMap(map: AMap) {
+    aMap = map
+    // 延迟创建圆形，确保所有 props 都已设置
+    post { createOrUpdateCircle() }
+  }
+  
+  /**
+   * 设置圆心
+   */
+  fun setCenter(centerMap: Map<String, Double>) {
+    val lat = centerMap["latitude"]
+    val lng = centerMap["longitude"]
+    if (lat != null && lng != null) {
+      // 坐标验证
+      if (lat < -90 || lat > 90 || lng < -180 || lng > 180) {
+        return
+      }
+      center = LatLng(lat, lng)
+      circle?.center = center
+    }
+  }
+  
+  /**
+   * 设置半径
+   */
+  fun setRadius(radiusValue: Double) {
+    // 半径验证（必须大于0）
+    val validRadius = if (radiusValue > 0) radiusValue else 1000.0
+    radius = validRadius
+    circle?.let {
+        it.radius = radius
+    } ?: createOrUpdateCircle()
+  }
+  
+  /**
+   * 设置填充颜色
+   */
+  fun setFillColor(color: Any) {
+    fillColor = ColorParser.parseColor(color)
+     circle?.let {
+         it.fillColor = fillColor
+     } ?: createOrUpdateCircle()
+
+  }
+  
+  /**
+   * 设置边框颜色
+   */
+  fun setStrokeColor(color: Any) {
+    strokeColor =  ColorParser.parseColor(color)
+    circle?.let {
+        it.strokeColor = strokeColor
+    } ?: createOrUpdateCircle()
+  }
+  
+  /**
+   * 设置边框宽度
+   * 将 dp 转换为 px，与 iOS 的 points 对应
+   */
+  fun setStrokeWidth(width: Float) {
+    val density = context.resources.displayMetrics.density
+    strokeWidth = width * density
+    circle?.let {
+        it.strokeWidth = strokeWidth
+    } ?: createOrUpdateCircle()
+  }
+  
+  /**
+   * 设置 z-index
+   */
+  fun setZIndex(zIndex: Float) {
+    _zIndex = zIndex
+   circle?.let {
+        it.zIndex = _zIndex
+    } ?: createOrUpdateCircle()
+  }
+  
+  /**
+   * 创建或更新圆形
+   */
+  private fun createOrUpdateCircle() {
+    val map = aMap ?: return
+    val centerPoint = center ?: return
+    
+    if (circle == null) {
+
+      circle = map.addCircle(
+        CircleOptions()
+          .center(centerPoint)
+          .radius(radius)
+          .fillColor(fillColor)
+          .strokeColor(strokeColor)
+          .strokeWidth(strokeWidth)
+          .zIndex(_zIndex)
+      )
+    }
+  }
+  
+  /**
+   * 检查点击位置是否在圆形内
+   */
+  fun checkPress(latLng: LatLng): Boolean {
+    circle?.let { c ->
+      if (c.contains(latLng)) {
+        onCirclePress(mapOf(
+          "latitude" to latLng.latitude,
+          "longitude" to latLng.longitude
+        ))
+        return true
+      }
+    }
+    return false
+  }
+  
+  /**
+   * 移除圆形
+   */
+  fun removeCircle() {
+    circle?.remove()
+    circle = null
+  }
+  
+  override fun onDetachedFromWindow() {
+    super.onDetachedFromWindow()
+    // 🔑 关键修复：使用 post 延迟检查，避免 TabView 切换时误删
+    // 如果是真正的移除，parent 会保持为 null
+    // 如果只是 TabView 切换，parent 会在短时间内恢复
+    post {
+      // 延迟后再次检查 parent，如果仍然为 null，说明是真正的移除
+      if (parent == null) {
+        removeCircle()
+        aMap = null
+      }
+    }
+  }
+
+}

package/android/src/main/java/expo/modules/gaodemap/map/overlays/CircleViewModule.kt

@@ -0,0 +1,42 @@
+package expo.modules.gaodemap.map.overlays
+
+import expo.modules.gaodemap.map.overlays.CircleView
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+/**
+ * Circle 视图 Module
+ */
+class CircleViewModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("NaviCircleView")
+
+    View(CircleView::class) {
+      Events("onCirclePress")
+      
+      Prop<Map<String, Double>>("center") { view, center ->
+        view.setCenter(center)
+      }
+      
+      Prop<Double>("radius") { view, radius ->
+        view.setRadius(radius)
+      }
+      
+      Prop<Any>("fillColor") { view, color ->
+        view.setFillColor(color)
+      }
+      
+      Prop<Any>("strokeColor") { view, color ->
+        view.setStrokeColor(color)
+      }
+      
+      Prop<Float>("strokeWidth") { view, width ->
+        view.setStrokeWidth(width)
+      }
+
+      Prop<Float>("zIndex") { view, zIndex ->
+        view.setZIndex(zIndex)
+      }
+    }
+  }
+}