expo-gaode-map 2.2.2 → 2.2.3-next.1

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/lookups.tab.values.s

@@ -1 +1 @@
-Ɩ
��
�
ӄ
�

+Ɩ
��
�
ӄ
�
��

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

@@ -352,11 +352,46 @@ class ExpoGaodeMapModule : Module() {
       handler.postDelayed(checkPermission, 100)
     }
 
+    // ==================== 地图预加载 ====================
+    
+    /**
+     * 开始预加载地图实例
+     * @param config 预加载配置对象,包含 poolSize
+     */
+    Function("startMapPreload") { config: Map<String, Any> ->
+      val poolSize = (config["poolSize"] as? Number)?.toInt() ?: 2
+      MapPreloadManager.startPreload(appContext.reactContext!!, poolSize)
+    }
+    
+    /**
+     * 获取预加载状态
+     * @return 预加载状态信息
+     */
+    Function("getMapPreloadStatus") {
+      MapPreloadManager.getStatus()
+    }
+    
+    /**
+     * 清空预加载池
+     */
+    Function("clearMapPreloadPool") {
+      MapPreloadManager.clearPool()
+    }
+    
+    /**
+     * 检查是否有可用的预加载实例
+     * @return 是否有可用实例
+     */
+    Function("hasPreloadedMapView") {
+      MapPreloadManager.hasPreloadedMapView()
+    }
+
     Events("onLocationUpdate")
 
     OnDestroy {
       locationManager?.destroy()
       locationManager = null
+      MapPreloadManager.cleanup()
     }
   }
 

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

@@ -0,0 +1,174 @@
+/**
+ * 地图预加载管理器 (Android)
+ * 在后台预先初始化地图实例，提升首次显示速度
+ */
+
+package expo.modules.gaodemap
+
+import android.content.Context
+import android.util.Log
+import com.amap.api.maps.AMap
+import com.amap.api.maps.CameraUpdateFactory
+import com.amap.api.maps.MapView
+import com.amap.api.maps.model.CameraPosition
+import com.amap.api.maps.model.LatLng
+import kotlinx.coroutines.*
+import java.util.concurrent.ConcurrentLinkedQueue
+import java.util.concurrent.atomic.AtomicBoolean
+
+/**
+ * 地图预加载管理器单例
+ */
+object MapPreloadManager {
+    private const val TAG = "MapPreloadManager"
+    private const val MAX_POOL_SIZE = 3
+    
+    private val preloadedMapViews = ConcurrentLinkedQueue<MapView>()
+    private val isPreloading = AtomicBoolean(false)
+    private val preloadScope = CoroutineScope(Dispatchers.IO + SupervisorJob())
+    
+    init {
+        Log.d(TAG, "🔧 初始化预加载管理器")
+    }
+    
+    /**
+     * 开始预加载地图实例
+     * @param context Android 上下文
+     * @param poolSize 预加载的地图实例数量
+     */
+    fun startPreload(context: Context, poolSize: Int) {
+        if (isPreloading.get()) {
+            Log.w(TAG, "⚠️ 预加载已在进行中")
+            return
+        }
+        
+        isPreloading.set(true)
+        val targetSize = minOf(poolSize, MAX_POOL_SIZE)
+        Log.i(TAG, "🚀 开始预加载 $targetSize 个地图实例")
+        
+        preloadScope.launch {
+            repeat(targetSize) { index ->
+                try {
+                    val mapView = createPreloadedMapView(context)
+                    
+                    withContext(Dispatchers.Main) {
+                        preloadedMapViews.offer(mapView)
+                        Log.i(TAG, "✅ 预加载实例 ${index + 1}/$targetSize 完成")
+                        
+                        if (index == targetSize - 1) {
+                            isPreloading.set(false)
+                            Log.i(TAG, "🎉 所有实例预加载完成")
+                        }
+                    }
+                } catch (e: Exception) {
+                    Log.e(TAG, "❌ 预加载实例 ${index + 1} 失败: ${e.message}", e)
+                    if (index == targetSize - 1) {
+                        isPreloading.set(false)
+                    }
+                }
+            }
+        }
+    }
+    
+    /**
+     * 创建预加载的地图视图
+     * @param context Android 上下文
+     * @return 预加载的地图视图实例
+     */
+    private suspend fun createPreloadedMapView(context: Context): MapView {
+        return withContext(Dispatchers.Main) {
+            val mapView = MapView(context)
+            val aMap = mapView.map
+            
+            // 基础配置
+            aMap.mapType = AMap.MAP_TYPE_NORMAL
+            aMap.isMyLocationEnabled = false
+            aMap.uiSettings.isCompassEnabled = false
+            aMap.uiSettings.isScaleControlsEnabled = false
+            aMap.uiSettings.isZoomControlsEnabled = false
+            aMap.uiSettings.isRotateGesturesEnabled = true
+            aMap.uiSettings.isScrollGesturesEnabled = true
+            aMap.uiSettings.isZoomGesturesEnabled = true
+            
+            // 预加载中心区域（北京天安门）
+            val cameraPosition = CameraPosition(
+                LatLng(39.9042, 116.4074),
+                12f,  // zoom
+                0f,   // tilt
+                0f    // bearing
+            )
+            aMap.moveCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))
+            
+            // 触发地图初始化
+            mapView.onCreate(null)
+            
+            mapView
+        }
+    }
+    
+    /**
+     * 获取一个预加载的地图实例
+     * @return 预加载的地图视图，如果池为空则返回 null
+     */
+    fun getPreloadedMapView(): MapView? {
+        val mapView = preloadedMapViews.poll()
+        
+        if (mapView != null) {
+            Log.i(TAG, "📤 使用预加载实例，剩余: ${preloadedMapViews.size}")
+            
+            // 如果池快空了，记录日志（不自动补充，因为需要 context）
+            if (preloadedMapViews.isEmpty() && !isPreloading.get()) {
+                Log.w(TAG, "⚠️ 预加载池为空")
+            }
+        } else {
+            Log.w(TAG, "⚠️ 预加载池为空，返回 null")
+        }
+        
+        return mapView
+    }
+    
+    /**
+     * 清空预加载池
+     */
+    fun clearPool() {
+        val count = preloadedMapViews.size
+        preloadedMapViews.forEach { mapView ->
+            try {
+                mapView.onDestroy()
+            } catch (e: Exception) {
+                Log.e(TAG, "清理地图实例失败: ${e.message}", e)
+            }
+        }
+        preloadedMapViews.clear()
+        Log.i(TAG, "🗑️ 预加载池已清空，清理了 $count 个实例")
+    }
+    
+    /**
+     * 获取预加载状态
+     * @return 预加载状态信息
+     */
+    fun getStatus(): Map<String, Any> {
+        return mapOf(
+            "poolSize" to preloadedMapViews.size,
+            "isPreloading" to isPreloading.get(),
+            "maxPoolSize" to MAX_POOL_SIZE
+        )
+    }
+    
+    /**
+     * 检查是否有可用的预加载实例
+     * @return 是否有可用实例
+     */
+    fun hasPreloadedMapView(): Boolean {
+        return preloadedMapViews.isNotEmpty()
+    }
+    
+    /**
+     * 清理资源
+     */
+    fun cleanup() {
+        clearPool()
+        preloadScope.cancel()
+        Log.i(TAG, "🧹 预加载管理器已清理")
+    }
+}

