expo-gaode-map 2.2.4-next.0 → 2.2.4-next.2

package/build/ExpoGaodeMapView.js

@@ -1,5 +1,6 @@
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
+import { ErrorHandler } from './utils/ErrorHandler';
 const NativeView = requireNativeViewManager('ExpoGaodeMapView');
 /**
  * 高德地图视图组件，提供地图操作API和覆盖物管理功能
@@ -22,63 +23,34 @@ const NativeView = requireNativeViewManager('ExpoGaodeMapView');
 const ExpoGaodeMapView = React.forwardRef((props, ref) => {
     const nativeRef = React.useRef(null);
     const internalRef = React.useRef(null);
+    /**
+     * 🔑 性能优化：通用 API 方法包装器
+     * 统一处理初始化检查和错误处理，减少重复代码
+     */
+    const createApiMethod = React.useCallback((methodName) => {
+        return ((...args) => {
+            if (!nativeRef.current) {
+                throw ErrorHandler.mapViewNotInitialized(methodName);
+            }
+            try {
+                return nativeRef.current[methodName](...args);
+            }
+            catch (error) {
+                throw ErrorHandler.wrapNativeError(error, methodName);
+            }
+        });
+    }, []);
+    /**
+     * 使用通用包装器创建所有 API 方法
+     * 所有方法共享相同的错误处理逻辑
+     */
     const apiRef = React.useMemo(() => ({
-        /**
-         * 移动地图相机到指定位置
-         * @param position 相机位置参数对象，包含目标经纬度、缩放级别等信息
-         * @param duration 动画持续时间（毫秒），默认300毫秒
-         * @throws 如果地图视图未初始化则抛出错误
-         * @returns Promise<void> 异步操作完成后的Promise
-         */
-        moveCamera: async (position, duration = 300) => {
-            if (!nativeRef.current)
-                throw new Error('MapView not initialized');
-            return nativeRef.current.moveCamera(position, duration);
-        },
-        /**
-         * 将屏幕坐标点转换为地理坐标（经纬度）
-         * @param point 屏幕坐标点 {x: number, y: number}
-         * @returns 返回Promise，解析为对应的地理坐标 {latitude: number, longitude: number}
-         * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'
-         */
-        getLatLng: async (point) => {
-            if (!nativeRef.current)
-                throw new Error('MapView not initialized');
-            return nativeRef.current.getLatLng(point);
-        },
-        /**
-         * 设置地图中心点坐标
-         * @param center 要设置的中心点坐标(LatLng格式)
-         * @param animated 是否使用动画效果移动地图(默认为false)
-         * @throws 如果地图视图未初始化则抛出错误
-         */
-        setCenter: async (center, animated = false) => {
-            if (!nativeRef.current)
-                throw new Error('MapView not initialized');
-            return nativeRef.current.setCenter(center, animated);
-        },
-        /**
-         * 设置地图的缩放级别
-         * @param zoom 目标缩放级别
-         * @param animated 是否使用动画过渡效果，默认为false
-         * @throws 如果地图视图未初始化，抛出错误
-         */
-        setZoom: async (zoom, animated = false) => {
-            if (!nativeRef.current)
-                throw new Error('MapView not initialized');
-            return nativeRef.current.setZoom(zoom, animated);
-        },
-        /**
-         * 获取当前地图的相机位置（视角中心点、缩放级别、倾斜角度等）
-         * @returns 返回一个Promise，解析为当前相机位置的对象
-         * @throws 如果地图视图未初始化，则抛出错误
-         */
-        getCameraPosition: async () => {
-            if (!nativeRef.current)
-                throw new Error('MapView not initialized');
-            return nativeRef.current.getCameraPosition();
-        }
-    }), []);
+        moveCamera: createApiMethod('moveCamera'),
+        getLatLng: createApiMethod('getLatLng'),
+        setCenter: createApiMethod('setCenter'),
+        setZoom: createApiMethod('setZoom'),
+        getCameraPosition: createApiMethod('getCameraPosition'),
+    }), [createApiMethod]);
     /**
      * 将传入的apiRef赋值给internalRef.current
      * 用于在组件内部保存对地图API实例的引用
@@ -93,7 +65,7 @@ const ExpoGaodeMapView = React.forwardRef((props, ref) => {
     React.useImperativeHandle(ref, () => apiRef, [apiRef]);
     return (<NativeView ref={nativeRef} {...props}>
           {props.children}
-        </NativeView>);
+      </NativeView>);
 });
 ExpoGaodeMapView.displayName = 'ExpoGaodeMapView';
 export default ExpoGaodeMapView;

package/build/ExpoGaodeMapView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,MAAM,UAAU,GAAwE,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;AAGrI;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,CAA2B,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACjF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAa,IAAI,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAoB,IAAI,CAAC,CAAC;IAG1D,MAAM,MAAM,GAAe,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9C;;;;;;WAMG;QACH,UAAU,EAAE,KAAK,EAAE,QAAwB,EAAE,WAAmB,GAAG,EAAE,EAAE;YACrE,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;QACD;;;;;WAKG;QACH,SAAS,EAAE,KAAK,EAAE,KAAY,EAAE,EAAE;YAChC,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD;;;;;WAKG;QACH,SAAS,EAAE,KAAK,EAAE,MAAc,EAAE,WAAoB,KAAK,EAAE,EAAE;YAC7D,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC;QACD;;;;;WAKG;QACH,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,WAAoB,KAAK,EAAE,EAAE;YACzD,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QACD;;;;WAIG;QACH,iBAAiB,EAAE,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnE,OAAO,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC/C,CAAC;KAEF,CAAC,EAAE,EAAE,CAAC,CAAC;IAER;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC;IAC/B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,CACL,CAAC,UAAU,CACP,GAAG,CAAC,CAAC,SAAS,CAAC,CACb,IAAI,KAAK,CAAC,CACV;UAAA,CAAC,KAAK,CAAC,QAAQ,CACjB;QAAA,EAAE,UAAU,CAAC,CAClB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,gBAAgB,CAAC,WAAW,GAAG,kBAAkB,CAAC;AAElD,eAAe,gBAAgB,CAAC","sourcesContent":["import { requireNativeViewManager } from 'expo-modules-core';\nimport * as React from 'react';\n\nimport type {\n  MapViewProps,\n  MapViewRef,\n  CameraPosition,\n  LatLng,\n  Point,\n\n} from './types';\n\nexport type { MapViewRef } from './types';\n\nconst NativeView: React.ComponentType<MapViewProps & { ref?: React.Ref<MapViewRef> }> = requireNativeViewManager('ExpoGaodeMapView');\n\n\n/**\n * 高德地图视图组件，提供地图操作API和覆盖物管理功能\n * \n * @param props - 组件属性\n * @param ref - 外部ref引用，用于访问地图API方法\n * @returns 返回包含地图视图和上下文提供者的React组件\n * \n * @remarks\n * 该组件内部维护两个ref：\n * - nativeRef: 指向原生地图视图的引用\n * - internalRef: 内部使用的API引用，通过MapContext共享\n * \n * 提供的主要API功能包括：\n * - 相机控制（移动、缩放、获取当前位置）\n * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）\n * \n * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误\n */\nconst ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref) => {\n  const nativeRef = React.useRef<MapViewRef>(null);\n  const internalRef = React.useRef<MapViewRef | null>(null);\n  \n\n  const apiRef: MapViewRef = React.useMemo(() => ({\n    /**\n     * 移动地图相机到指定位置\n     * @param position 相机位置参数对象，包含目标经纬度、缩放级别等信息\n     * @param duration 动画持续时间（毫秒），默认300毫秒\n     * @throws 如果地图视图未初始化则抛出错误\n     * @returns Promise<void> 异步操作完成后的Promise\n     */\n    moveCamera: async (position: CameraPosition, duration: number = 300) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.moveCamera(position, duration);\n    },\n    /**\n     * 将屏幕坐标点转换为地理坐标（经纬度）\n     * @param point 屏幕坐标点 {x: number, y: number}\n     * @returns 返回Promise，解析为对应的地理坐标 {latitude: number, longitude: number}\n     * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'\n     */\n    getLatLng: async (point: Point) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.getLatLng(point);\n    },\n    /**\n     * 设置地图中心点坐标\n     * @param center 要设置的中心点坐标(LatLng格式)\n     * @param animated 是否使用动画效果移动地图(默认为false)\n     * @throws 如果地图视图未初始化则抛出错误\n     */\n    setCenter: async (center: LatLng, animated: boolean = false) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.setCenter(center, animated);\n    },\n    /**\n     * 设置地图的缩放级别\n     * @param zoom 目标缩放级别\n     * @param animated 是否使用动画过渡效果，默认为false\n     * @throws 如果地图视图未初始化，抛出错误\n     */\n    setZoom: async (zoom: number, animated: boolean = false) => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.setZoom(zoom, animated);\n    },\n    /**\n     * 获取当前地图的相机位置（视角中心点、缩放级别、倾斜角度等）\n     * @returns 返回一个Promise，解析为当前相机位置的对象\n     * @throws 如果地图视图未初始化，则抛出错误\n     */\n    getCameraPosition: async () => {\n      if (!nativeRef.current) throw new Error('MapView not initialized');\n      return nativeRef.current.getCameraPosition();\n    }\n\n  }), []);\n\n  /**\n   * 将传入的apiRef赋值给internalRef.current\n   * 用于在组件内部保存对地图API实例的引用\n   */\n  React.useEffect(() => {\n    internalRef.current = apiRef;\n  }, [apiRef]);\n\n  /**\n   * 获取当前地图实例的API引用\n   * @returns 返回地图API的引用对象，可用于调用地图相关方法\n   */\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n\n  return (\n    <NativeView\n        ref={nativeRef}\n          {...props}>\n          {props.children}\n        </NativeView>\n  );\n});\n\nExpoGaodeMapView.displayName = 'ExpoGaodeMapView';\n\nexport default ExpoGaodeMapView;\n"]}
+{"version":3,"file":"ExpoGaodeMapView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIpD,MAAM,UAAU,GAAwE,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;AAGrI;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,gBAAgB,GAAG,KAAK,CAAC,UAAU,CAA2B,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACjF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAa,IAAI,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAoB,IAAI,CAAC,CAAC;IAE1D;;;OAGG;IACH,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAC,CACxC,UAA4B,EAC5B,EAAE;QACF,OAAO,CAAC,CAAC,GAAG,IAAmB,EAAE,EAAE;YACjC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,YAAY,CAAC,qBAAqB,CAAC,UAAoB,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,CAAC;gBACH,OAAQ,SAAS,CAAC,OAAO,CAAC,UAAU,CAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YACvD,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,UAAoB,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAM,CAAC;IACV,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP;;;OAGG;IACH,MAAM,MAAM,GAAe,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9C,UAAU,EAAE,eAAe,CAAiE,YAAY,CAAC;QACzG,SAAS,EAAE,eAAe,CAAoC,WAAW,CAAC;QAC1E,SAAS,EAAE,eAAe,CAAwD,WAAW,CAAC;QAC9F,OAAO,EAAE,eAAe,CAAsD,SAAS,CAAC;QACxF,iBAAiB,EAAE,eAAe,CAAgC,mBAAmB,CAAC;KACvF,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEvB;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC;IAC/B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,CACL,CAAC,UAAU,CACP,GAAG,CAAC,CAAC,SAAS,CAAC,CACb,IAAI,KAAK,CAAC,CACV;UAAA,CAAC,KAAK,CAAC,QAAQ,CACnB;MAAA,EAAE,UAAU,CAAC,CAChB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,gBAAgB,CAAC,WAAW,GAAG,kBAAkB,CAAC;AAElD,eAAe,gBAAgB,CAAC","sourcesContent":["import { requireNativeViewManager } from 'expo-modules-core';\nimport * as React from 'react';\n\nimport type {\n  MapViewProps,\n  MapViewRef,\n  CameraPosition,\n  LatLng,\n  Point,\n\n} from './types';\nimport { ErrorHandler } from './utils/ErrorHandler';\n\nexport type { MapViewRef } from './types';\n\nconst NativeView: React.ComponentType<MapViewProps & { ref?: React.Ref<MapViewRef> }> = requireNativeViewManager('ExpoGaodeMapView');\n\n\n/**\n * 高德地图视图组件，提供地图操作API和覆盖物管理功能\n * \n * @param props - 组件属性\n * @param ref - 外部ref引用，用于访问地图API方法\n * @returns 返回包含地图视图和上下文提供者的React组件\n * \n * @remarks\n * 该组件内部维护两个ref：\n * - nativeRef: 指向原生地图视图的引用\n * - internalRef: 内部使用的API引用，通过MapContext共享\n * \n * 提供的主要API功能包括：\n * - 相机控制（移动、缩放、获取当前位置）\n * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）\n * \n * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误\n */\nconst ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref) => {\n  const nativeRef = React.useRef<MapViewRef>(null);\n  const internalRef = React.useRef<MapViewRef | null>(null);\n  \n  /**\n   * 🔑 性能优化：通用 API 方法包装器\n   * 统一处理初始化检查和错误处理，减少重复代码\n   */\n  const createApiMethod = React.useCallback(<T extends (...args: any[]) => any>(\n    methodName: keyof MapViewRef\n  ) => {\n    return ((...args: Parameters<T>) => {\n      if (!nativeRef.current) {\n        throw ErrorHandler.mapViewNotInitialized(methodName as string);\n      }\n      try {\n        return (nativeRef.current[methodName] as T)(...args);\n      } catch (error: any) {\n        throw ErrorHandler.wrapNativeError(error, methodName as string);\n      }\n    }) as T;\n  }, []);\n\n  /**\n   * 使用通用包装器创建所有 API 方法\n   * 所有方法共享相同的错误处理逻辑\n   */\n  const apiRef: MapViewRef = React.useMemo(() => ({\n    moveCamera: createApiMethod<(position: CameraPosition, duration?: number) => Promise<void>>('moveCamera'),\n    getLatLng: createApiMethod<(point: Point) => Promise<LatLng>>('getLatLng'),\n    setCenter: createApiMethod<(center: LatLng, animated?: boolean) => Promise<void>>('setCenter'),\n    setZoom: createApiMethod<(zoom: number, animated?: boolean) => Promise<void>>('setZoom'),\n    getCameraPosition: createApiMethod<() => Promise<CameraPosition>>('getCameraPosition'),\n  }), [createApiMethod]);\n\n  /**\n   * 将传入的apiRef赋值给internalRef.current\n   * 用于在组件内部保存对地图API实例的引用\n   */\n  React.useEffect(() => {\n    internalRef.current = apiRef;\n  }, [apiRef]);\n\n  /**\n   * 获取当前地图实例的API引用\n   * @returns 返回地图API的引用对象，可用于调用地图相关方法\n   */\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n\n  return (\n    <NativeView\n        ref={nativeRef}\n          {...props}>\n          {props.children}\n      </NativeView>\n  );\n});\n\nExpoGaodeMapView.displayName = 'ExpoGaodeMapView';\n\nexport default ExpoGaodeMapView;\n"]}

