expo-gaode-map 2.2.5-next.2 → 2.2.5

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

@@ -31,14 +31,12 @@ class ExpoGaodeMapModule : Module() {
       // 初始化预加载管理器（注册内存监听）
       MapPreloadManager.initialize(context)
       
-      // 🚀 如果用户已同意隐私协议，自动启动预加载（延迟2秒）
-      if (SDKInitializer.isPrivacyAgreed()) {
-        // 尝试从 AndroidManifest.xml 读取并设置 API Key
-        val apiKey = context.packageManager
+      // 尝试从 AndroidManifest.xml 读取并设置 API Key
+      val apiKey = context.packageManager
           .getApplicationInfo(context.packageName, android.content.pm.PackageManager.GET_META_DATA)
           .metaData?.getString("com.amap.api.v2.apikey")
         
-        if (!apiKey.isNullOrEmpty()) {
+      if (!apiKey.isNullOrEmpty()) {
           try {
             com.amap.api.maps.MapsInitializer.setApiKey(apiKey)
             com.amap.api.location.AMapLocationClient.setApiKey(apiKey)
@@ -55,50 +53,21 @@ class ExpoGaodeMapModule : Module() {
         } else {
           android.util.Log.w("ExpoGaodeMap", "⚠️ AndroidManifest.xml 未找到 API Key，跳过自动预加载")
         }
-      }
+
     } catch (e: Exception) {
       android.util.Log.w("ExpoGaodeMap", "恢复隐私状态时出现问题: ${e.message}")
     }
  
-    // ==================== 隐私合规管理 ====================
+    // ==================== 隐私协议 ====================
     
     /**
      * 更新隐私合规状态
-     * 必须在用户同意隐私协议后调用
-     * @param hasAgreed 用户是否已同意隐私协议
+     * 不用主动调用，下个版本删除
+     * 
      */
     Function("updatePrivacyCompliance") { hasAgreed: Boolean ->
-      val context = appContext.reactContext!!
-      SDKInitializer.updatePrivacyCompliance(context, hasAgreed)
-      
-      // 🚀 用户首次同意隐私协议后，自动启动预加载
-      if (hasAgreed) {
-        // 在用户同意后，如果尚未设置 API Key，则尝试从 AndroidManifest.xml 读取并设置
-        try {
-          val apiKey = context.packageManager
-            .getApplicationInfo(context.packageName, android.content.pm.PackageManager.GET_META_DATA)
-            .metaData?.getString("com.amap.api.v2.apikey")
-          
-          if (!apiKey.isNullOrEmpty()) {
-            com.amap.api.maps.MapsInitializer.setApiKey(apiKey)
-            com.amap.api.location.AMapLocationClient.setApiKey(apiKey)
-            android.util.Log.d("ExpoGaodeMap", "✅ 从 AndroidManifest.xml 读取并设置 API Key 成功")
-          } else {
-            android.util.Log.w("ExpoGaodeMap", "⚠️ AndroidManifest.xml 未找到 API Key，后续需通过 initSDK 提供 androidKey")
-          }
-        } catch (e: Exception) {
-          android.util.Log.w("ExpoGaodeMap", "读取 API Key 失败: ${e.message}")
-        }
-        
-        // 延迟启动预加载
-        android.os.Handler(android.os.Looper.getMainLooper()).postDelayed({
-          if (!MapPreloadManager.hasPreloadedMapView() &&
-              !(MapPreloadManager.getStatus()["isPreloading"] as Boolean)) {
-            android.util.Log.i("ExpoGaodeMap", "🚀 用户同意隐私协议，自动启动预加载")
-            MapPreloadManager.startPreload(context, poolSize = 1)
-          }
-        }, 1000)
-      }
+       val context = appContext.reactContext!!
+       SDKInitializer.restorePrivacyState(context)
     }
     
     // ==================== SDK 初始化 ====================
@@ -137,12 +106,7 @@ class ExpoGaodeMapModule : Module() {
      * 开始连续定位
      */
     Function("start") {
-      // 检查隐私协议状态
-      if (!SDKInitializer.isPrivacyAgreed()) {
-        android.util.Log.w("ExpoGaodeMap", "用户未同意隐私协议，无法开始定位")
-        throw expo.modules.kotlin.exception.CodedException("用户未同意隐私协议，无法开始定位")
-      }
-      
+
       getLocationManager().start()
     }
     
@@ -166,12 +130,6 @@ class ExpoGaodeMapModule : Module() {
      * @return 位置信息对象
      */
     AsyncFunction("getCurrentLocation") { promise: expo.modules.kotlin.Promise ->
-      // 检查隐私协议状态
-      if (!SDKInitializer.isPrivacyAgreed()) {
-        promise.reject("PRIVACY_NOT_AGREED", "用户未同意隐私协议，无法获取位置", null)
-        return@AsyncFunction
-      }
-      
       getLocationManager().getCurrentLocation(promise)
     }
 

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

@@ -20,72 +20,24 @@ object SDKInitializer {
     private var privacyAgreed = true
 
     private const val PREFS_NAME = "expo_gaode_map_prefs"
-//    private const val KEY_PRIVACY_AGREED = "privacy_agreed"
 
     private fun prefs(context: Context): SharedPreferences =
         context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
     
-    /**
-     * 更新隐私合规状态
-     * 必须在用户同意隐私协议后调用
-     *
-     * @param context 应用上下文
-     * @param hasAgreed 用户是否已同意隐私协议
-     * @deprecated 废弃
-     */
-    fun updatePrivacyCompliance(context: Context, hasAgreed: Boolean) {
-//        privacyAgreed = hasAgreed
-//
-//        // 先更新隐私信息显示状态
-//        MapsInitializer.updatePrivacyShow(context, true, true)
-//        AMapLocationClient.updatePrivacyShow(context, true, true)
-//
-//        // 根据用户选择更新同意状态
-//        if (hasAgreed) {
-//            MapsInitializer.updatePrivacyAgree(context, true)
-//            AMapLocationClient.updatePrivacyAgree(context, true)
-//            android.util.Log.d("ExpoGaodeMap", "✅ 用户已同意隐私协议，可以使用 SDK")
-//        } else {
-//            MapsInitializer.updatePrivacyAgree(context, false)
-//            AMapLocationClient.updatePrivacyAgree(context, false)
-//            android.util.Log.w("ExpoGaodeMap", "⚠️ 用户未同意隐私协议，SDK 功能将受限")
-//        }
 
-        // 持久化状态，供下次启动自动恢复
-//        try {
-//            prefs(context).edit().putBoolean(KEY_PRIVACY_AGREED, hasAgreed).apply()
-//        } catch (e: Exception) {
-//            android.util.Log.w("ExpoGaodeMap", "持久化隐私状态失败: ${e.message}")
-//        }
-    }
     
-    /**
-     * 从本地存储恢复隐私合规状态（在应用启动或模块加载时调用）
-     * 若无记录则保持默认 false，不抛出异常。
-     */
     fun restorePrivacyState(context: Context) {
         try {
-//            val saved = prefs(context).getBoolean(KEY_PRIVACY_AGREED, false)
-
             // 同步到 SDK
             MapsInitializer.updatePrivacyShow(context, true, true)
             AMapLocationClient.updatePrivacyShow(context, true, true)
             MapsInitializer.updatePrivacyAgree(context, privacyAgreed)
             AMapLocationClient.updatePrivacyAgree(context, privacyAgreed)
-
-            android.util.Log.d("ExpoGaodeMap", "🔁 已从缓存恢复隐私状态: $  privacyAgreed = saved")
         } catch (e: Exception) {
             android.util.Log.w("ExpoGaodeMap", "恢复隐私状态失败: ${e.message}")
         }
     }
 
-    /**
-     * 检查隐私协议是否已同意
-     *
-     * @return 是否已同意隐私协议
-     */
-    fun isPrivacyAgreed(): Boolean = privacyAgreed
-
     /**
      * 初始化高德地图和定位 SDK
      *

package/build/ExpoGaodeMapModule.d.ts

@@ -47,7 +47,7 @@ declare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents>
      * 更新隐私合规状态
      * 必须在用户同意隐私协议后调用
      * @param hasAgreed 用户是否已同意隐私协议
-     * @deprecated 已经弃用，原生里默认为已同意,不用调
+     * @deprecated 已经弃用，原生里默认为已同意,不再需要调用
      */
     updatePrivacyCompliance(hasAgreed: boolean): void;
     /**

package/build/ExpoGaodeMapModule.js.map

@@ -1 +1 @@
-{"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';\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';\nimport { ErrorHandler, ErrorLogger } from './utils/ErrorHandler';\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 * 权限状态（增强版，支持 Android 14+ 和 iOS 17+）\n */\nexport interface PermissionStatus {\n  /** 是否已授权（前台位置权限） */\n  granted: boolean;\n  \n  // iOS 专用字段\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  \n  // Android 专用字段\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n  /** Android 后台位置权限（Android 10+） */\n  backgroundLocation?: boolean;\n  /** 是否应显示权限说明（Android） */\n  shouldShowRationale?: boolean;\n  /** 权限是否被永久拒绝（Android） */\n  isPermanentlyDenied?: boolean;\n  /** 是否为 Android 14+（Android） */\n  isAndroid14Plus?: boolean;\n  \n  // 其他字段\n  /** 额外的消息说明 */\n  message?: string;\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"]}
+{"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';\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';\nimport { ErrorHandler, ErrorLogger } from './utils/ErrorHandler';\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 * 权限状态（增强版，支持 Android 14+ 和 iOS 17+）\n */\nexport interface PermissionStatus {\n  /** 是否已授权（前台位置权限） */\n  granted: boolean;\n  \n  // iOS 专用字段\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  \n  // Android 专用字段\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n  /** Android 后台位置权限（Android 10+） */\n  backgroundLocation?: boolean;\n  /** 是否应显示权限说明（Android） */\n  shouldShowRationale?: boolean;\n  /** 权限是否被永久拒绝（Android） */\n  isPermanentlyDenied?: boolean;\n  /** 是否为 Android 14+（Android） */\n  isAndroid14Plus?: boolean;\n  \n  // 其他字段\n  /** 额外的消息说明 */\n  message?: string;\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/ios/ExpoGaodeMapModule.swift

@@ -16,10 +16,6 @@ public class ExpoGaodeMapModule: Module {
     private var locationManager: LocationManager?
     /// 权限管理器实例
     private var permissionManager: PermissionManager?
-    /// 隐私协议是否已同意（模块级别跟踪）
-    /// private static var privacyAgreed: Bool = false
-    /// 隐私同意持久化 Key
-    // private static let privacyDefaultsKey = "expo_gaode_map_privacy_agreed"
     
     // MARK: - 私有辅助方法
     
@@ -85,51 +81,20 @@ public class ExpoGaodeMapModule: Module {
 
             // 4. 自动启动预加载（可选）
             self.tryStartPreload(delay: 2.0, poolSize: 1)
-
-            // 先确保隐私信息展示状态
-            // MAMapView.updatePrivacyShow(AMapPrivacyShowStatus.didShow, privacyInfo: AMapPrivacyInfoStatus.didContain)
-
-            // 从 UserDefaults 恢复上次的同意状态（默认 false）
-            // let saved = UserDefaults.standard.bool(forKey: ExpoGaodeMapModule.privacyDefaultsKey)
-            // ExpoGaodeMapModule.privacyAgreed = saved
-            // if saved {
-            //     // 同步到 SDK
-            //     MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
-            //     print("🔁 ExpoGaodeMap: 已从缓存恢复隐私同意状态: true")
-                
-            //     // 尝试设置 API Key 并启动预加载（延迟2秒）
-            //     self.trySetupApiKeyFromPlist()
-            //     self.tryStartPreload(delay: 2.0, poolSize: 1)
-            // } else {
-            //     print("ℹ️ ExpoGaodeMap: 未发现已同意记录，等待用户同意后再使用 SDK")
-            // }
         }
         
-        // ==================== 隐私合规管理 ====================
-        
+
         /**
-         * 更新隐私合规状态
-         * 必须在用户同意隐私协议后调用
-         * @deprecated 废弃
+         * 更新隐私协议状态
+         * 不再需要主动调用，下个版本删除
          */
         Function("updatePrivacyCompliance") { (hasAgreed: Bool) in
-            // 更新内存状态
-            // ExpoGaodeMapModule.privacyAgreed = hasAgreed
-            // // 持久化到本地，供下次启动自动恢复
-            // UserDefaults.standard.set(hasAgreed, forKey: ExpoGaodeMapModule.privacyDefaultsKey)
-
-            // if hasAgreed {
-            //     // 同步到 SDK
-            //     MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
-            //     print("✅ ExpoGaodeMap: 用户已同意隐私协议，可以使用 SDK（状态已持久化）")
-                
-            //     // 尝试设置 API Key 并启动预加载（延迟1秒）
-            //     self.trySetupApiKeyFromPlist()
-            //     self.tryStartPreload(delay: 1.0, poolSize: 1)
-            // } else {
-            //     MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.notAgree)
-            //     print("⚠️ ExpoGaodeMap: 用户未同意隐私协议，SDK 功能将受限（状态已持久化）")
-            // }
+            MAMapView.updatePrivacyShow(
+                AMapPrivacyShowStatus.didShow,
+                privacyInfo: AMapPrivacyInfoStatus.didContain
+            )
+            MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
+            
         }
         // ==================== SDK 初始化 ====================
         
@@ -138,13 +103,6 @@ public class ExpoGaodeMapModule: Module {
          * @param config 配置字典,包含 iosKey
          */
         Function("initSDK") { (config: [String: String]) in
-            // 检查是否已同意隐私协议
-            // if !ExpoGaodeMapModule.privacyAgreed {
-            //     print("⚠️ ExpoGaodeMap: 用户未同意隐私协议，无法初始化 SDK")
-
-            //     return
-            // }
-            
             // 1) 优先使用传入的 iosKey；2) 否则回退读取 Info.plist 的 AMapApiKey
             let providedKey = config["iosKey"]?.trimmingCharacters(in: .whitespacesAndNewlines)
             var finalKey: String? = (providedKey?.isEmpty == false) ? providedKey : nil
@@ -185,11 +143,6 @@ public class ExpoGaodeMapModule: Module {
          * 开始连续定位
          */
         Function("start") {
-            // 检查隐私协议状态
-            // if !ExpoGaodeMapModule.privacyAgreed {
-            //     print("⚠️ ExpoGaodeMap: 用户未同意隐私协议，无法开始定位")
-            //     return
-            // }
             
             // 检查是否已设置 API Key
             if AMapServices.shared().apiKey == nil || AMapServices.shared().apiKey?.isEmpty == true {
@@ -219,11 +172,7 @@ public class ExpoGaodeMapModule: Module {
          * 返回位置信息和逆地理编码结果
          */
         AsyncFunction("getCurrentLocation") { (promise: Promise) in
-            // 检查隐私协议状态
-            // if !ExpoGaodeMapModule.privacyAgreed {
-            //     promise.reject("PRIVACY_NOT_AGREED", "用户未同意隐私协议，无法获取位置")
-            //     return
-            // }
+
             
             // 检查是否已设置 API Key
             if AMapServices.shared().apiKey == nil || AMapServices.shared().apiKey?.isEmpty == true {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map",
-  "version": "2.2.5-next.2",
+  "version": "2.2.5",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -19,13 +19,17 @@
     "ExpoGaodeMap",
     "高德地图"
   ],
-  "repository": "https://github.com/TomWq/expo-gaode-map",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TomWq/expo-gaode-map",
+    "directory": "packages/core"
+  },
   "bugs": {
     "url": "https://github.com/TomWq/expo-gaode-map/issues"
   },
   "author": "<TomWq>(https://github.com/TomWq)",
   "license": "MIT",
-  "homepage": "https://github.com/TomWq/expo-gaode-map#readme",
+  "homepage": "https://github.com/TomWq/expo-gaode-map/tree/main/packages/core",
   "dependencies": {
     "supercluster": "^8.0.1"
   },