expo-gaode-map 2.2.12 → 2.2.13

package/android/src/main/AndroidManifest.xml

@@ -6,11 +6,7 @@
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   
-  <!-- 基础定位权限 (必需) -->
-  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
-  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
-  
-  <application>
+  <application allowBackup="false" >
   
     <!-- 高德地图定位服务 (必需) -->
     <service

package/android/src/main/java/expo/modules/gaodemap/ExpoGaodeMapModule.kt

@@ -87,10 +87,10 @@ class ExpoGaodeMapModule : Module() {
           getLocationManager() // 初始化定位管理器
         } catch (e: SecurityException) {
           android.util.Log.e("ExpoGaodeMap", "隐私协议未同意: ${e.message}")
-          throw e
+          throw expo.modules.kotlin.exception.CodedException("PRIVACY_NOT_AGREED", e.message ?: "用户未同意隐私协议", e)
         } catch (e: Exception) {
           android.util.Log.e("ExpoGaodeMap", "SDK 初始化失败: ${e.message}")
-          throw e
+          throw expo.modules.kotlin.exception.CodedException("INIT_FAILED", e.message ?: "SDK 初始化失败", e)
         }
       }
     }

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

@@ -82,8 +82,12 @@ class PolylineView(context: Context, appContext: AppContext) : ExpoView(context,
    * 设置是否虚线
    */
   fun setDotted(dotted: Boolean) {
-    isDotted = dotted
-    createOrUpdatePolyline()
+    try {
+      isDotted = dotted
+      createOrUpdatePolyline()
+    } catch (e: Throwable) {
+      android.util.Log.e("PolylineView", "setDotted failed", e)
+    }
   }
   
   /**
@@ -131,64 +135,74 @@ class PolylineView(context: Context, appContext: AppContext) : ExpoView(context,
    */
   private fun createOrUpdatePolyline() {
     aMap?.let { map ->
-      // 移除旧折线
-      polyline?.remove()
-      polyline = null
-      
-      if (points.isNotEmpty()) {
-        val options = PolylineOptions()
-          .addAll(points)
-          .width(strokeWidth)
-          .color(strokeColor)
-          .geodesic(isGeodesic)
-
-        
-        // 设置虚线样式
-        if (isDotted) {
-            options.dottedLineType = PolylineOptions.DOTTEDLINE_TYPE_SQUARE
-        }
+      try {
+        // 移除旧折线
+        polyline?.remove()
+        polyline = null
         
-        // 设置纹理
-        textureUrl?.let { url ->
+        if (points.isNotEmpty()) {
+          val options = PolylineOptions()
+            .addAll(points)
+            .width(strokeWidth)
+            .color(strokeColor)
+            .geodesic(isGeodesic)
+
+          
+          // 设置虚线样式
           try {
-            when {
-              url.startsWith("http://") || url.startsWith("https://") -> {
-                // 网络图片异步加载
-                Thread {
-                  try {
-                    val connection = URL(url).openConnection()
-                    val inputStream = connection.getInputStream()
-                    val bitmap = android.graphics.BitmapFactory.decodeStream(inputStream)
-                    inputStream.close()
-                    post {
-                      polyline?.setCustomTexture(BitmapDescriptorFactory.fromBitmap(bitmap))
+              options.setDottedLine(isDotted)
+              if (isDotted) {
+                  options.setDottedLineType(PolylineOptions.DOTTEDLINE_TYPE_SQUARE)
+              }
+          } catch (e: Throwable) {
+              // 忽略虚线设置错误，防止崩溃
+              android.util.Log.e("PolylineView", "设置虚线失败", e)
+          }
+          
+          // 设置纹理
+          textureUrl?.let { url ->
+            try {
+              when {
+                url.startsWith("http://") || url.startsWith("https://") -> {
+                  // 网络图片异步加载
+                  Thread {
+                    try {
+                      val connection = URL(url).openConnection()
+                      val inputStream = connection.getInputStream()
+                      val bitmap = android.graphics.BitmapFactory.decodeStream(inputStream)
+                      inputStream.close()
+                      post {
+                        polyline?.setCustomTexture(BitmapDescriptorFactory.fromBitmap(bitmap))
+                      }
+                    } catch (e: Exception) {
+                      e.printStackTrace()
                     }
-                  } catch (e: Exception) {
-                    e.printStackTrace()
+                  }.start()
+                }
+                url.startsWith("file://") -> {
+                  val path = url.substring(7)
+                  val bitmap = android.graphics.BitmapFactory.decodeFile(path)
+                  bitmap?.let { options.setCustomTexture(BitmapDescriptorFactory.fromBitmap(it)) }
+                }
+                else -> {
+                  val resId = context.resources.getIdentifier(url, "drawable", context.packageName)
+                  if (resId != 0) {
+                    val bitmap = android.graphics.BitmapFactory.decodeResource(context.resources, resId)
+                    options.setCustomTexture(BitmapDescriptorFactory.fromBitmap(bitmap))
+                  }else{
+                    
                   }
-                }.start()
-              }
-              url.startsWith("file://") -> {
-                val path = url.substring(7)
-                val bitmap = android.graphics.BitmapFactory.decodeFile(path)
-                bitmap?.let { options.setCustomTexture(BitmapDescriptorFactory.fromBitmap(it)) }
-              }
-              else -> {
-                val resId = context.resources.getIdentifier(url, "drawable", context.packageName)
-                if (resId != 0) {
-                  val bitmap = android.graphics.BitmapFactory.decodeResource(context.resources, resId)
-                  options.setCustomTexture(BitmapDescriptorFactory.fromBitmap(bitmap))
-                }else{
-                  
                 }
               }
+            } catch (e: Exception) {
+              e.printStackTrace()
             }
-          } catch (e: Exception) {
-            e.printStackTrace()
           }
+          
+          polyline = map.addPolyline(options)
         }
-        
-        polyline = map.addPolyline(options)
+      } catch (e: Throwable) {
+        android.util.Log.e("PolylineView", "Error creating/updating polyline", e)
       }
     }
   }

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;AAGjB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,gBAAgB,iFAwDpB,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;AAMjB,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,gBAAgB,iFA4EpB,CAAC;AAIH,eAAe,gBAAgB,CAAC"}

package/build/ExpoGaodeMapView.js

@@ -1,6 +1,9 @@
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 import { ErrorHandler } from './utils/ErrorHandler';
+import { MapContext } from './components/MapContext';
+import { MapUI } from './components/MapUI';
+import { View, StyleSheet } from 'react-native';
 const NativeView = requireNativeViewManager('ExpoGaodeMapView');
 /**
  * 高德地图视图组件，提供地图操作API和覆盖物管理功能
@@ -63,9 +66,26 @@ const ExpoGaodeMapView = React.forwardRef((props, ref) => {
      * @returns 返回地图API的引用对象，可用于调用地图相关方法
      */
     React.useImperativeHandle(ref, () => apiRef, [apiRef]);
-    return (<NativeView ref={nativeRef} {...props}>
-          {props.children}
-      </NativeView>);
+    // 分离 children：区分原生覆盖物和普通 UI 组件
+    const { children, style, ...otherProps } = props;
+    const overlays = [];
+    const uiControls = [];
+    React.Children.forEach(children, (child) => {
+        if (React.isValidElement(child) && (child.type === MapUI || child.type?.isMapUI)) {
+            uiControls.push(child);
+        }
+        else {
+            overlays.push(child);
+        }
+    });
+    return (<MapContext.Provider value={apiRef}>
+      <View style={[{ flex: 1, position: 'relative', overflow: 'hidden' }, style]}>
+        <NativeView ref={nativeRef} style={StyleSheet.absoluteFill} {...otherProps}>
+          {overlays}
+        </NativeView>
+        {uiControls}
+      </View>
+    </MapContext.Provider>);
 });
 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;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"]}
+{"version":3,"file":"ExpoGaodeMapView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapView.tsx"],"names":[],"mappings":"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","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';\nimport { MapContext } from './components/MapContext';\nimport { MapUI } from './components/MapUI';\nimport { View, StyleSheet } from 'react-native';\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  // 分离 children：区分原生覆盖物和普通 UI 组件\n  const { children, style, ...otherProps } = props;\n  const overlays: React.ReactNode[] = [];\n  const uiControls: React.ReactNode[] = [];\n\n  React.Children.forEach(children, (child) => {\n    if (React.isValidElement(child) && (child.type === MapUI || (child.type as any)?.isMapUI)) {\n      uiControls.push(child);\n    } else {\n      overlays.push(child);\n    }\n  });\n\n  return (\n    <MapContext.Provider value={apiRef}>\n      <View style={[{ flex: 1, position: 'relative', overflow: 'hidden' }, style]}>\n        <NativeView\n          ref={nativeRef}\n          style={StyleSheet.absoluteFill}\n          {...otherProps}\n        >\n          {overlays}\n        </NativeView>\n        {uiControls}\n      </View>\n    </MapContext.Provider>\n  );\n});\n\nExpoGaodeMapView.displayName = 'ExpoGaodeMapView';\n\nexport default ExpoGaodeMapView;\n"]}

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

@@ -1 +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"}
+{"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,CAwI1D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAC5B,MAAM,CAAC,EAAE,cAAc;;;;EAkExB"}

package/build/components/FoldableMapView.js

@@ -99,7 +99,7 @@ export const FoldableMapView = ({ foldableConfig, ...mapProps }) => {
         }
         catch (error) {
             if (config.debug) {
-                console.error('[FoldableMapView] 处理折叠状态变化失败:', error);
+                console.error('[FoldableMapView] 处理折叠状态变化失败:');
             }
         }
     };
@@ -145,7 +145,7 @@ export function useFoldableMap(mapRef, config) {
                     }
                     catch (error) {
                         if (mergedConfig.debug) {
-                            console.error('[useFoldableMap] 调整失败:', error);
+                            console.error('[useFoldableMap] 调整失败:');
                         }
                     }
                 }

package/build/components/FoldableMapView.js.map

@@ -1 +1 @@
-{"version":3,"file":"FoldableMapView.js","sourceRoot":"","sources":["../../src/components/FoldableMapView.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useEffect, useRef, useState } from 'react';\nimport { Platform } from 'react-native';\nimport ExpoGaodeMapView from '../ExpoGaodeMapView';\n\nimport { PlatformDetector, DeviceInfo, FoldState } from '../utils/PlatformDetector';\nimport { MapViewProps } from '../types';\n\n/**\n * 折叠屏适配配置\n */\nexport interface FoldableConfig {\n  /** 折叠时是否自动调整缩放级别 */\n  autoAdjustZoom?: boolean;\n  /** 展开时的缩放级别增量 */\n  unfoldedZoomDelta?: number;\n  /** 是否在折叠/展开时保持中心点 */\n  keepCenterOnFold?: boolean;\n  /** 折叠状态变化回调 */\n  onFoldStateChange?: (state: FoldState, deviceInfo: DeviceInfo) => void;\n  /** 是否启用调试日志 */\n  debug?: boolean;\n}\n\n/**\n * 折叠屏地图视图组件\n * \n * 自动适配折叠屏设备的展开/折叠状态变化\n */\nexport interface FoldableMapViewProps extends MapViewProps {\n  /** 折叠屏适配配置 */\n  foldableConfig?: FoldableConfig;\n}\n\nexport const FoldableMapView: React.FC<FoldableMapViewProps> = ({\n  foldableConfig,\n  ...mapProps\n}) => {\n  const mapRef = useRef<any>(null);\n  const [currentFoldState, setCurrentFoldState] = useState<FoldState>(FoldState.UNKNOWN);\n  const [deviceInfo, setDeviceInfo] = useState<DeviceInfo>(PlatformDetector.getDeviceInfo());\n\n  const config: Required<FoldableConfig> = {\n    autoAdjustZoom: true,\n    unfoldedZoomDelta: 1,\n    keepCenterOnFold: true,\n    onFoldStateChange: () => {},\n    debug: false,\n    ...foldableConfig,\n  };\n\n  useEffect(() => {\n    // 仅在 Android 折叠屏设备上启用\n    if (Platform.OS !== 'android' || !deviceInfo.isFoldable) {\n      if (config.debug) {\n        console.log('[FoldableMapView] 非折叠屏设备，跳过适配');\n      }\n      return;\n    }\n\n    if (config.debug) {\n      console.log('[FoldableMapView] 初始化折叠屏适配');\n      console.log('设备信息:', deviceInfo);\n      console.log('初始折叠状态:', currentFoldState);\n    }\n\n    // 监听屏幕尺寸变化\n    const removeListener = PlatformDetector.addDimensionChangeListener(\n      async (newInfo: DeviceInfo) => {\n        const newFoldState = PlatformDetector.getFoldState();\n        \n        if (config.debug) {\n          console.log('[FoldableMapView] 屏幕尺寸变化');\n          console.log('新设备信息:', newInfo);\n          console.log('新折叠状态:', newFoldState);\n        }\n\n        // 折叠状态变化时的处理\n        if (newFoldState !== currentFoldState && currentFoldState !== FoldState.UNKNOWN) {\n          await handleFoldStateChange(currentFoldState, newFoldState, newInfo);\n        }\n\n        setCurrentFoldState(newFoldState);\n        setDeviceInfo(newInfo);\n        \n        // 触发回调\n        config.onFoldStateChange(newFoldState, newInfo);\n      }\n    );\n\n    // 设置初始状态\n    const initialState = PlatformDetector.getFoldState();\n    setCurrentFoldState(initialState);\n\n    return () => {\n      removeListener();\n    };\n  }, []);\n\n  /**\n   * 处理折叠状态变化\n   */\n  const handleFoldStateChange = async (\n    oldState: FoldState,\n    newState: FoldState,\n    newInfo: DeviceInfo\n  ) => {\n    if (!mapRef.current) {\n      return;\n    }\n\n    try {\n      // 获取当前地图状态\n      const currentCamera = await mapRef.current.getCameraPosition?.();\n      \n      if (!currentCamera) {\n        if (config.debug) {\n          console.warn('[FoldableMapView] 无法获取相机位置');\n        }\n        return;\n      }\n\n      const isUnfolding = newState === FoldState.UNFOLDED && oldState === FoldState.FOLDED;\n      const isFolding = newState === FoldState.FOLDED && oldState === FoldState.UNFOLDED;\n\n      if (config.debug) {\n        console.log('[FoldableMapView] 折叠状态变化:', {\n          oldState,\n          newState,\n          isUnfolding,\n          isFolding,\n          currentZoom: currentCamera.zoom,\n        });\n      }\n\n      // 展开时增加缩放级别，折叠时减少\n      if (config.autoAdjustZoom && (isUnfolding || isFolding)) {\n        const zoomDelta = isUnfolding ? config.unfoldedZoomDelta : -config.unfoldedZoomDelta;\n        const newZoom = Math.max(3, Math.min(20, currentCamera.zoom + zoomDelta));\n\n        if (config.debug) {\n          console.log('[FoldableMapView] 调整缩放:', {\n            oldZoom: currentCamera.zoom,\n            newZoom,\n            delta: zoomDelta,\n          });\n        }\n\n        // 保持中心点，只调整缩放\n        await mapRef.current.animateToCamera?.({\n          center: config.keepCenterOnFold ? currentCamera.target : undefined,\n          zoom: newZoom,\n          duration: 300,\n        });\n      }\n    } catch (error) {\n      if (config.debug) {\n        console.error('[FoldableMapView] 处理折叠状态变化失败:', error);\n      }\n    }\n  };\n\n  return (\n    <ExpoGaodeMapView\n      ref={mapRef}\n      {...mapProps}\n    />\n  );\n};\n\n/**\n * 折叠屏适配 Hook\n * \n * 用于在现有地图组件中添加折叠屏适配功能\n */\nexport function useFoldableMap(\n  mapRef: React.RefObject<any>,\n  config?: FoldableConfig\n) {\n  const [foldState, setFoldState] = useState<FoldState>(FoldState.UNKNOWN);\n  const [deviceInfo, setDeviceInfo] = useState<DeviceInfo>(PlatformDetector.getDeviceInfo());\n\n  const mergedConfig: Required<FoldableConfig> = {\n    autoAdjustZoom: true,\n    unfoldedZoomDelta: 1,\n    keepCenterOnFold: true,\n    onFoldStateChange: () => {},\n    debug: false,\n    ...config,\n  };\n\n  useEffect(() => {\n    if (Platform.OS !== 'android' || !deviceInfo.isFoldable) {\n      return;\n    }\n\n    const removeListener = PlatformDetector.addDimensionChangeListener(\n      async (newInfo: DeviceInfo) => {\n        const newFoldState = PlatformDetector.getFoldState();\n        \n        if (newFoldState !== foldState && foldState !== FoldState.UNKNOWN) {\n          // 处理折叠状态变化\n          if (mapRef.current && mergedConfig.autoAdjustZoom) {\n            try {\n              const currentCamera = await mapRef.current.getCameraPosition?.();\n              if (currentCamera) {\n                const isUnfolding = newFoldState === FoldState.UNFOLDED && foldState === FoldState.FOLDED;\n                const zoomDelta = isUnfolding ? mergedConfig.unfoldedZoomDelta : -mergedConfig.unfoldedZoomDelta;\n                const newZoom = Math.max(3, Math.min(20, currentCamera.zoom + zoomDelta));\n\n                await mapRef.current.animateToCamera?.({\n                  center: mergedConfig.keepCenterOnFold ? currentCamera.target : undefined,\n                  zoom: newZoom,\n                  duration: 300,\n                });\n              }\n            } catch (error) {\n              if (mergedConfig.debug) {\n                console.error('[useFoldableMap] 调整失败:', error);\n              }\n            }\n          }\n        }\n\n        setFoldState(newFoldState);\n        setDeviceInfo(newInfo);\n        mergedConfig.onFoldStateChange(newFoldState, newInfo);\n      }\n    );\n\n    const initialState = PlatformDetector.getFoldState();\n    setFoldState(initialState);\n\n    return () => {\n      removeListener();\n    };\n  }, [foldState, deviceInfo.isFoldable]);\n\n  return {\n    foldState,\n    deviceInfo,\n    isFoldable: deviceInfo.isFoldable,\n  };\n}"]}
+{"version":3,"file":"FoldableMapView.js","sourceRoot":"","sources":["../../src/components/FoldableMapView.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useEffect, useRef, useState } from 'react';\nimport { Platform } from 'react-native';\nimport ExpoGaodeMapView from '../ExpoGaodeMapView';\n\nimport { PlatformDetector, DeviceInfo, FoldState } from '../utils/PlatformDetector';\nimport { MapViewProps } from '../types';\n\n/**\n * 折叠屏适配配置\n */\nexport interface FoldableConfig {\n  /** 折叠时是否自动调整缩放级别 */\n  autoAdjustZoom?: boolean;\n  /** 展开时的缩放级别增量 */\n  unfoldedZoomDelta?: number;\n  /** 是否在折叠/展开时保持中心点 */\n  keepCenterOnFold?: boolean;\n  /** 折叠状态变化回调 */\n  onFoldStateChange?: (state: FoldState, deviceInfo: DeviceInfo) => void;\n  /** 是否启用调试日志 */\n  debug?: boolean;\n}\n\n/**\n * 折叠屏地图视图组件\n * \n * 自动适配折叠屏设备的展开/折叠状态变化\n */\nexport interface FoldableMapViewProps extends MapViewProps {\n  /** 折叠屏适配配置 */\n  foldableConfig?: FoldableConfig;\n}\n\nexport const FoldableMapView: React.FC<FoldableMapViewProps> = ({\n  foldableConfig,\n  ...mapProps\n}) => {\n  const mapRef = useRef<any>(null);\n  const [currentFoldState, setCurrentFoldState] = useState<FoldState>(FoldState.UNKNOWN);\n  const [deviceInfo, setDeviceInfo] = useState<DeviceInfo>(PlatformDetector.getDeviceInfo());\n\n  const config: Required<FoldableConfig> = {\n    autoAdjustZoom: true,\n    unfoldedZoomDelta: 1,\n    keepCenterOnFold: true,\n    onFoldStateChange: () => {},\n    debug: false,\n    ...foldableConfig,\n  };\n\n  useEffect(() => {\n    // 仅在 Android 折叠屏设备上启用\n    if (Platform.OS !== 'android' || !deviceInfo.isFoldable) {\n      if (config.debug) {\n        console.log('[FoldableMapView] 非折叠屏设备，跳过适配');\n      }\n      return;\n    }\n\n    if (config.debug) {\n      console.log('[FoldableMapView] 初始化折叠屏适配');\n      console.log('设备信息:', deviceInfo);\n      console.log('初始折叠状态:', currentFoldState);\n    }\n\n    // 监听屏幕尺寸变化\n    const removeListener = PlatformDetector.addDimensionChangeListener(\n      async (newInfo: DeviceInfo) => {\n        const newFoldState = PlatformDetector.getFoldState();\n        \n        if (config.debug) {\n          console.log('[FoldableMapView] 屏幕尺寸变化');\n          console.log('新设备信息:', newInfo);\n          console.log('新折叠状态:', newFoldState);\n        }\n\n        // 折叠状态变化时的处理\n        if (newFoldState !== currentFoldState && currentFoldState !== FoldState.UNKNOWN) {\n          await handleFoldStateChange(currentFoldState, newFoldState, newInfo);\n        }\n\n        setCurrentFoldState(newFoldState);\n        setDeviceInfo(newInfo);\n        \n        // 触发回调\n        config.onFoldStateChange(newFoldState, newInfo);\n      }\n    );\n\n    // 设置初始状态\n    const initialState = PlatformDetector.getFoldState();\n    setCurrentFoldState(initialState);\n\n    return () => {\n      removeListener();\n    };\n  }, []);\n\n  /**\n   * 处理折叠状态变化\n   */\n  const handleFoldStateChange = async (\n    oldState: FoldState,\n    newState: FoldState,\n    newInfo: DeviceInfo\n  ) => {\n    if (!mapRef.current) {\n      return;\n    }\n\n    try {\n      // 获取当前地图状态\n      const currentCamera = await mapRef.current.getCameraPosition?.();\n      \n      if (!currentCamera) {\n        if (config.debug) {\n          console.warn('[FoldableMapView] 无法获取相机位置');\n        }\n        return;\n      }\n\n      const isUnfolding = newState === FoldState.UNFOLDED && oldState === FoldState.FOLDED;\n      const isFolding = newState === FoldState.FOLDED && oldState === FoldState.UNFOLDED;\n\n      if (config.debug) {\n        console.log('[FoldableMapView] 折叠状态变化:', {\n          oldState,\n          newState,\n          isUnfolding,\n          isFolding,\n          currentZoom: currentCamera.zoom,\n        });\n      }\n\n      // 展开时增加缩放级别，折叠时减少\n      if (config.autoAdjustZoom && (isUnfolding || isFolding)) {\n        const zoomDelta = isUnfolding ? config.unfoldedZoomDelta : -config.unfoldedZoomDelta;\n        const newZoom = Math.max(3, Math.min(20, currentCamera.zoom + zoomDelta));\n\n        if (config.debug) {\n          console.log('[FoldableMapView] 调整缩放:', {\n            oldZoom: currentCamera.zoom,\n            newZoom,\n            delta: zoomDelta,\n          });\n        }\n\n        // 保持中心点，只调整缩放\n        await mapRef.current.animateToCamera?.({\n          center: config.keepCenterOnFold ? currentCamera.target : undefined,\n          zoom: newZoom,\n          duration: 300,\n        });\n      }\n    } catch (error) {\n      if (config.debug) {\n        console.error('[FoldableMapView] 处理折叠状态变化失败:');\n      }\n    }\n  };\n\n  \n\n  return (\n    <ExpoGaodeMapView\n      ref={mapRef}\n      {...mapProps}\n    />\n  );\n};\n\n/**\n * 折叠屏适配 Hook\n * \n * 用于在现有地图组件中添加折叠屏适配功能\n */\nexport function useFoldableMap(\n  mapRef: React.RefObject<any>,\n  config?: FoldableConfig\n) {\n  const [foldState, setFoldState] = useState<FoldState>(FoldState.UNKNOWN);\n  const [deviceInfo, setDeviceInfo] = useState<DeviceInfo>(PlatformDetector.getDeviceInfo());\n\n  const mergedConfig: Required<FoldableConfig> = {\n    autoAdjustZoom: true,\n    unfoldedZoomDelta: 1,\n    keepCenterOnFold: true,\n    onFoldStateChange: () => {},\n    debug: false,\n    ...config,\n  };\n\n  useEffect(() => {\n    if (Platform.OS !== 'android' || !deviceInfo.isFoldable) {\n      return;\n    }\n\n    const removeListener = PlatformDetector.addDimensionChangeListener(\n      async (newInfo: DeviceInfo) => {\n        const newFoldState = PlatformDetector.getFoldState();\n        \n        if (newFoldState !== foldState && foldState !== FoldState.UNKNOWN) {\n          // 处理折叠状态变化\n          if (mapRef.current && mergedConfig.autoAdjustZoom) {\n            try {\n              const currentCamera = await mapRef.current.getCameraPosition?.();\n              if (currentCamera) {\n                const isUnfolding = newFoldState === FoldState.UNFOLDED && foldState === FoldState.FOLDED;\n                const zoomDelta = isUnfolding ? mergedConfig.unfoldedZoomDelta : -mergedConfig.unfoldedZoomDelta;\n                const newZoom = Math.max(3, Math.min(20, currentCamera.zoom + zoomDelta));\n\n                await mapRef.current.animateToCamera?.({\n                  center: mergedConfig.keepCenterOnFold ? currentCamera.target : undefined,\n                  zoom: newZoom,\n                  duration: 300,\n                });\n              }\n            } catch (error) {\n              if (mergedConfig.debug) {\n                console.error('[useFoldableMap] 调整失败:');\n              }\n            }\n          }\n        }\n\n        setFoldState(newFoldState);\n        setDeviceInfo(newInfo);\n        mergedConfig.onFoldStateChange(newFoldState, newInfo);\n      }\n    );\n\n    const initialState = PlatformDetector.getFoldState();\n    setFoldState(initialState);\n\n    return () => {\n      removeListener();\n    };\n  }, [foldState, deviceInfo.isFoldable]);\n\n  return {\n    foldState,\n    deviceInfo,\n    isFoldable: deviceInfo.isFoldable,\n  };\n}"]}

package/build/components/MapContext.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { MapViewRef } from '../types';
+/**
+ * 地图上下文
+ * 用于在子组件中访问地图实例的方法
+ */
+export declare const MapContext: React.Context<MapViewRef | null>;
+/**
+ * Hook: 获取地图实例引用
+ * 只能在 ExpoGaodeMapView 的子组件中使用
+ */
+export declare function useMap(): MapViewRef;
+//# sourceMappingURL=MapContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MapContext.d.ts","sourceRoot":"","sources":["../../src/components/MapContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,UAAU,kCAA+C,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,MAAM,IAAI,UAAU,CAMnC"}

package/build/components/MapContext.js

@@ -0,0 +1,18 @@
+import * as React from 'react';
+/**
+ * 地图上下文
+ * 用于在子组件中访问地图实例的方法
+ */
+export const MapContext = React.createContext(null);
+/**
+ * Hook: 获取地图实例引用
+ * 只能在 ExpoGaodeMapView 的子组件中使用
+ */
+export function useMap() {
+    const context = React.useContext(MapContext);
+    if (!context) {
+        throw new Error('useMap must be used within a ExpoGaodeMapView component');
+    }
+    return context;
+}
+//# sourceMappingURL=MapContext.js.map

package/build/components/MapContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapContext.js","sourceRoot":"","sources":["../../src/components/MapContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,CAAoB,IAAI,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import * as React from 'react';\nimport type { MapViewRef } from '../types';\n\n/**\n * 地图上下文\n * 用于在子组件中访问地图实例的方法\n */\nexport const MapContext = React.createContext<MapViewRef | null>(null);\n\n/**\n * Hook: 获取地图实例引用\n * 只能在 ExpoGaodeMapView 的子组件中使用\n */\nexport function useMap(): MapViewRef {\n  const context = React.useContext(MapContext);\n  if (!context) {\n    throw new Error('useMap must be used within a ExpoGaodeMapView component');\n  }\n  return context;\n}\n"]}

package/build/components/MapUI.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+/**
+ * MapUI 组件
+ * 用于包裹不需要作为地图原生子组件（如 Marker）的普通 React 组件。
+ * 被此组件包裹的内容将渲染在地图视图的上方（兄弟节点），而不是内部。
+ * 这解决了在地图内部放置普通 View 导致的触摸事件冲突问题。
+ *
+ * 示例:
+ * <MapView>
+ *   <Marker ... />
+ *   <MapUI>
+ *     <View style={{ position: 'absolute', ... }}>
+ *       <Text>悬浮层</Text>
+ *     </View>
+ *   </MapUI>
+ * </MapView>
+ */
+export declare const MapUI: React.FC<React.PropsWithChildren<{}>>;
+//# sourceMappingURL=MapUI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MapUI.d.ts","sourceRoot":"","sources":["../../src/components/MapUI.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAEvD,CAAC"}

package/build/components/MapUI.js

@@ -0,0 +1,23 @@
+import React from 'react';
+/**
+ * MapUI 组件
+ * 用于包裹不需要作为地图原生子组件（如 Marker）的普通 React 组件。
+ * 被此组件包裹的内容将渲染在地图视图的上方（兄弟节点），而不是内部。
+ * 这解决了在地图内部放置普通 View 导致的触摸事件冲突问题。
+ *
+ * 示例:
+ * <MapView>
+ *   <Marker ... />
+ *   <MapUI>
+ *     <View style={{ position: 'absolute', ... }}>
+ *       <Text>悬浮层</Text>
+ *     </View>
+ *   </MapUI>
+ * </MapView>
+ */
+export const MapUI = ({ children }) => {
+    return <>{children}</>;
+};
+// 静态标志，用于识别
+MapUI.isMapUI = true;
+//# sourceMappingURL=MapUI.js.map

package/build/components/MapUI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapUI.js","sourceRoot":"","sources":["../../src/components/MapUI.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,KAAK,GAA0C,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC3E,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;AACzB,CAAC,CAAC;AAEF,YAAY;AACX,KAAa,CAAC,OAAO,GAAG,IAAI,CAAC","sourcesContent":["import React from 'react';\n\n/**\n * MapUI 组件\n * 用于包裹不需要作为地图原生子组件（如 Marker）的普通 React 组件。\n * 被此组件包裹的内容将渲染在地图视图的上方（兄弟节点），而不是内部。\n * 这解决了在地图内部放置普通 View 导致的触摸事件冲突问题。\n * \n * 示例:\n * <MapView>\n *   <Marker ... />\n *   <MapUI>\n *     <View style={{ position: 'absolute', ... }}>\n *       <Text>悬浮层</Text>\n *     </View>\n *   </MapUI>\n * </MapView>\n */\nexport const MapUI: React.FC<React.PropsWithChildren<{}>> = ({ children }) => {\n  return <>{children}</>;\n};\n\n// 静态标志，用于识别\n(MapUI as any).isMapUI = true;\n"]}

package/build/index.d.ts

@@ -2,6 +2,8 @@ export * from './types';
 export { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';
 export { default as MapView } from './ExpoGaodeMapView';
 export type { MapViewRef } from './ExpoGaodeMapView';
+export { useMap } from './components/MapContext';
+export { MapUI } from './components/MapUI';
 export { Marker, Polyline, Polygon, Circle, HeatMap, MultiPoint, Cluster, } from './components/overlays';
 export { requireModule, OptionalModules, getInstalledModules, printModuleInfo, createLazyLoader, } from './utils/ModuleLoader';
 export { ErrorHandler, ErrorLogger, GaodeMapError, ErrorType, } from './utils/ErrorHandler';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,MAAM,GACP,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG1E,OAAO,EACL,eAAe,EACf,iBAAiB,EAAE,UAAU;AAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,cAAc,GACf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEjF,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,wOAGjC,CAAA;AAGF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,MAAM,GACP,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG1E,OAAO,EACL,eAAe,EACf,iBAAiB,EAAE,UAAU;AAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,cAAc,GACf,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEjF,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAM/B;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,wOAGjC,CAAA;AAGF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/build/index.js

@@ -6,6 +6,8 @@ export * from './types';
 export { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';
 // 导出地图视图组件
 export { default as MapView } from './ExpoGaodeMapView';
+export { useMap } from './components/MapContext';
+export { MapUI } from './components/MapUI';
 // 导出覆盖物组件
 export { Marker, Polyline, Polygon, Circle, HeatMap, MultiPoint, Cluster, } from './components/overlays';
 // 导出模块检测工具

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,6BAA6B,MAAM,sBAAsB,CAAC;AAGjE,mBAAmB;AACnB,cAAc,SAAS,CAAC;AACxB,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,WAAW;AACX,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,sBAAsB,CAAC;AAG9B,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,MAAM,GACP,MAAM,0BAA0B,CAAC;AAGlC,gDAAgD;AAChD,OAAO,EACL,eAAe,EACf,iBAAiB,EAAE,UAAU;AAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY;AACZ,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AAMtC,aAAa;AACb,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAejF,MAAM,uBAAuB,GAAG,6BAA6B,CAAC,yBAAyB,CAAA;AACvF,MAAM,mBAAmB,GAAG,6BAA6B,CAAC,uBAAuB,CAAA;AAGjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;IACzD,SAAS,EAAE,mBAAmB;IAC9B,aAAa,EAAE,uBAAuB;CACvC,CAAC,CAAA;AAEF,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\nimport { createPermissionHook } from 'expo-modules-core';\nimport ExpoGaodeMapModuleWithHelpers from './ExpoGaodeMapModule';\n\n\n// 导出类型定义（包含所有通用类型）\nexport * from './types';\n// 导出原生模块\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 导出错误处理工具\nexport {\n  ErrorHandler,\n  ErrorLogger,\n  GaodeMapError,\n  ErrorType,\n} from './utils/ErrorHandler';\nexport type { ErrorDetails } from './utils/ErrorHandler';\n\n// 导出平台检测工具\nexport {\n  PlatformDetector,\n  DeviceType,\n  FoldState,\n  isAndroid14Plus,\n  isiOS17Plus,\n  isTablet,\n  isFoldable,\n  isIPad,\n} from './utils/PlatformDetector';\nexport type { DeviceInfo, SystemVersion } from './utils/PlatformDetector';\n\n// 导出权限工具类（仅提供文案和诊断，实际权限请求使用 ExpoGaodeMapModule）\nexport {\n  PermissionUtils,\n  PermissionManager, // 向后兼容的别名\n  LocationPermissionType,\n} from './utils/PermissionUtils';\n\n// 导出折叠屏适配组件\nexport {\n  FoldableMapView,\n  useFoldableMap,\n} from './components/FoldableMapView';\nexport type {\n  FoldableMapViewProps,\n  FoldableConfig,\n} from './components/FoldableMapView';\n\n// 导出离线地图 API\nexport { default as ExpoGaodeMapOfflineModule } from './utils/OfflineMapManager';\n\nexport type {\n  OfflineMapInfo,\n  OfflineMapStatus,\n  OfflineMapDownloadConfig,\n  OfflineMapDownloadEvent,\n  OfflineMapCompleteEvent,\n  OfflineMapErrorEvent,\n  OfflineMapPausedEvent,\n  OfflineMapCancelledEvent,\n  OfflineMapStorageInfo,\n  OfflineMapEvents,\n} from './types/offline.types';\n\nconst requestPermissionsAsync = ExpoGaodeMapModuleWithHelpers.requestLocationPermission\nconst getPermissionsAsync = ExpoGaodeMapModuleWithHelpers.checkLocationPermission\n\n\n/**\n * Check or request permissions to access the location.\n * This uses both `requestPermissionsAsync` and `getPermissionsAsync` to interact with the permissions.\n *\n * @example\n * ```ts\n * const [status, requestPermission] = useLocationPermissions();\n * ```\n */\nexport const useLocationPermissions = createPermissionHook({\n  getMethod: getPermissionsAsync,\n  requestMethod: requestPermissionsAsync,\n})\n\n// 导出便捷读取的 SDK 配置与 webKey\nexport { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,6BAA6B,MAAM,sBAAsB,CAAC;AAGjE,mBAAmB;AACnB,cAAc,SAAS,CAAC;AACxB,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,WAAW;AACX,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,sBAAsB,CAAC;AAG9B,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,MAAM,GACP,MAAM,0BAA0B,CAAC;AAGlC,gDAAgD;AAChD,OAAO,EACL,eAAe,EACf,iBAAiB,EAAE,UAAU;AAC7B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY;AACZ,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,8BAA8B,CAAC;AAMtC,aAAa;AACb,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAejF,MAAM,uBAAuB,GAAG,6BAA6B,CAAC,yBAAyB,CAAA;AACvF,MAAM,mBAAmB,GAAG,6BAA6B,CAAC,uBAAuB,CAAA;AAGjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;IACzD,SAAS,EAAE,mBAAmB;IAC9B,aAAa,EAAE,uBAAuB;CACvC,CAAC,CAAA;AAEF,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\nimport { createPermissionHook } from 'expo-modules-core';\nimport ExpoGaodeMapModuleWithHelpers from './ExpoGaodeMapModule';\n\n\n// 导出类型定义（包含所有通用类型）\nexport * from './types';\n// 导出原生模块\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\nexport { useMap } from './components/MapContext';\nexport { MapUI } from './components/MapUI';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 导出错误处理工具\nexport {\n  ErrorHandler,\n  ErrorLogger,\n  GaodeMapError,\n  ErrorType,\n} from './utils/ErrorHandler';\nexport type { ErrorDetails } from './utils/ErrorHandler';\n\n// 导出平台检测工具\nexport {\n  PlatformDetector,\n  DeviceType,\n  FoldState,\n  isAndroid14Plus,\n  isiOS17Plus,\n  isTablet,\n  isFoldable,\n  isIPad,\n} from './utils/PlatformDetector';\nexport type { DeviceInfo, SystemVersion } from './utils/PlatformDetector';\n\n// 导出权限工具类（仅提供文案和诊断，实际权限请求使用 ExpoGaodeMapModule）\nexport {\n  PermissionUtils,\n  PermissionManager, // 向后兼容的别名\n  LocationPermissionType,\n} from './utils/PermissionUtils';\n\n// 导出折叠屏适配组件\nexport {\n  FoldableMapView,\n  useFoldableMap,\n} from './components/FoldableMapView';\nexport type {\n  FoldableMapViewProps,\n  FoldableConfig,\n} from './components/FoldableMapView';\n\n// 导出离线地图 API\nexport { default as ExpoGaodeMapOfflineModule } from './utils/OfflineMapManager';\n\nexport type {\n  OfflineMapInfo,\n  OfflineMapStatus,\n  OfflineMapDownloadConfig,\n  OfflineMapDownloadEvent,\n  OfflineMapCompleteEvent,\n  OfflineMapErrorEvent,\n  OfflineMapPausedEvent,\n  OfflineMapCancelledEvent,\n  OfflineMapStorageInfo,\n  OfflineMapEvents,\n} from './types/offline.types';\n\nconst requestPermissionsAsync = ExpoGaodeMapModuleWithHelpers.requestLocationPermission\nconst getPermissionsAsync = ExpoGaodeMapModuleWithHelpers.checkLocationPermission\n\n\n/**\n * Check or request permissions to access the location.\n * This uses both `requestPermissionsAsync` and `getPermissionsAsync` to interact with the permissions.\n *\n * @example\n * ```ts\n * const [status, requestPermission] = useLocationPermissions();\n * ```\n */\nexport const useLocationPermissions = createPermissionHook({\n  getMethod: getPermissionsAsync,\n  requestMethod: requestPermissionsAsync,\n})\n\n// 导出便捷读取的 SDK 配置与 webKey\nexport { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}

package/build/utils/ModuleLoader.js

@@ -96,7 +96,7 @@ export function createLazyLoader(loader) {
                 cached = loader();
             }
             catch (error) {
-                console.warn('[expo-gaode-map] 模块加载失败:', error);
+                console.warn('[expo-gaode-map] 模块加载失败:');
                 cached = null;
             }
         }

package/build/utils/ModuleLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModuleLoader.js","sourceRoot":"","sources":["../../src/utils/ModuleLoader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,uBAAuB;IAC/B,UAAU,EAAE,2BAA2B;IACvC,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,yBAAyB;CAC3B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,WAAmB;IACnE,OAAO,CAAC,IAAI,CACV,uBAAuB,WAAW,SAAS,UAAU,KAAK;QAC1D,oBAAoB,UAAU,IAAI;QAClC,8BAA8B,UAAU,QAAQ,CACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,IAAI,CACV,oDAAoD;QACpD,6BAA6B,CAC9B,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACvD,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAI,MAAe;IACjD,IAAI,MAAM,GAAa,IAAI,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;gBAChD,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * 模块检测器 - 用于检测可选模块是否已安装\n */\n\n/**\n * 可选模块名称常量\n */\nexport const OptionalModules = {\n  SEARCH: 'expo-gaode-map-search',\n  NAVIGATION: 'expo-gaode-map-navigation',\n  ROUTE: 'expo-gaode-map-route',\n  GEOCODER: 'expo-gaode-map-geocoder',\n} as const;\n\n/**\n * 延迟加载可选模块\n * 使用示例:\n * \n * @example\n * ```typescript\n * import { OptionalModules, lazyLoad } from 'expo-gaode-map';\n * \n * let SearchModule = null;\n * \n * function loadSearch() {\n *   if (SearchModule == null) {\n *     try {\n *       SearchModule = require('expo-gaode-map-search');\n *     } catch (error) {\n *       console.warn('搜索模块未安装');\n *       return null;\n *     }\n *   }\n *   return SearchModule;\n * }\n * \n * // 使用\n * const search = loadSearch();\n * if (search) {\n *   const results = await search.searchPOI({ keyword: '餐厅' });\n * }\n * ```\n */\n\n/**\n * 检查必需模块,如果未安装则抛出错误\n * @param moduleName 模块名称\n * @param featureName 功能名称(用于错误提示)\n */\nexport function requireModule(moduleName: string, featureName: string): void {\n  console.warn(\n    `[expo-gaode-map] 使用 ${featureName} 需要安装 ${moduleName}。\\n` +\n    `请运行: npm install ${moduleName}\\n` +\n    `然后使用 try-catch 包裹 require('${moduleName}') 来加载`\n  );\n}\n\n/**\n * 获取已安装的可选模块列表\n * 注意: 此函数无法在运行时准确检测,仅作为文档说明\n */\nexport function getInstalledModules(): string[] {\n  console.warn(\n    '[expo-gaode-map] getInstalledModules() 无法在运行时检测。\\n' +\n    '请在编译时检查 package.json 中安装的模块'\n  );\n  return [];\n}\n\n/**\n * 打印已安装模块信息(用于调试)\n */\nexport function printModuleInfo(): void {\n  console.log('[expo-gaode-map] 核心模块: 已加载');\n  console.log('[expo-gaode-map] 可选模块检测:');\n  console.log('  - 使用 try-catch 包裹 require() 来检测可选模块');\n  console.log('  - 可用的可选模块:');\n  Object.entries(OptionalModules).forEach(([key, value]) => {\n    console.log(`    - ${key}: ${value}`);\n  });\n}\n\n/**\n * 创建延迟加载器\n * \n * @example\n * ```typescript\n * import { createLazyLoader } from 'expo-gaode-map';\n * \n * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));\n * \n * // 使用时\n * const SearchModule = loadSearch();\n * if (SearchModule) {\n *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });\n * }\n * ```\n */\nexport function createLazyLoader<T>(loader: () => T): () => T | null {\n  let cached: T | null = null;\n  let attempted = false;\n\n  return () => {\n    if (!attempted) {\n      attempted = true;\n      try {\n        cached = loader();\n      } catch (error) {\n        console.warn('[expo-gaode-map] 模块加载失败:', error);\n        cached = null;\n      }\n    }\n    return cached;\n  };\n}"]}
+{"version":3,"file":"ModuleLoader.js","sourceRoot":"","sources":["../../src/utils/ModuleLoader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,uBAAuB;IAC/B,UAAU,EAAE,2BAA2B;IACvC,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,yBAAyB;CAC3B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,WAAmB;IACnE,OAAO,CAAC,IAAI,CACV,uBAAuB,WAAW,SAAS,UAAU,KAAK;QAC1D,oBAAoB,UAAU,IAAI;QAClC,8BAA8B,UAAU,QAAQ,CACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,IAAI,CACV,oDAAoD;QACpD,6BAA6B,CAC9B,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACvD,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAI,MAAe;IACjD,IAAI,MAAM,GAAa,IAAI,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;gBACzC,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * 模块检测器 - 用于检测可选模块是否已安装\n */\n\n/**\n * 可选模块名称常量\n */\nexport const OptionalModules = {\n  SEARCH: 'expo-gaode-map-search',\n  NAVIGATION: 'expo-gaode-map-navigation',\n  ROUTE: 'expo-gaode-map-route',\n  GEOCODER: 'expo-gaode-map-geocoder',\n} as const;\n\n/**\n * 延迟加载可选模块\n * 使用示例:\n * \n * @example\n * ```typescript\n * import { OptionalModules, lazyLoad } from 'expo-gaode-map';\n * \n * let SearchModule = null;\n * \n * function loadSearch() {\n *   if (SearchModule == null) {\n *     try {\n *       SearchModule = require('expo-gaode-map-search');\n *     } catch (error) {\n *       console.warn('搜索模块未安装');\n *       return null;\n *     }\n *   }\n *   return SearchModule;\n * }\n * \n * // 使用\n * const search = loadSearch();\n * if (search) {\n *   const results = await search.searchPOI({ keyword: '餐厅' });\n * }\n * ```\n */\n\n/**\n * 检查必需模块,如果未安装则抛出错误\n * @param moduleName 模块名称\n * @param featureName 功能名称(用于错误提示)\n */\nexport function requireModule(moduleName: string, featureName: string): void {\n  console.warn(\n    `[expo-gaode-map] 使用 ${featureName} 需要安装 ${moduleName}。\\n` +\n    `请运行: npm install ${moduleName}\\n` +\n    `然后使用 try-catch 包裹 require('${moduleName}') 来加载`\n  );\n}\n\n/**\n * 获取已安装的可选模块列表\n * 注意: 此函数无法在运行时准确检测,仅作为文档说明\n */\nexport function getInstalledModules(): string[] {\n  console.warn(\n    '[expo-gaode-map] getInstalledModules() 无法在运行时检测。\\n' +\n    '请在编译时检查 package.json 中安装的模块'\n  );\n  return [];\n}\n\n/**\n * 打印已安装模块信息(用于调试)\n */\nexport function printModuleInfo(): void {\n  console.log('[expo-gaode-map] 核心模块: 已加载');\n  console.log('[expo-gaode-map] 可选模块检测:');\n  console.log('  - 使用 try-catch 包裹 require() 来检测可选模块');\n  console.log('  - 可用的可选模块:');\n  Object.entries(OptionalModules).forEach(([key, value]) => {\n    console.log(`    - ${key}: ${value}`);\n  });\n}\n\n/**\n * 创建延迟加载器\n * \n * @example\n * ```typescript\n * import { createLazyLoader } from 'expo-gaode-map';\n * \n * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));\n * \n * // 使用时\n * const SearchModule = loadSearch();\n * if (SearchModule) {\n *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });\n * }\n * ```\n */\nexport function createLazyLoader<T>(loader: () => T): () => T | null {\n  let cached: T | null = null;\n  let attempted = false;\n\n  return () => {\n    if (!attempted) {\n      attempted = true;\n      try {\n        cached = loader();\n      } catch (error) {\n        console.warn('[expo-gaode-map] 模块加载失败:');\n        cached = null;\n      }\n    }\n    return cached;\n  };\n}"]}

package/ios/ExpoGaodeMapModule.swift

@@ -116,7 +116,7 @@ public class ExpoGaodeMapModule: Module {
             
             guard let keyToUse = finalKey, !keyToUse.isEmpty else {
                 print("⚠️ ExpoGaodeMap: 未提供 iosKey 且 Info.plist 中也无 AMapApiKey，无法初始化 SDK")
-                return
+                throw Exception(name: "INIT_FAILED", description: "未提供 API Key")
             }
             
             // 设置 API Key（若与现有不同或尚未设置）

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-gaode-map",
-  "version": "2.2.12",
-  "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
+  "version": "2.2.13",
+  "description": "A full-featured AMap (Gaode Map) React Native component library built with Expo Modules, providing map display, location services, overlays, and more.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": [
@@ -31,7 +31,8 @@
     "expo",
     "expo-gaode-map",
     "ExpoGaodeMap",
-    "高德地图"
+    "高德地图",
+    "AMap"
   ],
   "repository": {
     "type": "git",