expo-gaode-map 1.0.1 → 1.0.3

package/src/components/overlays/Marker.tsx

@@ -1,66 +1,83 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:01:10
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:55:00
- * @FilePath     : /expo-gaode-map/src/components/overlays/Marker.tsx
- * @Description  : 地图标记组件 - 使用命令式 API
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import * as React from 'react';
-import { MapContext } from '../../ExpoGaodeMapView';
+import { Image } from 'react-native';
+import { MapContext, MarkerEventContext } from '../../ExpoGaodeMapView';
 import type { MarkerProps } from '../../types';
 
-/**
- * 地图标记组件
- * 
- * @example
- * ```tsx
- * <MapView>
- *   <Marker
- *     position={{ latitude: 39.9, longitude: 116.4 }}
- *     title="标记点"
- *     onPress={() => console.log('Marker pressed')}
- *   />
- * </MapView>
- * ```
- */
 export default function Marker(props: MarkerProps) {
-  const mapRef = React.useContext(MapContext);
-  const markerIdRef = React.useRef<string>(`marker_${Date.now()}_${Math.random()}`);
-
-  console.log('Marker 组件渲染，props:', props);
+  return <MarkerImperative {...props} />;
+}
 
-  // 添加标记
+function MarkerImperative(props: MarkerProps) {
+  const mapRef = React.useContext(MapContext);
+  const eventManager = React.useContext(MarkerEventContext);
+  const markerIdRef = React.useRef<string | null>(null);
+  const propsRef = React.useRef(props);
+  
+  React.useEffect(() => {
+    propsRef.current = props;
+  }, [props]);
+  
   React.useEffect(() => {
-    const markerId = markerIdRef.current;
+    const checkAndAdd = () => {
+      if (!mapRef?.current) {
+        setTimeout(checkAndAdd, 50);
+        return;
+      }
+      
+      const markerId = `marker_${Date.now()}_${Math.random()}`;
+      markerIdRef.current = markerId;
+      
+      if (eventManager) {
+        eventManager.register(markerId, {
+          onPress: props.onPress,
+          onDragStart: props.onDragStart,
+          onDrag: props.onDrag,
+          onDragEnd: props.onDragEnd,
+        });
+      }
+      
+      const processedProps = { ...propsRef.current };
+      if (processedProps.icon && typeof processedProps.icon === 'number') {
+        const resolved = Image.resolveAssetSource(processedProps.icon);
+        processedProps.icon = resolved;
+      }
+      
+      mapRef.current.addMarker(markerId, processedProps);
+    };
+    
+    checkAndAdd();
     
-    console.log('Marker useEffect - 添加标记到地图');
-    mapRef?.current?.addMarker?.(markerId, props).then(() => {
-      console.log('✅ 标记已添加:', markerId);
-    }).catch((error: any) => {
-      console.error('❌ 添加标记失败:', error);
-    });
-
     return () => {
-      console.log('Marker useEffect cleanup - 移除标记');
-      mapRef?.current?.removeMarker?.(markerId).catch((error: any) => {
-        console.error('❌ 移除标记失败:', error);
-      });
+      if (markerIdRef.current) {
+        if (eventManager) {
+          eventManager.unregister(markerIdRef.current);
+        }
+        if (mapRef?.current) {
+          mapRef.current.removeMarker(markerIdRef.current);
+        }
+      }
     };
   }, []);
 
-  // 监听 Props 变化，更新标记
   React.useEffect(() => {
-    const markerId = markerIdRef.current;
-    
-    console.log('Marker props 变化，更新标记:', props);
-    mapRef?.current?.updateMarker?.(markerId, props).catch((error: any) => {
-      console.error('❌ 更新标记失败:', error);
-    });
-  }, [props.position, props.title, props.draggable]);
-
+    if (markerIdRef.current && mapRef?.current) {
+      const processedProps = { ...props };
+      if (processedProps.icon && typeof processedProps.icon === 'number') {
+        const resolved = Image.resolveAssetSource(processedProps.icon);
+        processedProps.icon = resolved;
+      }
+      mapRef.current.updateMarker(markerIdRef.current, processedProps);
+    }
+  }, [
+    props.position?.latitude,
+    props.position?.longitude,
+    props.title,
+    props.draggable,
+    props.icon,
+    props.iconWidth,
+    props.iconHeight,
+    props.pinColor
+  ]);
+  
   return null;
 }

