expo-gaode-map 2.2.9-next.0 → 2.2.9

package/build/ExpoGaodeMapModule.js

@@ -3,20 +3,19 @@
  * 提供 SDK 初始化、定位、权限管理等功能
  */
 import { requireNativeModule } from 'expo';
+import { ErrorHandler, ErrorLogger } from './utils/ErrorHandler';
 // 获取原生模块实例 - 添加容错处理
 let nativeModule = null;
 try {
     nativeModule = requireNativeModule('ExpoGaodeMap');
 }
 catch (error) {
-    console.warn('ExpoGaodeMap 原生模块加载失败:', error);
-}
-// 如果模块加载失败，创建一个空的代理对象防止崩溃
-if (!nativeModule) {
-    console.error('ExpoGaodeMap: 原生模块不可用，请检查配置');
+    const moduleError = ErrorHandler.nativeModuleUnavailable();
+    ErrorLogger.log(moduleError);
 }
 // 记录最近一次 initSDK 的配置（含 webKey）
 let _sdkConfig = null;
+let _isSDKInitialized = false;
 // 扩展原生模块，添加便捷方法
 const ExpoGaodeMapModuleWithHelpers = {
     ...(nativeModule || {}),
@@ -24,17 +23,152 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 初始化 SDK，并缓存配置（包含 webKey）
      */
     initSDK(config) {
-        _sdkConfig = config ?? null;
-        nativeModule?.initSDK?.(config);
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        // 验证 API Key 配置
+        if (!config.androidKey && !config.iosKey) {
+            throw ErrorHandler.invalidApiKey('both');
+        }
+        try {
+            _sdkConfig = config ?? null;
+            nativeModule.initSDK(config);
+            _isSDKInitialized = true;
+            ErrorLogger.warn('SDK 初始化成功', { config });
+        }
+        catch (error) {
+            _isSDKInitialized = false;
+            throw ErrorHandler.wrapNativeError(error, 'SDK 初始化');
+        }
+    },
+    /**
+     * 检查 SDK 是否已通过 JS 调用 initSDK() 初始化
+     * 注意：即使返回 false，原生端可能已通过 Config Plugin 自动初始化
+     */
+    isSDKInitialized() {
+        return _isSDKInitialized;
+    },
+    /**
+     * 开始连续定位
+     * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
+     */
+    start() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            nativeModule.start();
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '开始定位');
+        }
+    },
+    /**
+     * 停止定位
+     */
+    stop() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            nativeModule.stop();
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '停止定位');
+        }
+    },
+    /**
+     * 获取当前位置（单次定位）
+     * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
+     */
+    async getCurrentLocation() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            return await nativeModule.getCurrentLocation();
+        }
+        catch (error) {
+            throw ErrorHandler.locationFailed(error?.message);
+        }
+    },
+    /**
+     * 检查位置权限状态
+     */
+    async checkLocationPermission() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            return await nativeModule.checkLocationPermission();
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '检查权限');
+        }
+    },
+    /**
+     * 请求前台位置权限（增强版）
+     */
+    async requestLocationPermission() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            const result = await nativeModule.requestLocationPermission();
+            if (!result.granted) {
+                ErrorLogger.warn('前台位置权限未授予', result);
+            }
+            return result;
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '请求前台权限');
+        }
+    },
+    /**
+     * 请求后台位置权限
+     * 注意：必须在前台权限已授予后才能请求
+     */
+    async requestBackgroundLocationPermission() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            const result = await nativeModule.requestBackgroundLocationPermission();
+            if (!result.granted) {
+                ErrorLogger.warn('后台位置权限未授予', result);
+            }
+            return result;
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '请求后台权限');
+        }
+    },
+    /**
+     * 打开应用设置页面
+     * 引导用户手动授予权限
+     */
+    openAppSettings() {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
+        try {
+            nativeModule.openAppSettings();
+        }
+        catch (error) {
+            throw ErrorHandler.wrapNativeError(error, '打开设置');
+        }
     },
     /**
      * 添加定位监听器（便捷方法）
      * 自动订阅 onLocationUpdate 事件，提供容错处理
      * @param listener 定位回调函数
      * @returns 订阅对象，调用 remove() 取消监听
-     * @throws 如果底层模块不可用，返回一个空操作的订阅对象
+     * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
      */
     addLocationListener(listener) {
+        if (!nativeModule) {
+            throw ErrorHandler.nativeModuleUnavailable();
+        }
         // 使用可选链和空值合并，确保即使模块不可用也不会崩溃
         return nativeModule?.addListener?.('onLocationUpdate', listener) || {
             remove: () => { },

package/build/ExpoGaodeMapModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AA2RzD,oBAAoB;AACpB,IAAI,YAAY,GAA8B,IAAI,CAAC;AAEnD,IAAI,CAAC;IACH,YAAY,GAAG,mBAAmB,CAAqB,cAAc,CAAC,CAAC;AACzE,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,0BAA0B;AAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC/C,CAAC;AAED,+BAA+B;AAC/B,IAAI,UAAU,GAAqB,IAAI,CAAC;AAExC,gBAAgB;AAChB,MAAM,6BAA6B,GAAG;IACrC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,MAAiB;QACvB,UAAU,GAAG,MAAM,IAAI,IAAI,CAAC;QAC5B,YAAY,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,QAA0B;QAC5C,4BAA4B;QAC5B,OAAO,YAAY,EAAE,WAAW,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI;YAClE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACjB,CAAC;IACJ,CAAC;CACD,CAAC;AAEF;;EAEE;AACF,MAAM,UAAU,YAAY;IAC3B,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;EAEE;AACF,MAAM,UAAU,SAAS;IACxB,OAAO,UAAU,EAAE,MAAM,CAAC;AAC3B,CAAC;AAED,eAAe,6BAAmD,CAAC","sourcesContent":["/**\n * 高德地图原生模块\n * 提供 SDK 初始化、定位、权限管理等功能\n */\n\nimport { NativeModule, requireNativeModule } from 'expo';\nimport type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';\nimport type {\n  LatLng,\n  CoordinateType,\n  Coordinates,\n  ReGeocode,\n  LocationMode,\n  LocationAccuracy,\n  LocationListener,\n} from './types';\n\n/**\n * SDK 配置参数\n */\nexport interface SDKConfig {\n  /** Android 平台的高德地图 API Key */\n  androidKey?: string;\n  /** iOS 平台的高德地图 API Key */\n  iosKey?: string;\n  /** web api key 如果要使用expo-gaode-map-web-api相关的功能，需要配置web api key*/\n  webKey?: string;\n}\n\n/**\n * 权限状态\n */\nexport interface PermissionStatus {\n  /** 是否已授权 */\n  granted: boolean;\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n}\n\n/**\n * 高德地图原生模块类声明\n */\ndeclare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  // ==================== 隐私合规管理 ====================\n  \n  /**\n   * 更新隐私合规状态\n   * 必须在用户同意隐私协议后调用\n   * @param hasAgreed 用户是否已同意隐私协议\n   */\n  updatePrivacyCompliance(hasAgreed: boolean): void;\n  \n  // ==================== SDK 初始化 ====================\n  \n  /**\n   * 初始化高德地图 SDK\n   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key\n   */\n  initSDK(config: SDKConfig): void;\n  \n  /**\n   * 获取高德地图 SDK 版本号\n   * @returns SDK 版本字符串\n   */\n  getVersion(): string;\n  \n  // ==================== 定位控制 ====================\n  \n  /**\n   * 开始连续定位\n   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调\n   */\n  start(): void;\n  \n  /**\n   * 停止定位\n   * 停止接收位置更新\n   */\n  stop(): void;\n  \n  /**\n   * 检查是否正在定位\n   * @returns Promise<boolean> 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n  \n  /**\n   * 获取当前位置（单次定位）\n   * @returns Promise<Coordinates | ReGeocode> 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n  \n  /**\n   * 坐标转换\n   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系\n   * @param coordinate 需要转换的坐标\n   * @param type 原坐标系类型\n   * @returns Promise<LatLng> 转换后的 GCJ-02 坐标\n   */\n  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;\n  \n  // ==================== 定位配置 ====================\n  \n  /**\n   * 设置是否返回逆地理编码信息\n   * @param isReGeocode true: 返回地址信息; false: 只返回坐标\n   */\n  setLocatingWithReGeocode(isReGeocode: boolean): void;\n  \n  /**\n   * 设置定位模式（Android）\n   * @param mode 定位模式：0-低功耗, 1-仅设备, 2-高精度\n   */\n  setLocationMode(mode: LocationMode): void;\n  \n  /**\n   * 设置定位间隔（毫秒）\n   * @param interval 定位间隔时间，单位毫秒，默认 2000ms\n   */\n  setInterval(interval: number): void;\n  \n  /**\n   * 设置是否单次定位（Android）\n   * @param isOnceLocation true: 单次定位; false: 连续定位\n   */\n  setOnceLocation(isOnceLocation: boolean): void;\n  \n  /**\n   * 设置是否使用设备传感器（Android）\n   * @param sensorEnable true: 使用传感器; false: 不使用\n   */\n  setSensorEnable(sensorEnable: boolean): void;\n  \n  /**\n   * 设置是否允许 WiFi 扫描（Android）\n   * @param wifiScan true: 允许; false: 不允许\n   */\n  setWifiScan(wifiScan: boolean): void;\n  \n  /**\n   * 设置是否 GPS 优先（Android）\n   * @param gpsFirst true: GPS 优先; false: 网络优先\n   */\n  setGpsFirst(gpsFirst: boolean): void;\n  \n  /**\n   * 设置是否等待 WiFi 列表刷新（Android）\n   * @param onceLocationLatest true: 等待; false: 不等待\n   */\n  setOnceLocationLatest(onceLocationLatest: boolean): void;\n  \n  /**\n   * 设置逆地理编码语言\n   * @param language 语言代码，如 \"zh-CN\", \"en\"\n   */\n  setGeoLanguage(language: string): void;\n  \n  /**\n   * 设置是否使用缓存策略（Android）\n   * @param locationCacheEnable true: 使用缓存; false: 不使用\n   */\n  setLocationCacheEnable(locationCacheEnable: boolean): void;\n  \n  /**\n   * 设置网络请求超时时间（Android）\n   * @param httpTimeOut 超时时间，单位毫秒\n   */\n  setHttpTimeOut(httpTimeOut: number): void;\n  \n  /**\n   * 设置期望的定位精度（iOS）\n   * @param accuracy 精度级别：0-最佳, 1-10米, 2-100米, 3-1公里, 4-3公里\n   */\n  setDesiredAccuracy(accuracy: LocationAccuracy): void;\n  \n  /**\n   * 设置定位超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 10 秒\n   */\n  setLocationTimeout(timeout: number): void;\n  \n  /**\n   * 设置逆地理编码超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 5 秒\n   */\n  setReGeocodeTimeout(timeout: number): void;\n  \n  /**\n   * 设置距离过滤器（米）（iOS）\n   * 只有移动超过指定距离才会更新位置\n   * @param distance 距离阈值，单位米\n   */\n  setDistanceFilter(distance: number): void;\n  \n  /**\n   * 设置是否自动暂停位置更新（iOS）\n   * @param pauses true: 自动暂停; false: 不暂停\n   */\n  setPausesLocationUpdatesAutomatically(pauses: boolean): void;\n  \n  /**\n   * 设置是否允许后台定位（iOS）\n   * @param allows true: 允许; false: 不允许\n   */\n  setAllowsBackgroundLocationUpdates(allows: boolean): void;\n  \n  /**\n   * 设置定位协议\n   * @param protocol 协议类型\n   */\n  setLocationProtocol(protocol: string): void;\n  \n  // ==================== 方向更新 (iOS) ====================\n  \n  /**\n   * 开始更新设备方向（罗盘朝向）\n   * 通过 onHeadingUpdate 事件接收方向更新\n   * @platform ios\n   */\n  startUpdatingHeading(): void;\n  \n  /**\n   * 停止更新设备方向\n   * @platform ios\n   */\n  stopUpdatingHeading(): void;\n  \n  // ==================== 权限管理 ====================\n  \n  /**\n   * 检查位置权限状态\n   * @returns Promise<PermissionStatus> 权限状态\n   */\n  checkLocationPermission(): Promise<PermissionStatus>;\n  \n  /**\n   * 请求位置权限\n   * @returns Promise<PermissionStatus> 请求后的权限状态\n   */\n  requestLocationPermission(): Promise<PermissionStatus>;\n  \n  // ==================== 地图预加载 ====================\n  \n  /**\n   * 开始预加载地图实例\n   * 在后台预先初始化地图视图，提升首次显示速度\n   * @param config 预加载配置对象\n   * @param config.poolSize 预加载的地图实例数量，默认 2\n   */\n  startMapPreload(config: { poolSize?: number }): void;\n  \n  /**\n   * 获取预加载状态\n   * @returns 预加载状态信息，包含池大小、是否正在预加载等\n   */\n  getMapPreloadStatus(): {\n    poolSize: number;\n    isPreloading: boolean;\n    maxPoolSize: number;\n  };\n  \n  /**\n   * 清空预加载池\n   * 释放所有预加载的地图实例\n   */\n  clearMapPreloadPool(): void;\n  \n  /**\n   * 检查是否有可用的预加载实例\n   * @returns 是否有可用的预加载地图实例\n   */\n  hasPreloadedMapView(): boolean;\n  \n  // ==================== 便捷方法 ====================\n  \n  /**\n   * 添加定位监听器（便捷方法）\n   * 封装了 addListener，提供更简洁的 API\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n}\n\n// 获取原生模块实例 - 添加容错处理\nlet nativeModule: ExpoGaodeMapModule | null = null;\n\ntry {\n  nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');\n} catch (error) {\n  console.warn('ExpoGaodeMap 原生模块加载失败:', error);\n}\n\n// 如果模块加载失败，创建一个空的代理对象防止崩溃\nif (!nativeModule) {\n  console.error('ExpoGaodeMap: 原生模块不可用，请检查配置');\n}\n\n// 记录最近一次 initSDK 的配置（含 webKey）\nlet _sdkConfig: SDKConfig | null = null;\n\n// 扩展原生模块，添加便捷方法\nconst ExpoGaodeMapModuleWithHelpers = {\n ...(nativeModule || {}),\n\n /**\n  * 初始化 SDK，并缓存配置（包含 webKey）\n  */\n initSDK(config: SDKConfig): void {\n   _sdkConfig = config ?? null;\n   nativeModule?.initSDK?.(config);\n },\n\n /**\n  * 添加定位监听器（便捷方法）\n  * 自动订阅 onLocationUpdate 事件，提供容错处理\n  * @param listener 定位回调函数\n  * @returns 订阅对象，调用 remove() 取消监听\n  * @throws 如果底层模块不可用，返回一个空操作的订阅对象\n  */\n addLocationListener(listener: LocationListener): { remove: () => void } {\n   // 使用可选链和空值合并，确保即使模块不可用也不会崩溃\n   return nativeModule?.addListener?.('onLocationUpdate', listener) || {\n     remove: () => {},\n   };\n },\n};\n\n/**\n* 获取最近一次 initSDK 的配置\n*/\nexport function getSDKConfig(): SDKConfig | null {\n return _sdkConfig;\n}\n\n/**\n* 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）\n*/\nexport function getWebKey(): string | undefined {\n return _sdkConfig?.webKey;\n}\n\nexport default ExpoGaodeMapModuleWithHelpers as ExpoGaodeMapModule;\n"]}
+{"version":3,"file":"ExpoGaodeMapModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 高德地图原生模块\n * 提供 SDK 初始化、定位、权限管理等功能\n */\n\nimport { NativeModule, requireNativeModule } from 'expo';\n\nimport type {\n  LatLng,\n  CoordinateType,\n  Coordinates,\n  ReGeocode,\n  LocationMode,\n  LocationAccuracy,\n  LocationListener,\n} from './types';\nimport { ErrorHandler, ErrorLogger } from './utils/ErrorHandler';\nimport { ExpoGaodeMapModuleEvents } from './types/map-view.types';\nimport { SDKConfig,PermissionStatus } from './types/common.types';\n\n\n/**\n * 高德地图原生模块类声明\n */\ndeclare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  // ==================== 隐私合规管理 ====================\n  \n  /**\n   * 更新隐私合规状态\n   * 必须在用户同意隐私协议后调用\n   * @param hasAgreed 用户是否已同意隐私协议\n   * @deprecated 已经弃用，原生里默认为已同意,不再需要调用\n   */\n  updatePrivacyCompliance(hasAgreed: boolean): void;\n  \n  // ==================== SDK 初始化 ====================\n  \n  /**\n   * 初始化高德地图 SDK\n   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key\n   */\n  initSDK(config: SDKConfig): void;\n  \n  /**\n   * 获取高德地图 SDK 版本号\n   * @returns SDK 版本字符串\n   */\n  getVersion(): string;\n  \n  // ==================== 定位控制 ====================\n  \n  /**\n   * 开始连续定位\n   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调\n   */\n  start(): void;\n  \n  /**\n   * 停止定位\n   * 停止接收位置更新\n   */\n  stop(): void;\n  \n  /**\n   * 检查是否正在定位\n   * @returns Promise<boolean> 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n  \n  /**\n   * 获取当前位置（单次定位）\n   * @returns Promise<Coordinates | ReGeocode> 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n  \n  /**\n   * 坐标转换\n   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系\n   * @param coordinate 需要转换的坐标\n   * @param type 原坐标系类型\n   * @returns Promise<LatLng> 转换后的 GCJ-02 坐标\n   */\n  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;\n  \n  // ==================== 定位配置 ====================\n  \n  /**\n   * 设置是否返回逆地理编码信息\n   * @param isReGeocode true: 返回地址信息; false: 只返回坐标\n   */\n  setLocatingWithReGeocode(isReGeocode: boolean): void;\n  \n  /**\n   * 设置定位模式（Android）\n   * @param mode 定位模式：0-低功耗, 1-仅设备, 2-高精度\n   */\n  setLocationMode(mode: LocationMode): void;\n  \n  /**\n   * 设置定位间隔（毫秒）\n   * @param interval 定位间隔时间，单位毫秒，默认 2000ms\n   */\n  setInterval(interval: number): void;\n  \n  /**\n   * 设置是否单次定位（Android）\n   * @param isOnceLocation true: 单次定位; false: 连续定位\n   */\n  setOnceLocation(isOnceLocation: boolean): void;\n  \n  /**\n   * 设置是否使用设备传感器（Android）\n   * @param sensorEnable true: 使用传感器; false: 不使用\n   */\n  setSensorEnable(sensorEnable: boolean): void;\n  \n  /**\n   * 设置是否允许 WiFi 扫描（Android）\n   * @param wifiScan true: 允许; false: 不允许\n   */\n  setWifiScan(wifiScan: boolean): void;\n  \n  /**\n   * 设置是否 GPS 优先（Android）\n   * @param gpsFirst true: GPS 优先; false: 网络优先\n   */\n  setGpsFirst(gpsFirst: boolean): void;\n  \n  /**\n   * 设置是否等待 WiFi 列表刷新（Android）\n   * @param onceLocationLatest true: 等待; false: 不等待\n   */\n  setOnceLocationLatest(onceLocationLatest: boolean): void;\n  \n  /**\n   * 设置逆地理编码语言\n   * @param language 语言代码，如 \"zh-CN\", \"en\"\n   */\n  setGeoLanguage(language: string): void;\n  \n  /**\n   * 设置是否使用缓存策略（Android）\n   * @param locationCacheEnable true: 使用缓存; false: 不使用\n   */\n  setLocationCacheEnable(locationCacheEnable: boolean): void;\n  \n  /**\n   * 设置网络请求超时时间（Android）\n   * @param httpTimeOut 超时时间，单位毫秒\n   */\n  setHttpTimeOut(httpTimeOut: number): void;\n  \n  /**\n   * 设置期望的定位精度（iOS）\n   * @param accuracy 精度级别：0-最佳, 1-10米, 2-100米, 3-1公里, 4-3公里\n   */\n  setDesiredAccuracy(accuracy: LocationAccuracy): void;\n  \n  /**\n   * 设置定位超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 10 秒\n   */\n  setLocationTimeout(timeout: number): void;\n  \n  /**\n   * 设置逆地理编码超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 5 秒\n   */\n  setReGeocodeTimeout(timeout: number): void;\n  \n  /**\n   * 设置距离过滤器（米）（iOS）\n   * 只有移动超过指定距离才会更新位置\n   * @param distance 距离阈值，单位米\n   */\n  setDistanceFilter(distance: number): void;\n  \n  /**\n   * 设置是否自动暂停位置更新（iOS）\n   * @param pauses true: 自动暂停; false: 不暂停\n   */\n  setPausesLocationUpdatesAutomatically(pauses: boolean): void;\n  \n  /**\n   * 设置是否允许后台定位（iOS）\n   * @param allows true: 允许; false: 不允许\n   */\n  setAllowsBackgroundLocationUpdates(allows: boolean): void;\n  \n  /**\n   * 设置定位协议\n   * @param protocol 协议类型\n   */\n  setLocationProtocol(protocol: string): void;\n  \n  // ==================== 方向更新 (iOS) ====================\n  \n  /**\n   * 开始更新设备方向（罗盘朝向）\n   * 通过 onHeadingUpdate 事件接收方向更新\n   * @platform ios\n   */\n  startUpdatingHeading(): void;\n  \n  /**\n   * 停止更新设备方向\n   * @platform ios\n   */\n  stopUpdatingHeading(): void;\n  \n  // ==================== 权限管理（增强版） ====================\n  \n  /**\n   * 检查前台位置权限状态（增强版，支持 Android 14+ 适配）\n   * @returns Promise<PermissionStatus> 详细的权限状态信息\n   */\n  checkLocationPermission(): Promise<PermissionStatus>;\n  \n  /**\n   * 请求前台位置权限（增强版，支持 Android 14+ 适配）\n   * @returns Promise<PermissionStatus> 请求后的权限状态\n   */\n  requestLocationPermission(): Promise<PermissionStatus>;\n  \n  /**\n   * 请求后台位置权限（Android 10+、iOS）\n   * 注意：必须在前台权限已授予后才能请求\n   * @returns Promise<PermissionStatus> 请求后的权限状态\n   */\n  requestBackgroundLocationPermission(): Promise<PermissionStatus>;\n  \n  /**\n   * 打开应用设置页面\n   * 引导用户手动授予权限（当权限被永久拒绝时使用）\n   */\n  openAppSettings(): void;\n  \n  // ==================== 地图预加载 ====================\n  \n  /**\n   * 开始预加载地图实例\n   * 在后台预先初始化地图视图，提升首次显示速度\n   * @param config 预加载配置对象\n   * @param config.poolSize 预加载的地图实例数量，默认 2\n   */\n  startMapPreload(config: { poolSize?: number }): void;\n  \n  /**\n   * 获取预加载状态\n   * @returns 预加载状态信息，包含池大小、是否正在预加载等\n   */\n  getMapPreloadStatus(): {\n    poolSize: number;\n    isPreloading: boolean;\n    maxPoolSize: number;\n  };\n  \n  /**\n   * 清空预加载池\n   * 释放所有预加载的地图实例\n   */\n  clearMapPreloadPool(): void;\n  \n  /**\n   * 检查是否有可用的预加载实例\n   * @returns 是否有可用的预加载地图实例\n   */\n  hasPreloadedMapView(): boolean;\n  \n  // ==================== 便捷方法 ====================\n  \n  /**\n   * 添加定位监听器（便捷方法）\n   * 封装了 addListener，提供更简洁的 API\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n}\n\n// 获取原生模块实例 - 添加容错处理\nlet nativeModule: ExpoGaodeMapModule | null = null;\n\ntry {\n  nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');\n} catch (error) {\n  const moduleError = ErrorHandler.nativeModuleUnavailable();\n  ErrorLogger.log(moduleError);\n}\n\n// 记录最近一次 initSDK 的配置（含 webKey）\nlet _sdkConfig: SDKConfig | null = null;\nlet _isSDKInitialized = false;\n\n// 扩展原生模块，添加便捷方法\nconst ExpoGaodeMapModuleWithHelpers = {\n ...(nativeModule || {}),\n\n /**\n  * 初始化 SDK，并缓存配置（包含 webKey）\n  */\n initSDK(config: SDKConfig): void {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n\n   // 验证 API Key 配置\n   if (!config.androidKey && !config.iosKey) {\n     throw ErrorHandler.invalidApiKey('both');\n   }\n\n   try {\n     _sdkConfig = config ?? null;\n     nativeModule.initSDK(config);\n     _isSDKInitialized = true;\n     ErrorLogger.warn('SDK 初始化成功', { config });\n   } catch (error: any) {\n     _isSDKInitialized = false;\n     throw ErrorHandler.wrapNativeError(error, 'SDK 初始化');\n   }\n },\n\n /**\n  * 检查 SDK 是否已通过 JS 调用 initSDK() 初始化\n  * 注意：即使返回 false，原生端可能已通过 Config Plugin 自动初始化\n  */\n isSDKInitialized(): boolean {\n   return _isSDKInitialized;\n },\n\n /**\n  * 开始连续定位\n  * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()\n  */\n start(): void {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     nativeModule.start();\n   } catch (error: any) {\n     throw ErrorHandler.wrapNativeError(error, '开始定位');\n   }\n },\n\n /**\n  * 停止定位\n  */\n stop(): void {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     nativeModule.stop();\n   } catch (error: any) {\n     throw ErrorHandler.wrapNativeError(error, '停止定位');\n   }\n },\n\n /**\n  * 获取当前位置（单次定位）\n  * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()\n  */\n async getCurrentLocation(): Promise<Coordinates | ReGeocode> {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     return await nativeModule.getCurrentLocation();\n   } catch (error: any) {\n     throw ErrorHandler.locationFailed(error?.message);\n   }\n },\n\n /**\n  * 检查位置权限状态\n  */\n async checkLocationPermission(): Promise<PermissionStatus> {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     return await nativeModule.checkLocationPermission();\n   } catch (error: any) {\n     throw ErrorHandler.wrapNativeError(error, '检查权限');\n   }\n },\n\n /**\n  * 请求前台位置权限（增强版）\n  */\n async requestLocationPermission(): Promise<PermissionStatus> {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     const result = await nativeModule.requestLocationPermission();\n     if (!result.granted) {\n       ErrorLogger.warn('前台位置权限未授予', result);\n     }\n     return result;\n   } catch (error: any) {\n     throw ErrorHandler.wrapNativeError(error, '请求前台权限');\n   }\n },\n\n /**\n  * 请求后台位置权限\n  * 注意：必须在前台权限已授予后才能请求\n  */\n async requestBackgroundLocationPermission(): Promise<PermissionStatus> {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     const result = await nativeModule.requestBackgroundLocationPermission();\n     if (!result.granted) {\n       ErrorLogger.warn('后台位置权限未授予', result);\n     }\n     return result;\n   } catch (error: any) {\n     throw ErrorHandler.wrapNativeError(error, '请求后台权限');\n   }\n },\n\n /**\n  * 打开应用设置页面\n  * 引导用户手动授予权限\n  */\n openAppSettings(): void {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   try {\n     nativeModule.openAppSettings();\n   } catch (error: any) {\n     throw ErrorHandler.wrapNativeError(error, '打开设置');\n   }\n },\n\n /**\n  * 添加定位监听器（便捷方法）\n  * 自动订阅 onLocationUpdate 事件，提供容错处理\n  * @param listener 定位回调函数\n  * @returns 订阅对象，调用 remove() 取消监听\n  * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()\n  */\n addLocationListener(listener: LocationListener): { remove: () => void } {\n   if (!nativeModule) {\n     throw ErrorHandler.nativeModuleUnavailable();\n   }\n   // 使用可选链和空值合并，确保即使模块不可用也不会崩溃\n   return nativeModule?.addListener?.('onLocationUpdate', listener) || {\n     remove: () => {},\n   };\n },\n};\n\n/**\n* 获取最近一次 initSDK 的配置\n*/\nexport function getSDKConfig(): SDKConfig | null {\n return _sdkConfig;\n}\n\n/**\n* 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）\n*/\nexport function getWebKey(): string | undefined {\n return _sdkConfig?.webKey;\n}\n\nexport default ExpoGaodeMapModuleWithHelpers as unknown as ExpoGaodeMapModule;\n"]}

