expo-gaode-map 0.1.6 → 1.0.1

package/ios/overlays/PolygonView.swift

@@ -1,25 +1,47 @@
 import ExpoModulesCore
 import MAMapKit
 
+/**
+ * 多边形覆盖物视图
+ * 
+ * 负责:
+ * - 在地图上绘制多边形
+ * - 管理多边形样式(填充色、边框色、边框宽度)
+ * - 响应属性变化并更新渲染
+ */
 class PolygonView: ExpoView {
+    /// 多边形点数组
     var points: [[String: Double]] = []
+    /// 填充颜色
     var fillColor: Any?
+    /// 边框颜色
     var strokeColor: Any?
+    /// 边框宽度
     var strokeWidth: Float = 0
     
+    /// 地图视图弱引用
     private var mapView: MAMapView?
+    /// 多边形覆盖物对象
     var polygon: MAPolygon?
+    /// 多边形渲染器
     private var renderer: MAPolygonRenderer?
     
     required init(appContext: AppContext? = nil) {
         super.init(appContext: appContext)
     }
     
+    /**
+     * 设置地图实例
+     * @param map 地图视图
+     */
     func setMap(_ map: MAMapView) {
         self.mapView = map
         updatePolygon()
     }
     
+    /**
+     * 更新多边形覆盖物
+     */
     private func updatePolygon() {
         guard let mapView = mapView else { return }
         if let old = polygon { mapView.remove(old) }
@@ -34,6 +56,10 @@ class PolygonView: ExpoView {
         mapView.add(polygon!)
     }
     
+    /**
+     * 获取多边形渲染器
+     * @return 渲染器实例
+     */
     func getRenderer() -> MAOverlayRenderer {
         if renderer == nil, let polygon = polygon {
             renderer = MAPolygonRenderer(polygon: polygon)
@@ -44,27 +70,52 @@ class PolygonView: ExpoView {
         return renderer!
     }
     
+    /**
+     * 设置多边形点数组
+     * @param points 点数组
+     */
     func setPoints(_ points: [[String: Double]]) {
         self.points = points
         renderer = nil
         updatePolygon()
     }
     
+    /**
+     * 设置填充颜色
+     * @param color 颜色值
+     */
     func setFillColor(_ color: Any?) {
         fillColor = color
         renderer = nil
         updatePolygon()
     }
     
+    /**
+     * 设置边框颜色
+     * @param color 颜色值
+     */
     func setStrokeColor(_ color: Any?) {
         strokeColor = color
         renderer = nil
         updatePolygon()
     }
     
+    /**
+     * 设置边框宽度
+     * @param width 宽度值
+     */
     func setStrokeWidth(_ width: Float) {
         strokeWidth = width
         renderer = nil
         updatePolygon()
     }
+    
+    /**
+     * 析构时移除多边形
+     */
+    deinit {
+        if let mapView = mapView, let polygon = polygon {
+            mapView.remove(polygon)
+        }
+    }
 }

package/ios/overlays/PolylineView.swift

@@ -1,25 +1,47 @@
 import ExpoModulesCore
 import MAMapKit
 
+/**
+ * 折线覆盖物视图
+ * 
+ * 负责:
+ * - 在地图上绘制折线
+ * - 支持纹理贴图
+ * - 管理折线样式(线宽、颜色)
+ */
 class PolylineView: ExpoView {
+    /// 折线点数组
     var points: [[String: Double]] = []
+    /// 线宽
     var strokeWidth: Float = 0
+    /// 线条颜色
     var strokeColor: Any?
+    /// 纹理图片 URL
     var textureUrl: String?
     
+    /// 地图视图弱引用
     private var mapView: MAMapView?
+    /// 折线覆盖物对象
     var polyline: MAPolyline?
+    /// 折线渲染器
     private var renderer: MAPolylineRenderer?
     
     required init(appContext: AppContext? = nil) {
         super.init(appContext: appContext)
     }
     
+    /**
+     * 设置地图实例
+     * @param map 地图视图
+     */
     func setMap(_ map: MAMapView) {
         self.mapView = map
         updatePolyline()
     }
     
+    /**
+     * 更新折线覆盖物
+     */
     private func updatePolyline() {
         guard let mapView = mapView else { return }
         if let old = polyline { mapView.remove(old) }
@@ -34,13 +56,16 @@ class PolylineView: ExpoView {
         mapView.add(polyline!)
     }
     
+    /**
+     * 获取折线渲染器
+     * @return 渲染器实例
+     */
     func getRenderer() -> MAOverlayRenderer {
         if renderer == nil, let polyline = polyline {
             renderer = MAPolylineRenderer(polyline: polyline)
             renderer?.lineWidth = CGFloat(strokeWidth)
             
             if let url = textureUrl {
-                print("🎨 PolylineView: 加载纹理 URL: \(url)")
                 loadTexture(url: url, renderer: renderer!)
             } else {
                 renderer?.strokeColor = ColorParser.parseColor(strokeColor) ?? UIColor.clear
@@ -49,22 +74,23 @@ class PolylineView: ExpoView {
         return renderer!
     }
     
+    /**
+     * 加载纹理图片
+     * @param url 图片 URL (支持 http/https/file/本地资源)
+     * @param renderer 折线渲染器
+     */
     private func loadTexture(url: String, renderer: MAPolylineRenderer) {
         if url.hasPrefix("http://") || url.hasPrefix("https://") {
             guard let imageUrl = URL(string: url) else {
-                print("❌ PolylineView: 无效的 URL: \(url)")
                 return
             }
             URLSession.shared.dataTask(with: imageUrl) { [weak self] data, _, error in
                 if let error = error {
-                    print("❌ PolylineView: 下载图片失败: \(error)")
                     return
                 }
                 guard let data = data, let image = UIImage(data: data) else {
-                    print("❌ PolylineView: 无法创建图片")
                     return
                 }
-                print("✅ PolylineView: 图片下载成功，大小: \(image.size)")
                 DispatchQueue.main.async {
                     self?.applyTexture(image: image, to: renderer)
                 }
@@ -72,53 +98,74 @@ class PolylineView: ExpoView {
         } else if url.hasPrefix("file://") {
             let path = String(url.dropFirst(7))
             if let image = UIImage(contentsOfFile: path) {
-                print("✅ PolylineView: 本地图片加载成功")
                 applyTexture(image: image, to: renderer)
-            } else {
-                print("❌ PolylineView: 本地图片加载失败: \(path)")
             }
         } else {
             if let image = UIImage(named: url) {
-                print("✅ PolylineView: 资源图片加载成功")
                 applyTexture(image: image, to: renderer)
-            } else {
-                print("❌ PolylineView: 资源图片加载失败: \(url)")
             }
         }
     }
     
+    /**
+     * 应用纹理到折线渲染器
+     * @param image 纹理图片
+     * @param renderer 折线渲染器
+     */
     private func applyTexture(image: UIImage, to renderer: MAPolylineRenderer) {
         let selector = NSSelectorFromString("loadStrokeTextureImage:")
         if renderer.responds(to: selector) {
             renderer.perform(selector, with: image)
-            print("✅ PolylineView: 纹理已应用")
             mapView?.setNeedsDisplay()
-        } else {
-            print("❌ PolylineView: renderer 不支持 loadStrokeTextureImage 方法")
         }
     }
     
+    /**
+     * 设置折线点数组
+     * @param points 点数组
+     */
     func setPoints(_ points: [[String: Double]]) {
         self.points = points
         renderer = nil
         updatePolyline()
     }
     
+    /**
+     * 设置线宽
+     * @param width 线宽值
+     */
     func setStrokeWidth(_ width: Float) {
         strokeWidth = width
         renderer = nil
         updatePolyline()
     }
     
+    /**
+     * 设置线条颜色
+     * @param color 颜色值
+     */
     func setStrokeColor(_ color: Any?) {
         strokeColor = color
         renderer = nil
         updatePolyline()
     }
     
+    /**
+     * 设置纹理图片
+     * @param url 图片 URL
+     */
     func setTexture(_ url: String?) {
         textureUrl = url
         renderer = nil
         updatePolyline()
     }
+    
+    /**
+     * 析构时移除折线
+     */
+    deinit {
+        if let mapView = mapView, let polyline = polyline {
+            mapView.remove(polyline)
+        }
+    }
 }

package/ios/utils/PermissionManager.swift

@@ -0,0 +1,58 @@
+import Foundation
+import CoreLocation
+
+/**
+ * 位置权限管理器
+ * 
+ * 负责:
+ * - 请求位置权限
+ * - 监听权限状态变化
+ * - 返回权限结果
+ */
+class PermissionManager: NSObject, CLLocationManagerDelegate {
+    /// 位置管理器实例
+    private var locationManager: CLLocationManager?
+    /// 权限请求回调
+    private var permissionCallback: ((Bool, String) -> Void)?
+    
+    /**
+     * 请求位置权限
+     * @param callback 权限结果回调 (granted, status)
+     */
+    func requestPermission(callback: @escaping (Bool, String) -> Void) {
+        self.permissionCallback = callback
+        
+        if locationManager == nil {
+            locationManager = CLLocationManager()
+            locationManager?.delegate = self
+        }
+        
+        locationManager?.requestWhenInUseAuthorization()
+    }
+    
+    /**
+     * 权限状态变化回调
+     */
+    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
+        let status = manager.authorizationStatus
+        let granted = status == .authorizedAlways || status == .authorizedWhenInUse
+        let statusString = getAuthorizationStatusString(status)
+        
+        permissionCallback?(granted, statusString)
+        permissionCallback = nil
+    }
+    
+    /**
+     * 将权限状态转换为字符串
+     */
+    private func getAuthorizationStatusString(_ status: CLAuthorizationStatus) -> String {
+        switch status {
+        case .notDetermined: return "notDetermined"
+        case .restricted: return "restricted"
+        case .denied: return "denied"
+        case .authorizedAlways: return "authorizedAlways"
+        case .authorizedWhenInUse: return "authorizedWhenInUse"
+        @unknown default: return "unknown"
+        }
+    }
+}

package/package.json

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

package/src/ExpoGaodeMapView.tsx

@@ -2,7 +2,7 @@
  * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
  * @Date         : 2025-11-13 14:03:56
  * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 19:35:20
+ * @LastEditTime : 2025-11-15 01:50:18
  * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapView.tsx
  * @Description  : 高德地图视图组件
  * 
@@ -62,7 +62,7 @@ const ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref)
   const internalRef = React.useRef<MapViewRef | null>(null);
 
   const apiRef: MapViewRef = React.useMemo(() => ({
-    moveCamera: async (position: CameraPosition, duration: number = 0) => {
+    moveCamera: async (position: CameraPosition, duration: number = 300) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.moveCamera(position, duration);
     },

package/src/index.ts

@@ -2,7 +2,7 @@
  * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
  * @Date         : 2025-11-13 14:45:15
  * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-14 16:15:52
+ * @LastEditTime : 2025-11-15 02:21:17
  * @FilePath     : /expo-gaode-map/src/index.ts
  * @Description  : 高德地图 Expo Module 主导出文件
  * 
@@ -33,6 +33,14 @@ export {
   stopUpdatingHeading,
 } from './modules/AMapLocation';
 
+// 导出权限管理模块
+export {
+  default as AMapPermissions,
+  checkLocationPermission,
+  requestLocationPermission,
+} from './modules/AMapPermissions';
+export type { PermissionStatus } from './modules/AMapPermissions';
+
 // 地图视图控制已移至 MapView 的 ref 调用
 // 使用方式: const mapRef = useRef<MapViewRef>(null); mapRef.current.moveCamera() 等
 

package/src/modules/AMapPermissions.ts

@@ -0,0 +1,48 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-11-15 02:20:56
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-11-15 02:20:58
+ * @FilePath     : /expo-gaode-map/src/modules/AMapPermissions.ts
+ * @Description  : 
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+/*
+ * 高德地图权限管理模块
+ */
+
+import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
+
+/**
+ * 权限状态
+ */
+export interface PermissionStatus {
+  /** 是否已授权 */
+  granted: boolean;
+  /** iOS 权限状态字符串 */
+  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';
+  /** Android 精确位置权限 */
+  fineLocation?: boolean;
+  /** Android 粗略位置权限 */
+  coarseLocation?: boolean;
+}
+
+/**
+ * 检查位置权限状态
+ */
+export async function checkLocationPermission(): Promise<PermissionStatus> {
+  return await ExpoGaodeMapModule.checkLocationPermission();
+}
+
+/**
+ * 请求位置权限
+ */
+export async function requestLocationPermission(): Promise<PermissionStatus> {
+  return await ExpoGaodeMapModule.requestLocationPermission();
+}
+
+export default {
+  checkLocationPermission,
+  requestLocationPermission,
+};

package/src/modules/AMapView.ts

@@ -2,10 +2,17 @@
  * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
  * @Date         : 2025-11-13 14:57:30
  * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:57:35
+ * @LastEditTime : 2025-11-14 19:38:00
  * @FilePath     : /expo-gaode-map/src/modules/AMapView.ts
  * @Description  : 高德地图视图控制模块
  * 
+ * ⚠️ 警告: 此模块中的方法已不推荐使用
+ * 请使用 MapView 的 ref 方式调用这些方法
+ * 
+ * 示例:
+ * const mapRef = useRef<MapViewRef>(null);
+ * mapRef.current?.moveCamera({ target: { latitude: 39.9, longitude: 116.4 }, zoom: 10 });
+ * 
  * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
  */
 
@@ -14,8 +21,9 @@ import type { CameraPosition, Point, LatLng } from '../types';
 
 /**
  * 移动地图相机到指定位置
+ * @deprecated 不推荐使用,请使用 MapView ref 的 moveCamera 方法
  * @param cameraPosition 相机位置参数
- * @param duration 动画时长（毫秒），默认为0（无动画）
+ * @param duration 动画时长(毫秒),默认为0(无动画)
  */
 export function moveCamera(cameraPosition: CameraPosition, duration = 0): void {
   ExpoGaodeMapModule.moveCamera?.(cameraPosition, duration);
@@ -23,6 +31,7 @@ export function moveCamera(cameraPosition: CameraPosition, duration = 0): void {
 
 /**
  * 将屏幕坐标转换为地理坐标
+ * @deprecated 不推荐使用,请使用 MapView ref 的 getLatLng 方法
  * @param point 屏幕坐标点
  * @returns 地理坐标
  */
@@ -32,6 +41,7 @@ export async function getLatLng(point: Point): Promise<LatLng> {
 
 /**
  * 设置地图中心点
+ * @deprecated 不推荐使用,请使用 MapView ref 的 setCenter 方法
  * @param center 中心点坐标
  * @param animated 是否使用动画
  */
@@ -41,7 +51,8 @@ export function setCenter(center: LatLng, animated = true): void {
 
 /**
  * 设置地图缩放级别
- * @param zoom 缩放级别（3-20）
+ * @deprecated 不推荐使用,请使用 MapView ref 的 setZoom 方法
+ * @param zoom 缩放级别(3-20)
  * @param animated 是否使用动画
  */
 export function setZoom(zoom: number, animated = true): void {
@@ -50,6 +61,7 @@ export function setZoom(zoom: number, animated = true): void {
 
 /**
  * 获取当前地图状态
+ * @deprecated 不推荐使用,请使用 MapView ref 的 getCameraPosition 方法
  * @returns 当前相机位置
  */
 export async function getCameraPosition(): Promise<CameraPosition> {

package/src/types/common.types.ts

@@ -112,6 +112,7 @@ export enum MapType {
 
   /**
    * 公交地图
+   * @platform android
    */
   Bus = 4,
 }