package/src/components/overlays/MultiPoint.tsx

@@ -1,36 +1,15 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:02:35
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:19:09
- * @FilePath     : /expo-gaode-map/src/components/overlays/MultiPoint.tsx
- * @Description  : 地图海量点组件
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 import type { MultiPointProps } from '../../types';
 
 const NativeMultiPoint = requireNativeViewManager('ExpoGaodeMap_MultiPointView');
 
+
 /**
- * 地图海量点组件
- * 用于展示大量标记点，性能优于普通 Marker
+ * 高德地图多点标记组件
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <MultiPoint
- *     points={[
- *       { latitude: 39.9, longitude: 116.4, id: '1' },
- *       { latitude: 39.91, longitude: 116.41, id: '2' },
- *     ]}
- *     icon={require('./marker.png')}
- *   />
- * </MapView>
- * ```
+ * @param props 多点标记的配置属性，继承自MultiPointProps接口
+ * @returns 渲染原生高德地图多点标记组件
  */
 export default function MultiPoint(props: MultiPointProps) {
   return <NativeMultiPoint {...props} />;

package/src/components/overlays/Polygon.tsx

@@ -1,105 +1,75 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:01:45
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 19:24:22
- * @FilePath     : /expo-gaode-map/src/components/overlays/Polygon.tsx
- * @Description  : 地图多边形组件 - 命令式 API
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
-
 import { useContext, useEffect, useRef } from 'react';
 import type { PolygonProps } from '../../types';
 import { MapContext } from '../../ExpoGaodeMapView';
 
+
 /**
- * 地图多边形组件 - 命令式 API
+ * 高德地图多边形覆盖物组件
+ * 
+ * @param props - 多边形配置属性
+ * @param props.points - 多边形顶点坐标数组，至少需要3个点
+ * @param props.fillColor - 多边形填充颜色，十六进制格式，默认0x440000FF
+ * @param props.strokeColor - 多边形边框颜色，默认-16776961
+ * @param props.strokeWidth - 多边形边框宽度，默认10
+ * @param props.zIndex - 多边形层级，默认0
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <Polygon
- *     points={[
- *       { latitude: 39.9, longitude: 116.4 },
- *       { latitude: 39.91, longitude: 116.41 },
- *       { latitude: 39.92, longitude: 116.40 },
- *     ]}
- *     fillColor={0x44FF0000}
- *     strokeColor={-65536}
- *     strokeWidth={5}
- *   />
- * </MapView>
- * ```
+ * @remarks
+ * 组件内部会自动生成唯一ID用于标识多边形，并在组件挂载时添加到地图，
+ * 更新时同步修改多边形属性，卸载时自动移除多边形。
+ * 
+ * 注意：points数组长度必须大于等于3才能有效绘制多边形。
  */
 export default function Polygon(props: PolygonProps) {
   const { points, fillColor, strokeColor, strokeWidth, zIndex } = props;
   const nativeRef = useContext(MapContext);
-  const polygonIdRef = useRef<string>(`polygon_${Date.now()}_${Math.random()}`);
-
+  const polygonIdRef = useRef<string | null>(null);
+  const propsRef = useRef(props);
+  
   useEffect(() => {
-    const polygonId = polygonIdRef.current;
+    propsRef.current = props;
+  }, [props]);
 
-    // 添加多边形
-    if (nativeRef?.current && points && points.length >= 3) {
-      try {
-        console.log('🟦 Polygon 组件调用 addPolygon:', polygonId, {
-          points,
-          fillColor: fillColor ?? 0x440000FF,
-          strokeColor: strokeColor ?? -16776961,
-          strokeWidth: strokeWidth ?? 10,
-          zIndex: zIndex ?? 0,
-        });
-        
+  useEffect(() => {
+    const checkAndAdd = () => {
+      if (!nativeRef?.current) {
+        setTimeout(checkAndAdd, 50);
+        return;
+      }
+      
+      const polygonId = `polygon_${Date.now()}_${Math.random()}`;
+      polygonIdRef.current = polygonId;
+      
+      const { points, fillColor, strokeColor, strokeWidth, zIndex } = propsRef.current;
+      
+      if (points && points.length >= 3) {
         nativeRef.current.addPolygon(polygonId, {
           points,
-          fillColor: fillColor ?? 0x440000FF,
-          strokeColor: strokeColor ?? -16776961,
+          fillColor: fillColor ?? '#880000FF',
+          strokeColor: strokeColor ?? '#FFFF0000',
           strokeWidth: strokeWidth ?? 10,
           zIndex: zIndex ?? 0,
         });
-        
-        console.log('✅ Polygon addPolygon 调用完成');
-      } catch (error) {
-        console.error('❌ 添加多边形失败:', error);
       }
-    } else {
-      console.warn('⚠️ Polygon 组件条件不满足:', {
-        hasNativeRef: !!nativeRef?.current,
-        hasPoints: !!points,
-        pointsLength: points?.length,
-      });
-    }
-
-    // 清理函数
+    };
+    
+    checkAndAdd();
+    
     return () => {
-      if (nativeRef?.current) {
-        try {
-          nativeRef.current.removePolygon(polygonId);
-        } catch (error) {
-          console.error('移除多边形失败:', error);
-        }
+      if (polygonIdRef.current && nativeRef?.current) {
+        nativeRef.current.removePolygon(polygonIdRef.current);
       }
     };
   }, []);
 
-  // 更新多边形属性
   useEffect(() => {
-    const polygonId = polygonIdRef.current;
-
-    if (nativeRef?.current) {
-      try {
-        nativeRef.current.updatePolygon(polygonId, {
-          points,
-          fillColor,
-          strokeColor,
-          strokeWidth,
-          zIndex,
-        });
-      } catch (error) {
-        console.error('更新多边形失败:', error);
-      }
+    if (polygonIdRef.current && nativeRef?.current) {
+      nativeRef.current.updatePolygon(polygonIdRef.current, {
+        points,
+        fillColor,
+        strokeColor,
+        strokeWidth,
+        zIndex,
+      });
     }
   }, [points, fillColor, strokeColor, strokeWidth, zIndex]);
 

package/src/components/overlays/Polyline.tsx

@@ -1,56 +1,59 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:01:30
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 01:08:27
- * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx
- * @Description  : 地图折线组件 - 使用命令式 API
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
 
 import * as React from 'react';
 import { MapContext } from '../../ExpoGaodeMapView';
 import type { PolylineProps } from '../../types';
 
+
 /**
- * 地图折线组件
+ * Polyline 组件用于在高德地图上绘制折线
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <Polyline
- *     points={[
- *       { latitude: 39.9, longitude: 116.4 },
- *       { latitude: 39.91, longitude: 116.41 },
- *     ]}
- *     color="#FF0000"
- *     width={5}
- *   />
- * </MapView>
- * ```
+ * @param props - 折线的配置属性
+ * @param props.points - 折线的坐标点数组
+ * @param props.width - 折线的宽度（像素）
+ * @param props.color - 折线的颜色（十六进制或RGBA）
+ * @param [props.texture] - 可选，折线的纹理样式
+ * 
+ * @remarks
+ * 组件内部使用 React 的 useEffect 钩子来管理折线的生命周期：
+ * 1. 组件挂载时创建折线并添加到地图
+ * 2. 组件卸载时自动从地图移除折线
+ * 3. 使用 ref 保存折线ID以便清理
  */
 export default function Polyline(props: PolylineProps) {
   const mapRef = React.useContext(MapContext);
   const polylineIdRef = React.useRef<string | null>(null);
-
-  // 添加折线
+  const propsRef = React.useRef(props);
+  
   React.useEffect(() => {
-    const polylineId = `polyline_${Date.now()}_${Math.random()}`;
-    polylineIdRef.current = polylineId;
-    
-    // 只传递必要的属性
-    const polylineProps = {
-      points: props.points,
-      width: props.width,
-      color: props.color,
-      ...(props.texture && { texture: props.texture }),
+    propsRef.current = props;
+  }, [props]);
+  
+  React.useEffect(() => {
+    const checkAndAdd = () => {
+      if (!mapRef?.current) {
+        setTimeout(checkAndAdd, 50);
+        return;
+      }
+      
+      const polylineId = `polyline_${Date.now()}_${Math.random()}`;
+      polylineIdRef.current = polylineId;
+      
+      const polylineProps = {
+        points: propsRef.current.points,
+        width: propsRef.current.width,
+        color: propsRef.current.color,
+        ...(propsRef.current.texture && { texture: propsRef.current.texture }),
+      };
+      
+      mapRef.current.addPolyline(polylineId, polylineProps);
     };
     
-    mapRef?.current?.addPolyline?.(polylineId, polylineProps);
-
+    checkAndAdd();
+    
     return () => {
-      mapRef?.current?.removePolyline?.(polylineId);
+      if (polylineIdRef.current && mapRef?.current) {
+        mapRef.current.removePolyline(polylineIdRef.current);
+      }
     };
   }, []);
 

package/src/components/overlays/index.ts

@@ -1,14 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:03:10
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 15:03:22
- * @FilePath     : /expo-gaode-map/src/components/overlays/index.ts
- * @Description  : 覆盖物组件统一导出
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 export { default as Marker } from './Marker';
 export { default as Polyline } from './Polyline';
 export { default as Polygon } from './Polygon';

package/src/index.ts

@@ -1,14 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:45:15
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 02:21:17
- * @FilePath     : /expo-gaode-map/src/index.ts
- * @Description  : 高德地图 Expo Module 主导出文件
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 // 导出类型定义
 export * from './ExpoGaodeMap.types';
 export * from './types';

package/src/modules/AMapLocation.ts

@@ -1,13 +1,4 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:42:10
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:42:15
- * @FilePath     : /expo-gaode-map/src/modules/AMapLocation.ts
- * @Description  : 高德地图定位模块
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
+//高德地图定位模块
 
 import { EventSubscription } from 'expo-modules-core';
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
@@ -21,7 +12,26 @@ import type {
 } from '../types';
 
 /**
- * 配置定位选项
+ * 配置高德地图定位服务的各项参数
+ * @param {LocationOptions} options - 定位配置选项对象
+ * @param {boolean} [options.withReGeocode] - 是否返回逆地理编码信息
+ * @param {number} [options.accuracy] - 定位精度设置
+ * @param {string} [options.mode] - 定位模式
+ * @param {boolean} [options.onceLocation] - 是否单次定位
+ * @param {number} [options.interval] - 定位间隔(毫秒)
+ * @param {number} [options.timeout] - 定位超时时间(毫秒)
+ * @param {number} [options.reGeocodeTimeout] - 逆地理编码超时时间(毫秒)
+ * @param {number} [options.distanceFilter] - 位置更新最小距离(米)
+ * @param {boolean} [options.sensorEnable] - 是否启用传感器
+ * @param {boolean} [options.wifiScan] - 是否开启WiFi扫描
+ * @param {boolean} [options.gpsFirst] - 是否优先使用GPS
+ * @param {boolean} [options.onceLocationLatest] - 是否获取最近3秒内最精确的位置
+ * @param {string} [options.geoLanguage] - 地理编码语言
+ * @param {boolean} [options.allowsBackgroundLocationUpdates] - 是否允许后台定位
+ * @param {boolean} [options.pausesLocationUpdatesAutomatically] - 是否自动暂停定位
+ * @param {boolean} [options.locationCacheEnable] - 是否启用定位缓存
+ * @param {number} [options.httpTimeout] - 网络请求超时时间(毫秒)
+ * @param {string} [options.protocol] - 定位协议
  */
 export function configure(options: LocationOptions): void {
   if (options.withReGeocode !== undefined) {
@@ -80,36 +90,49 @@ export function configure(options: LocationOptions): void {
   }
 }
 
+
 /**
- * 开始连续定位
+ * 启动高德地图模块,开始连续定位
+ * @throws 如果模块未初始化或启动失败时抛出异常
  */
 export function start(): void {
   ExpoGaodeMapModule.start?.();
 }
 
+
 /**
- * 停止定位
+ * 停止高德地图相关功能,停止定位
+ * @returns {void} 无返回值
  */
 export function stop(): void {
   ExpoGaodeMapModule.stop?.();
 }
 
+
 /**
- * 是否正在定位
+ * 检查高德地图模块是否已启动,是否正在定位
+ * @returns {Promise<boolean>} 返回一个Promise，解析为布尔值表示模块是否已启动
  */
 export async function isStarted(): Promise<boolean> {
   return ExpoGaodeMapModule.isStarted?.() || Promise.resolve(false);
 }
 
+
 /**
- * 获取当前位置（单次定位）
+ * 获取设备当前位置信息,单次定位
+ * @returns {Promise<Coordinates | ReGeocode>} 返回包含坐标或逆地理编码信息的Promise
+ * @throws 如果定位服务不可用或权限被拒绝时抛出错误
  */
 export async function getCurrentLocation(): Promise<Coordinates | ReGeocode> {
   return ExpoGaodeMapModule.getCurrentLocation?.();
 }
 
+
 /**
- * 添加定位监听器
+ * 添加位置更新监听器
+ * @param {LocationListener} listener - 位置更新时的回调函数
+ * @returns {EventSubscription} 事件订阅对象，包含移除监听器的方法
+ * @throws 如果底层模块不可用，返回一个空操作的订阅对象
  */
 export function addLocationListener(listener: LocationListener): EventSubscription {
   return ExpoGaodeMapModule.addListener?.('onLocationUpdate', listener) || {
@@ -117,8 +140,13 @@ export function addLocationListener(listener: LocationListener): EventSubscripti
   } as EventSubscription;
 }
 
+
 /**
- * 坐标转换
+ * 将坐标点转换为指定坐标系下的坐标
+ * @param {LatLng} coordinate - 需要转换的原始坐标点
+ * @param {CoordinateType} type - 目标坐标系类型
+ * @returns {Promise<LatLng>} 转换后的坐标点Promise
+ * @throws 如果底层模块不可用，则返回原始坐标
  */
 export async function coordinateConvert(
   coordinate: LatLng,
@@ -127,16 +155,22 @@ export async function coordinateConvert(
   return ExpoGaodeMapModule.coordinateConvert?.(coordinate, type) || Promise.resolve(coordinate);
 }
 
+
 /**
- * 开始获取设备朝向
+ * 开始更新设备方向（罗盘朝向）
+ * 调用原生模块方法启动方向更新功能
+ * @throws 如果原生模块未实现此方法会抛出异常
  * @platform ios
  */
 export function startUpdatingHeading(): void {
   ExpoGaodeMapModule.startUpdatingHeading?.();
 }
 
+
 /**
- * 停止获取设备朝向
+ * 停止更新设备方向（罗盘朝向）
+ * 调用原生模块方法停止监听设备方向变化
+ * @throws 如果原生模块未实现此方法会抛出异常
  * @platform ios
  */
 export function stopUpdatingHeading(): void {
@@ -144,7 +178,9 @@ export function stopUpdatingHeading(): void {
 }
 
 /**
- * 设置 API Key
+ * 设置高德地图的API密钥
+ * @param {string} key - 高德地图的API密钥
+ * @returns {void}
  */
 export function setApiKey(key: string): void {
   ExpoGaodeMapModule.setApiKey?.(key);

package/src/modules/AMapPermissions.ts

@@ -1,13 +1,4 @@
-/*
- * @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. 
- */
+
 /*
  * 高德地图权限管理模块
  */
@@ -29,7 +20,8 @@ export interface PermissionStatus {
 }
 
 /**
- * 检查位置权限状态
+ * 检查当前应用是否具有位置权限
+ * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态
  */
 export async function checkLocationPermission(): Promise<PermissionStatus> {
   return await ExpoGaodeMapModule.checkLocationPermission();
@@ -37,6 +29,7 @@ export async function checkLocationPermission(): Promise<PermissionStatus> {
 
 /**
  * 请求位置权限
+ * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态
  */
 export async function requestLocationPermission(): Promise<PermissionStatus> {
   return await ExpoGaodeMapModule.requestLocationPermission();

package/src/modules/AMapSDK.ts

@@ -1,13 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:41:55
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-14 16:15:20
- * @FilePath     : /expo-gaode-map/src/modules/AMapSDK.ts
- * @Description  : 
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
 /**
  * 高德地图 SDK 模块
  * 基于 Expo Modules 实现
@@ -16,17 +6,20 @@
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
 import type { SDKConfig } from '../types';
 
+
 /**
- * 初始化高德地图 SDK
- * @param config SDK 配置
+ * 初始化高德地图SDK
+ * @param {SDKConfig} config - SDK配置参数
+ * @throws 如果初始化失败会抛出异常
  */
 export function initSDK(config: SDKConfig): void {
   ExpoGaodeMapModule.initSDK?.(config);
 }
 
+
 /**
- * 获取 SDK 版本号
- * @returns SDK 版本
+ * 获取高德地图SDK的版本号
+ * @returns {Promise<string>} 返回一个Promise，解析为高德地图SDK的版本字符串，如果获取失败则返回'unknown'
  */
 export async function getVersion(): Promise<string> {
   return ExpoGaodeMapModule.getVersion?.() || Promise.resolve('unknown');