package/build/OfflineMapManager.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 离线地图便捷 API
+ * 提供更友好的 API 接口和事件监听
+ */
+import type { OfflineMapInfo, OfflineMapDownloadConfig, OfflineMapDownloadEvent, OfflineMapCompleteEvent, OfflineMapErrorEvent, OfflineMapPausedEvent, OfflineMapCancelledEvent, OfflineMapStorageInfo } from './types/offline.types';
+/**
+ * 离线地图管理类
+ */
+export declare class OfflineMapManager {
+    /**
+     * 获取所有可下载的城市列表
+     */
+    static getAvailableCities(): Promise<OfflineMapInfo[]>;
+    /**
+     * 获取所有省份列表
+     */
+    static getAvailableProvinces(): Promise<OfflineMapInfo[]>;
+    /**
+     * 根据省份代码获取城市列表
+     */
+    static getCitiesByProvince(provinceCode: string): Promise<OfflineMapInfo[]>;
+    /**
+     * 获取已下载的地图列表
+     */
+    static getDownloadedMaps(): Promise<OfflineMapInfo[]>;
+    /**
+     * 开始下载离线地图
+     */
+    static startDownload(config: OfflineMapDownloadConfig): Promise<void>;
+    /**
+     * 暂停下载
+     */
+    static pauseDownload(cityCode: string): Promise<void>;
+    /**
+     * 恢复下载
+     */
+    static resumeDownload(cityCode: string): Promise<void>;
+    /**
+     * 取消下载
+     */
+    static cancelDownload(cityCode: string): Promise<void>;
+    /**
+     * 删除离线地图
+     */
+    static deleteMap(cityCode: string): Promise<void>;
+    /**
+     * 更新离线地图
+     */
+    static updateMap(cityCode: string): Promise<void>;
+    /**
+     * 检查是否有可用更新
+     */
+    static checkUpdate(cityCode: string): Promise<boolean>;
+    /**
+     * 检查地图是否已下载
+     */
+    static isMapDownloaded(cityCode: string): Promise<boolean>;
+    /**
+     * 获取地图下载状态
+     */
+    static getMapStatus(cityCode: string): Promise<OfflineMapInfo>;
+    /**
+     * 获取所有下载任务的总进度
+     */
+    static getTotalProgress(): Promise<number>;
+    /**
+     * 获取当前正在下载的城市列表
+     */
+    static getDownloadingCities(): Promise<string[]>;
+    /**
+     * 获取离线地图占用的存储空间（字节）
+     */
+    static getStorageSize(): Promise<number>;
+    /**
+     * 获取详细的存储信息
+     */
+    static getStorageInfo(): Promise<OfflineMapStorageInfo>;
+    /**
+     * 清理所有离线地图
+     */
+    static clearAllMaps(): Promise<void>;
+    /**
+     * 设置离线地图存储路径
+     */
+    static setStoragePath(path: string): void;
+    /**
+     * 获取离线地图存储路径
+     */
+    static getStoragePath(): Promise<string>;
+    /**
+     * 批量下载地图
+     */
+    static batchDownload(cityCodes: string[], allowCellular?: boolean): Promise<void>;
+    /**
+     * 批量删除地图
+     */
+    static batchDelete(cityCodes: string[]): Promise<void>;
+    /**
+     * 批量更新地图
+     */
+    static batchUpdate(cityCodes: string[]): Promise<void>;
+    /**
+     * 暂停所有下载任务
+     */
+    static pauseAllDownloads(): Promise<void>;
+    /**
+     * 恢复所有下载任务
+     */
+    static resumeAllDownloads(): Promise<void>;
+    /**
+     * 监听下载进度事件
+     */
+    static addDownloadProgressListener(listener: (event: OfflineMapDownloadEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载完成事件
+     */
+    static addDownloadCompleteListener(listener: (event: OfflineMapCompleteEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载错误事件
+     */
+    static addDownloadErrorListener(listener: (event: OfflineMapErrorEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载暂停事件
+     */
+    static addDownloadPausedListener(listener: (event: OfflineMapPausedEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 监听下载取消事件
+     */
+    static addDownloadCancelledListener(listener: (event: OfflineMapCancelledEvent) => void): {
+        remove: () => void;
+    };
+    /**
+     * 移除所有监听器
+     */
+    static removeAllListeners(): void;
+}
+/**
+ * 默认导出管理类
+ */
+export default OfflineMapManager;
+//# sourceMappingURL=OfflineMapManager.d.ts.map

package/build/OfflineMapManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineMapManager.d.ts","sourceRoot":"","sources":["../src/OfflineMapManager.ts"],"names":[],"mappings":"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"}

package/build/OfflineMapManager.js

@@ -0,0 +1,211 @@
+/**
+ * 离线地图便捷 API
+ * 提供更友好的 API 接口和事件监听
+ */
+import ExpoGaodeMapOfflineModule from './OfflineMapModule';
+/**
+ * 离线地图管理类
+ */
+export class OfflineMapManager {
+    // ==================== 地图列表管理 ====================
+    /**
+     * 获取所有可下载的城市列表
+     */
+    static async getAvailableCities() {
+        return ExpoGaodeMapOfflineModule.getAvailableCities();
+    }
+    /**
+     * 获取所有省份列表
+     */
+    static async getAvailableProvinces() {
+        return ExpoGaodeMapOfflineModule.getAvailableProvinces();
+    }
+    /**
+     * 根据省份代码获取城市列表
+     */
+    static async getCitiesByProvince(provinceCode) {
+        return ExpoGaodeMapOfflineModule.getCitiesByProvince(provinceCode);
+    }
+    /**
+     * 获取已下载的地图列表
+     */
+    static async getDownloadedMaps() {
+        return ExpoGaodeMapOfflineModule.getDownloadedMaps();
+    }
+    // ==================== 下载管理 ====================
+    /**
+     * 开始下载离线地图
+     */
+    static async startDownload(config) {
+        return ExpoGaodeMapOfflineModule.startDownload(config);
+    }
+    /**
+     * 暂停下载
+     */
+    static async pauseDownload(cityCode) {
+        return ExpoGaodeMapOfflineModule.pauseDownload(cityCode);
+    }
+    /**
+     * 恢复下载
+     */
+    static async resumeDownload(cityCode) {
+        return ExpoGaodeMapOfflineModule.resumeDownload(cityCode);
+    }
+    /**
+     * 取消下载
+     */
+    static async cancelDownload(cityCode) {
+        return ExpoGaodeMapOfflineModule.cancelDownload(cityCode);
+    }
+    /**
+     * 删除离线地图
+     */
+    static async deleteMap(cityCode) {
+        return ExpoGaodeMapOfflineModule.deleteMap(cityCode);
+    }
+    /**
+     * 更新离线地图
+     */
+    static async updateMap(cityCode) {
+        return ExpoGaodeMapOfflineModule.updateMap(cityCode);
+    }
+    /**
+     * 检查是否有可用更新
+     */
+    static async checkUpdate(cityCode) {
+        return ExpoGaodeMapOfflineModule.checkUpdate(cityCode);
+    }
+    // ==================== 状态查询 ====================
+    /**
+     * 检查地图是否已下载
+     */
+    static async isMapDownloaded(cityCode) {
+        return ExpoGaodeMapOfflineModule.isMapDownloaded(cityCode);
+    }
+    /**
+     * 获取地图下载状态
+     */
+    static async getMapStatus(cityCode) {
+        return ExpoGaodeMapOfflineModule.getMapStatus(cityCode);
+    }
+    /**
+     * 获取所有下载任务的总进度
+     */
+    static async getTotalProgress() {
+        return ExpoGaodeMapOfflineModule.getTotalProgress();
+    }
+    /**
+     * 获取当前正在下载的城市列表
+     */
+    static async getDownloadingCities() {
+        return ExpoGaodeMapOfflineModule.getDownloadingCities();
+    }
+    // ==================== 存储管理 ====================
+    /**
+     * 获取离线地图占用的存储空间（字节）
+     */
+    static async getStorageSize() {
+        return ExpoGaodeMapOfflineModule.getStorageSize();
+    }
+    /**
+     * 获取详细的存储信息
+     */
+    static async getStorageInfo() {
+        return ExpoGaodeMapOfflineModule.getStorageInfo();
+    }
+    /**
+     * 清理所有离线地图
+     */
+    static async clearAllMaps() {
+        return ExpoGaodeMapOfflineModule.clearAllMaps();
+    }
+    /**
+     * 设置离线地图存储路径
+     */
+    static setStoragePath(path) {
+        ExpoGaodeMapOfflineModule.setStoragePath(path);
+    }
+    /**
+     * 获取离线地图存储路径
+     */
+    static async getStoragePath() {
+        return ExpoGaodeMapOfflineModule.getStoragePath();
+    }
+    // ==================== 批量操作 ====================
+    /**
+     * 批量下载地图
+     */
+    static async batchDownload(cityCodes, allowCellular = false) {
+        return ExpoGaodeMapOfflineModule.batchDownload(cityCodes, allowCellular);
+    }
+    /**
+     * 批量删除地图
+     */
+    static async batchDelete(cityCodes) {
+        return ExpoGaodeMapOfflineModule.batchDelete(cityCodes);
+    }
+    /**
+     * 批量更新地图
+     */
+    static async batchUpdate(cityCodes) {
+        return ExpoGaodeMapOfflineModule.batchUpdate(cityCodes);
+    }
+    /**
+     * 暂停所有下载任务
+     */
+    static async pauseAllDownloads() {
+        return ExpoGaodeMapOfflineModule.pauseAllDownloads();
+    }
+    /**
+     * 恢复所有下载任务
+     */
+    static async resumeAllDownloads() {
+        return ExpoGaodeMapOfflineModule.resumeAllDownloads();
+    }
+    // ==================== 事件监听 ====================
+    /**
+     * 监听下载进度事件
+     */
+    static addDownloadProgressListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadProgress', listener);
+    }
+    /**
+     * 监听下载完成事件
+     */
+    static addDownloadCompleteListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadComplete', listener);
+    }
+    /**
+     * 监听下载错误事件
+     */
+    static addDownloadErrorListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadError', listener);
+    }
+    /**
+     * 监听下载暂停事件
+     */
+    static addDownloadPausedListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadPaused', listener);
+    }
+    /**
+     * 监听下载取消事件
+     */
+    static addDownloadCancelledListener(listener) {
+        return ExpoGaodeMapOfflineModule.addListener('onDownloadCancelled', listener);
+    }
+    /**
+     * 移除所有监听器
+     */
+    static removeAllListeners() {
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadProgress');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadComplete');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadError');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadPaused');
+        ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadCancelled');
+    }
+}
+/**
+ * 默认导出管理类
+ */
+export default OfflineMapManager;
+//# sourceMappingURL=OfflineMapManager.js.map

package/build/OfflineMapManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineMapManager.js","sourceRoot":"","sources":["../src/OfflineMapManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 离线地图便捷 API\n * 提供更友好的 API 接口和事件监听\n */\n\nimport ExpoGaodeMapOfflineModule from './OfflineMapModule';\nimport type {\n  OfflineMapInfo,\n  OfflineMapDownloadConfig,\n  OfflineMapDownloadEvent,\n  OfflineMapCompleteEvent,\n  OfflineMapErrorEvent,\n  OfflineMapPausedEvent,\n  OfflineMapCancelledEvent,\n  OfflineMapStorageInfo,\n} from './types/offline.types';\n\n/**\n * 离线地图管理类\n */\nexport class OfflineMapManager {\n  // ==================== 地图列表管理 ====================\n  \n  /**\n   * 获取所有可下载的城市列表\n   */\n  static async getAvailableCities(): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getAvailableCities();\n  }\n  \n  /**\n   * 获取所有省份列表\n   */\n  static async getAvailableProvinces(): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getAvailableProvinces();\n  }\n  \n  /**\n   * 根据省份代码获取城市列表\n   */\n  static async getCitiesByProvince(provinceCode: string): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getCitiesByProvince(provinceCode);\n  }\n  \n  /**\n   * 获取已下载的地图列表\n   */\n  static async getDownloadedMaps(): Promise<OfflineMapInfo[]> {\n    return ExpoGaodeMapOfflineModule.getDownloadedMaps();\n  }\n  \n  // ==================== 下载管理 ====================\n  \n  /**\n   * 开始下载离线地图\n   */\n  static async startDownload(config: OfflineMapDownloadConfig): Promise<void> {\n    return ExpoGaodeMapOfflineModule.startDownload(config);\n  }\n  \n  /**\n   * 暂停下载\n   */\n  static async pauseDownload(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.pauseDownload(cityCode);\n  }\n  \n  /**\n   * 恢复下载\n   */\n  static async resumeDownload(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.resumeDownload(cityCode);\n  }\n  \n  /**\n   * 取消下载\n   */\n  static async cancelDownload(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.cancelDownload(cityCode);\n  }\n  \n  /**\n   * 删除离线地图\n   */\n  static async deleteMap(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.deleteMap(cityCode);\n  }\n  \n  /**\n   * 更新离线地图\n   */\n  static async updateMap(cityCode: string): Promise<void> {\n    return ExpoGaodeMapOfflineModule.updateMap(cityCode);\n  }\n  \n  /**\n   * 检查是否有可用更新\n   */\n  static async checkUpdate(cityCode: string): Promise<boolean> {\n    return ExpoGaodeMapOfflineModule.checkUpdate(cityCode);\n  }\n  \n  // ==================== 状态查询 ====================\n  \n  /**\n   * 检查地图是否已下载\n   */\n  static async isMapDownloaded(cityCode: string): Promise<boolean> {\n    return ExpoGaodeMapOfflineModule.isMapDownloaded(cityCode);\n  }\n  \n  /**\n   * 获取地图下载状态\n   */\n  static async getMapStatus(cityCode: string): Promise<OfflineMapInfo> {\n    return ExpoGaodeMapOfflineModule.getMapStatus(cityCode);\n  }\n  \n  /**\n   * 获取所有下载任务的总进度\n   */\n  static async getTotalProgress(): Promise<number> {\n    return ExpoGaodeMapOfflineModule.getTotalProgress();\n  }\n  \n  /**\n   * 获取当前正在下载的城市列表\n   */\n  static async getDownloadingCities(): Promise<string[]> {\n    return ExpoGaodeMapOfflineModule.getDownloadingCities();\n  }\n  \n  // ==================== 存储管理 ====================\n  \n  /**\n   * 获取离线地图占用的存储空间（字节）\n   */\n  static async getStorageSize(): Promise<number> {\n    return ExpoGaodeMapOfflineModule.getStorageSize();\n  }\n  \n  /**\n   * 获取详细的存储信息\n   */\n  static async getStorageInfo(): Promise<OfflineMapStorageInfo> {\n    return ExpoGaodeMapOfflineModule.getStorageInfo();\n  }\n  \n  /**\n   * 清理所有离线地图\n   */\n  static async clearAllMaps(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.clearAllMaps();\n  }\n  \n  /**\n   * 设置离线地图存储路径\n   */\n  static setStoragePath(path: string): void {\n    ExpoGaodeMapOfflineModule.setStoragePath(path);\n  }\n  \n  /**\n   * 获取离线地图存储路径\n   */\n  static async getStoragePath(): Promise<string> {\n    return ExpoGaodeMapOfflineModule.getStoragePath();\n  }\n  \n  // ==================== 批量操作 ====================\n  \n  /**\n   * 批量下载地图\n   */\n  static async batchDownload(cityCodes: string[], allowCellular = false): Promise<void> {\n    return ExpoGaodeMapOfflineModule.batchDownload(cityCodes, allowCellular);\n  }\n  \n  /**\n   * 批量删除地图\n   */\n  static async batchDelete(cityCodes: string[]): Promise<void> {\n    return ExpoGaodeMapOfflineModule.batchDelete(cityCodes);\n  }\n  \n  /**\n   * 批量更新地图\n   */\n  static async batchUpdate(cityCodes: string[]): Promise<void> {\n    return ExpoGaodeMapOfflineModule.batchUpdate(cityCodes);\n  }\n  \n  /**\n   * 暂停所有下载任务\n   */\n  static async pauseAllDownloads(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.pauseAllDownloads();\n  }\n  \n  /**\n   * 恢复所有下载任务\n   */\n  static async resumeAllDownloads(): Promise<void> {\n    return ExpoGaodeMapOfflineModule.resumeAllDownloads();\n  }\n  \n  // ==================== 事件监听 ====================\n  \n  /**\n   * 监听下载进度事件\n   */\n  static addDownloadProgressListener(\n    listener: (event: OfflineMapDownloadEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadProgress', listener);\n  }\n  \n  /**\n   * 监听下载完成事件\n   */\n  static addDownloadCompleteListener(\n    listener: (event: OfflineMapCompleteEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadComplete', listener);\n  }\n  \n  /**\n   * 监听下载错误事件\n   */\n  static addDownloadErrorListener(\n    listener: (event: OfflineMapErrorEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadError', listener);\n  }\n  \n  /**\n   * 监听下载暂停事件\n   */\n  static addDownloadPausedListener(\n    listener: (event: OfflineMapPausedEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadPaused', listener);\n  }\n  \n  /**\n   * 监听下载取消事件\n   */\n  static addDownloadCancelledListener(\n    listener: (event: OfflineMapCancelledEvent) => void\n  ): { remove: () => void } {\n    return ExpoGaodeMapOfflineModule.addListener('onDownloadCancelled', listener);\n  }\n  \n  /**\n   * 移除所有监听器\n   */\n  static removeAllListeners(): void {\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadProgress');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadComplete');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadError');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadPaused');\n    ExpoGaodeMapOfflineModule.removeAllListeners('onDownloadCancelled');\n  }\n}\n\n/**\n * 默认导出管理类\n */\nexport default OfflineMapManager;"]}

package/build/OfflineMapModule.d.ts

@@ -0,0 +1,140 @@
+/**
+ * 高德地图离线地图原生模块
+ */
+import { NativeModule } from 'expo';
+import type { OfflineMapInfo, OfflineMapDownloadConfig, OfflineMapStorageInfo, OfflineMapEvents } from './types/offline.types';
+/**
+ * 离线地图原生模块接口
+ */
+declare class ExpoGaodeMapOfflineModule extends NativeModule<OfflineMapEvents> {
+    /**
+     * 获取所有可下载的城市列表
+     * @returns Promise<OfflineMapInfo[]> 城市列表
+     */
+    getAvailableCities(): Promise<OfflineMapInfo[]>;
+    /**
+     * 获取所有省份列表
+     * @returns Promise<OfflineMapInfo[]> 省份列表
+     */
+    getAvailableProvinces(): Promise<OfflineMapInfo[]>;
+    /**
+     * 根据省份代码获取城市列表
+     * @param provinceCode 省份代码
+     * @returns Promise<OfflineMapInfo[]> 该省份下的城市列表
+     */
+    getCitiesByProvince(provinceCode: string): Promise<OfflineMapInfo[]>;
+    /**
+     * 获取已下载的地图列表
+     * @returns Promise<OfflineMapInfo[]> 已下载的地图列表
+     */
+    getDownloadedMaps(): Promise<OfflineMapInfo[]>;
+    /**
+     * 开始下载离线地图
+     * @param config 下载配置
+     */
+    startDownload(config: OfflineMapDownloadConfig): Promise<void>;
+    /**
+     * 暂停下载
+     * @param cityCode 城市代码
+     */
+    pauseDownload(cityCode: string): Promise<void>;
+    /**
+     * 恢复下载
+     * @param cityCode 城市代码
+     */
+    resumeDownload(cityCode: string): Promise<void>;
+    /**
+     * 取消下载
+     * @param cityCode 城市代码
+     */
+    cancelDownload(cityCode: string): Promise<void>;
+    /**
+     * 删除离线地图
+     * @param cityCode 城市代码
+     */
+    deleteMap(cityCode: string): Promise<void>;
+    /**
+     * 更新离线地图
+     * @param cityCode 城市代码
+     */
+    updateMap(cityCode: string): Promise<void>;
+    /**
+     * 检查是否有可用更新
+     * @param cityCode 城市代码
+     * @returns Promise<boolean> 是否有更新
+     */
+    checkUpdate(cityCode: string): Promise<boolean>;
+    /**
+     * 检查地图是否已下载
+     * @param cityCode 城市代码
+     * @returns Promise<boolean> 是否已下载
+     */
+    isMapDownloaded(cityCode: string): Promise<boolean>;
+    /**
+     * 获取地图下载状态
+     * @param cityCode 城市代码
+     * @returns Promise<OfflineMapInfo> 地图信息
+     */
+    getMapStatus(cityCode: string): Promise<OfflineMapInfo>;
+    /**
+     * 获取所有下载任务的总进度
+     * @returns Promise<number> 总进度 (0-100)
+     */
+    getTotalProgress(): Promise<number>;
+    /**
+     * 获取当前正在下载的城市列表
+     * @returns Promise<string[]> 城市代码列表
+     */
+    getDownloadingCities(): Promise<string[]>;
+    /**
+     * 获取离线地图占用的存储空间（字节）
+     * @returns Promise<number> 存储空间大小
+     */
+    getStorageSize(): Promise<number>;
+    /**
+     * 获取详细的存储信息
+     * @returns Promise<OfflineMapStorageInfo> 存储信息
+     */
+    getStorageInfo(): Promise<OfflineMapStorageInfo>;
+    /**
+     * 清理所有离线地图
+     */
+    clearAllMaps(): Promise<void>;
+    /**
+     * 设置离线地图存储路径
+     * @param path 存储路径
+     */
+    setStoragePath(path: string): void;
+    /**
+     * 获取离线地图存储路径
+     * @returns Promise<string> 存储路径
+     */
+    getStoragePath(): Promise<string>;
+    /**
+     * 批量下载地图
+     * @param cityCodes 城市代码列表
+     * @param allowCellular 是否允许移动网络
+     */
+    batchDownload(cityCodes: string[], allowCellular?: boolean): Promise<void>;
+    /**
+     * 批量删除地图
+     * @param cityCodes 城市代码列表
+     */
+    batchDelete(cityCodes: string[]): Promise<void>;
+    /**
+     * 批量更新地图
+     * @param cityCodes 城市代码列表
+     */
+    batchUpdate(cityCodes: string[]): Promise<void>;
+    /**
+     * 暂停所有下载任务
+     */
+    pauseAllDownloads(): Promise<void>;
+    /**
+     * 恢复所有下载任务
+     */
+    resumeAllDownloads(): Promise<void>;
+}
+declare const _default: ExpoGaodeMapOfflineModule;
+export default _default;
+//# sourceMappingURL=OfflineMapModule.d.ts.map