package/build/ExpoGaodeMapModule.d.ts

@@ -189,6 +189,34 @@ declare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents>
      * @returns Promise<PermissionStatus> 请求后的权限状态
      */
     requestLocationPermission(): Promise<PermissionStatus>;
+    /**
+     * 开始预加载地图实例
+     * 在后台预先初始化地图视图，提升首次显示速度
+     * @param config 预加载配置对象
+     * @param config.poolSize 预加载的地图实例数量，默认 2
+     */
+    startMapPreload(config: {
+        poolSize?: number;
+    }): void;
+    /**
+     * 获取预加载状态
+     * @returns 预加载状态信息，包含池大小、是否正在预加载等
+     */
+    getMapPreloadStatus(): {
+        poolSize: number;
+        isPreloading: boolean;
+        maxPoolSize: number;
+    };
+    /**
+     * 清空预加载池
+     * 释放所有预加载的地图实例
+     */
+    clearMapPreloadPool(): void;
+    /**
+     * 检查是否有可用的预加载实例
+     * @returns 是否有可用的预加载地图实例
+     */
+    hasPreloadedMapView(): boolean;
     /**
      * 添加定位监听器（便捷方法）
      * 封装了 addListener，提供更简洁的 API

package/build/ExpoGaodeMapModule.d.ts.map

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

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;AA2PzD,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   * 封装了 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":"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"]}

package/build/components/MapPreloader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 地图预加载组件
+ * 在后台渲染隐藏的地图视图以实现预加载
+ */
+import React from 'react';
+import { PreloadConfig } from '../utils/MapPreloader';
+import type { MapViewProps } from '../types';
+/**
+ * 预加载组件属性
+ */
+export interface MapPreloaderProps {
+    /** 预加载配置 */
+    config?: PreloadConfig;
+    /** 预加载的地图视图属性 */
+    mapProps?: Partial<MapViewProps>;
+    /** 是否启用预加载，默认为 true */
+    enabled?: boolean;
+    /** 预加载完成回调 */
+    onPreloadComplete?: () => void;
+    /** 预加载失败回调 */
+    onPreloadError?: (error: Error) => void;
+}
+/**
+ * 地图预加载组件
+ *
+ * 在应用启动时渲染隐藏的地图视图，提前初始化地图引擎，
+ * 当用户真正需要显示地图时可以获得更快的加载速度
+ *
+ * @example
+ * ```tsx
+ * // 在 App 根组件中使用
+ * function App() {
+ *   return (
+ *     <>
+ *       <MapPreloader
+ *         config={{ poolSize: 1, delay: 2000 }}
+ *         onPreloadComplete={() => console.log('地图预加载完成')}
+ *       />
+ *       <YourAppContent />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare const MapPreloaderComponent: React.FC<MapPreloaderProps>;
+export default MapPreloaderComponent;
+//# sourceMappingURL=MapPreloader.d.ts.map