package/build/ExpoGaodeMapOfflineModule.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=ExpoGaodeMapOfflineModule.d.ts.map

package/build/ExpoGaodeMapOfflineModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoGaodeMapOfflineModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapOfflineModule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,OAAO,OAAO,yBAA0B,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IAG5E;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAE/C;;;OAGG;IACH,qBAAqB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAElD;;;;OAIG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAEpE;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI9C;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9C;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1C;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAEnD;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAEvD;;;OAGG;IACH,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAEnC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzC;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAEjC;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAEhD;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAE7B;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAElC;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjC;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1E;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/C;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAEpC;;AAGD,wBAAqF"}

package/build/ExpoGaodeMapOfflineModule.js

@@ -0,0 +1,7 @@
+/**
+ * 高德地图离线地图原生模块
+ */
+import { requireNativeModule } from 'expo';
+// 获取原生模块实例
+export default requireNativeModule('ExpoGaodeMapOffline');
+//# sourceMappingURL=ExpoGaodeMapOfflineModule.js.map

package/build/ExpoGaodeMapOfflineModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoGaodeMapOfflineModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapOfflineModule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgLzD,WAAW;AACX,eAAe,mBAAmB,CAA4B,qBAAqB,CAAC,CAAC","sourcesContent":["/**\n * 高德地图离线地图原生模块\n */\n\nimport { NativeModule, requireNativeModule } from 'expo';\nimport type {\n  OfflineMapInfo,\n  OfflineMapDownloadConfig,\n  OfflineMapStorageInfo,\n  OfflineMapEvents,\n} from './types/offline.types';\n\n/**\n * 离线地图原生模块接口\n */\ndeclare class ExpoGaodeMapOfflineModule extends NativeModule<OfflineMapEvents> {\n  // ==================== 地图列表管理 ====================\n  \n  /**\n   * 获取所有可下载的城市列表\n   * @returns Promise<OfflineMapInfo[]> 城市列表\n   */\n  getAvailableCities(): Promise<OfflineMapInfo[]>;\n  \n  /**\n   * 获取所有省份列表\n   * @returns Promise<OfflineMapInfo[]> 省份列表\n   */\n  getAvailableProvinces(): Promise<OfflineMapInfo[]>;\n  \n  /**\n   * 根据省份代码获取城市列表\n   * @param provinceCode 省份代码\n   * @returns Promise<OfflineMapInfo[]> 该省份下的城市列表\n   */\n  getCitiesByProvince(provinceCode: string): Promise<OfflineMapInfo[]>;\n  \n  /**\n   * 获取已下载的地图列表\n   * @returns Promise<OfflineMapInfo[]> 已下载的地图列表\n   */\n  getDownloadedMaps(): Promise<OfflineMapInfo[]>;\n  \n  // ==================== 下载管理 ====================\n  \n  /**\n   * 开始下载离线地图\n   * @param config 下载配置\n   */\n  startDownload(config: OfflineMapDownloadConfig): Promise<void>;\n  \n  /**\n   * 暂停下载\n   * @param cityCode 城市代码\n   */\n  pauseDownload(cityCode: string): Promise<void>;\n  \n  /**\n   * 恢复下载\n   * @param cityCode 城市代码\n   */\n  resumeDownload(cityCode: string): Promise<void>;\n  \n  /**\n   * 取消下载\n   * @param cityCode 城市代码\n   */\n  cancelDownload(cityCode: string): Promise<void>;\n  \n  /**\n   * 删除离线地图\n   * @param cityCode 城市代码\n   */\n  deleteMap(cityCode: string): Promise<void>;\n  \n  /**\n   * 更新离线地图\n   * @param cityCode 城市代码\n   */\n  updateMap(cityCode: string): Promise<void>;\n  \n  /**\n   * 检查是否有可用更新\n   * @param cityCode 城市代码\n   * @returns Promise<boolean> 是否有更新\n   */\n  checkUpdate(cityCode: string): Promise<boolean>;\n  \n  // ==================== 状态查询 ====================\n  \n  /**\n   * 检查地图是否已下载\n   * @param cityCode 城市代码\n   * @returns Promise<boolean> 是否已下载\n   */\n  isMapDownloaded(cityCode: string): Promise<boolean>;\n  \n  /**\n   * 获取地图下载状态\n   * @param cityCode 城市代码\n   * @returns Promise<OfflineMapInfo> 地图信息\n   */\n  getMapStatus(cityCode: string): Promise<OfflineMapInfo>;\n  \n  /**\n   * 获取所有下载任务的总进度\n   * @returns Promise<number> 总进度 (0-100)\n   */\n  getTotalProgress(): Promise<number>;\n  \n  /**\n   * 获取当前正在下载的城市列表\n   * @returns Promise<string[]> 城市代码列表\n   */\n  getDownloadingCities(): Promise<string[]>;\n  \n  // ==================== 存储管理 ====================\n  \n  /**\n   * 获取离线地图占用的存储空间（字节）\n   * @returns Promise<number> 存储空间大小\n   */\n  getStorageSize(): Promise<number>;\n  \n  /**\n   * 获取详细的存储信息\n   * @returns Promise<OfflineMapStorageInfo> 存储信息\n   */\n  getStorageInfo(): Promise<OfflineMapStorageInfo>;\n  \n  /**\n   * 清理所有离线地图\n   */\n  clearAllMaps(): Promise<void>;\n  \n  /**\n   * 设置离线地图存储路径\n   * @param path 存储路径\n   */\n  setStoragePath(path: string): void;\n  \n  /**\n   * 获取离线地图存储路径\n   * @returns Promise<string> 存储路径\n   */\n  getStoragePath(): Promise<string>;\n  \n  // ==================== 批量操作 ====================\n  \n  /**\n   * 批量下载地图\n   * @param cityCodes 城市代码列表\n   * @param allowCellular 是否允许移动网络\n   */\n  batchDownload(cityCodes: string[], allowCellular?: boolean): Promise<void>;\n  \n  /**\n   * 批量删除地图\n   * @param cityCodes 城市代码列表\n   */\n  batchDelete(cityCodes: string[]): Promise<void>;\n  \n  /**\n   * 批量更新地图\n   * @param cityCodes 城市代码列表\n   */\n  batchUpdate(cityCodes: string[]): Promise<void>;\n  \n  /**\n   * 暂停所有下载任务\n   */\n  pauseAllDownloads(): Promise<void>;\n  \n  /**\n   * 恢复所有下载任务\n   */\n  resumeAllDownloads(): Promise<void>;\n\n}\n\n// 获取原生模块实例\nexport default requireNativeModule<ExpoGaodeMapOfflineModule>('ExpoGaodeMapOffline');"]}

package/build/ExpoGaodeMapView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAKX,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,gBAAgB,iFAgFpB,CAAC;AAIH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"ExpoGaodeMapView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAKX,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,gBAAgB,iFAwDpB,CAAC;AAIH,eAAe,gBAAgB,CAAC"}

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/components/FoldableMapView.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import { DeviceInfo, FoldState } from '../utils/PlatformDetector';
+import { MapViewProps } from '../types';
+/**
+ * 折叠屏适配配置
+ */
+export interface FoldableConfig {
+    /** 折叠时是否自动调整缩放级别 */
+    autoAdjustZoom?: boolean;
+    /** 展开时的缩放级别增量 */
+    unfoldedZoomDelta?: number;
+    /** 是否在折叠/展开时保持中心点 */
+    keepCenterOnFold?: boolean;
+    /** 折叠状态变化回调 */
+    onFoldStateChange?: (state: FoldState, deviceInfo: DeviceInfo) => void;
+    /** 是否启用调试日志 */
+    debug?: boolean;
+}
+/**
+ * 折叠屏地图视图组件
+ *
+ * 自动适配折叠屏设备的展开/折叠状态变化
+ */
+export interface FoldableMapViewProps extends MapViewProps {
+    /** 折叠屏适配配置 */
+    foldableConfig?: FoldableConfig;
+}
+export declare const FoldableMapView: React.FC<FoldableMapViewProps>;
+/**
+ * 折叠屏适配 Hook
+ *
+ * 用于在现有地图组件中添加折叠屏适配功能
+ */
+export declare function useFoldableMap(mapRef: React.RefObject<any>, config?: FoldableConfig): {
+    foldState: FoldState;
+    deviceInfo: DeviceInfo;
+    isFoldable: boolean;
+};
+//# sourceMappingURL=FoldableMapView.d.ts.map

package/build/components/FoldableMapView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FoldableMapView.d.ts","sourceRoot":"","sources":["../../src/components/FoldableMapView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,OAAO,EAAoB,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe;IACf,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IACvE,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,cAAc;IACd,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAsI1D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAC5B,MAAM,CAAC,EAAE,cAAc;;;;EAkExB"}