expo-gaode-map-navigation 2.0.2 → 2.0.4-next.0

package/android/build.gradle

@@ -27,6 +27,9 @@ if (useManagedAndroidSdkVersions) {
   }
 }
 
+logger.warn("[expo-gaode-map-navigation] Thank you for using expo-gaode-map-navigation ❤️")
+logger.warn("[expo-gaode-map-navigation] If you enjoy using expo-gaode-map-navigation, please consider sponsoring this project: https://github.com/TomWq")
+
 android {
   namespace "expo.modules.gaodemap.navigation"
   defaultConfig {

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

@@ -30,42 +30,6 @@ class ExpoGaodeMapModule : Module() {
   override fun definition() = ModuleDefinition {
     Name("ExpoGaodeMap")
 
-    // 在模块加载时尝试从本地缓存恢复隐私同意状态，避免每次启动都必须 JS 调用
-    try {
-      val context = appContext.reactContext!!
-      SDKInitializer.restorePrivacyState(context)
-
-      // 初始化预加载管理器（注册内存监听）
-      MapPreloadManager.initialize(context)
-
-      // 尝试从 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()) {
-          try {
-            MapsInitializer.setApiKey(apiKey)
-            com.amap.api.location.AMapLocationClient.setApiKey(apiKey)
-
-
-            // 只有在 API Key 已设置的情况下才启动预加载
-            android.os.Handler(android.os.Looper.getMainLooper()).postDelayed({
-              android.util.Log.i("ExpoGaodeMap", "🚀 自动启动地图预加载")
-              MapPreloadManager.startPreload(context, poolSize = 1)
-            }, 2000)
-          } catch (e: Exception) {
-            android.util.Log.w("ExpoGaodeMap", "设置 API Key 失败: ${e.message}")
-          }
-        } else {
-          android.util.Log.w("ExpoGaodeMap", "⚠️ AndroidManifest.xml 未找到 API Key，跳过自动预加载")
-        }
-
-    } catch (e: Exception) {
-      android.util.Log.w("ExpoGaodeMap", "恢复隐私状态时出现问题: ${e.message}")
-    }
- 
-  
     // ==================== SDK 初始化 ====================
     
     /**
@@ -74,23 +38,42 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("initSDK") { config: Map<String, String> ->
       val androidKey = config["androidKey"]
-      if (androidKey != null) {
-        try {
-          SDKInitializer.initSDK(appContext.reactContext!!, androidKey)
-          getLocationManager() // 初始化定位管理器
-          
-          // 初始化成功后自动触发一次预加载
-          MapPreloadManager.startPreload(appContext.reactContext!!, poolSize = 1)
-        } catch (e: SecurityException) {
-          android.util.Log.e("ExpoGaodeMap", "隐私协议未同意: ${e.message}")
-          throw expo.modules.kotlin.exception.CodedException("PRIVACY_NOT_AGREED", e.message ?: "用户未同意隐私协议", e)
-        } catch (e: Exception) {
-          android.util.Log.e("ExpoGaodeMap", "SDK 初始化失败: ${e.message}")
-          throw expo.modules.kotlin.exception.CodedException("INIT_FAILED", e.message ?: "SDK 初始化失败", e)
+      try {
+        val context = appContext.reactContext!!
+        if (androidKey != null) {
+          SDKInitializer.initSDK(context, androidKey)
+        } else if (!SDKInitializer.isPrivacyReady()) {
+          throw expo.modules.kotlin.exception.CodedException(
+            "PRIVACY_NOT_AGREED",
+            "隐私协议未完成确认，请先调用 setPrivacyShow/setPrivacyAgree",
+            null
+          )
+        } else {
+          SDKInitializer.applyPrivacyState(context)
         }
+
+        getLocationManager()
+      } catch (e: SecurityException) {
+        android.util.Log.e("ExpoGaodeMap", "隐私协议未同意: ${e.message}")
+        throw expo.modules.kotlin.exception.CodedException("PRIVACY_NOT_AGREED", e.message ?: "用户未同意隐私协议", e)
+      } catch (e: Exception) {
+        android.util.Log.e("ExpoGaodeMap", "SDK 初始化失败: ${e.message}")
+        throw expo.modules.kotlin.exception.CodedException("INIT_FAILED", e.message ?: "SDK 初始化失败", e)
       }
     }
 
+    Function("setPrivacyShow") { hasShow: Boolean, hasContainsPrivacy: Boolean ->
+      SDKInitializer.setPrivacyShow(appContext.reactContext!!, hasShow, hasContainsPrivacy)
+    }
+
+    Function("setPrivacyAgree") { hasAgree: Boolean ->
+      SDKInitializer.setPrivacyAgree(appContext.reactContext!!, hasAgree)
+    }
+
+    Function("getPrivacyStatus") {
+      SDKInitializer.getPrivacyStatus()
+    }
+
     /**
      * 设置是否加载世界向量地图
      * @param enable 是否开启
@@ -890,7 +873,6 @@ class ExpoGaodeMapModule : Module() {
     OnDestroy {
       locationManager?.destroy()
       locationManager = null
-      MapPreloadManager.cleanup()
     }
   }
 

package/android/src/main/java/expo/modules/gaodemap/map/ExpoGaodeMapView.kt

@@ -13,6 +13,7 @@ import expo.modules.kotlin.viewevent.EventDispatcher
 import expo.modules.kotlin.views.ExpoView
 import expo.modules.gaodemap.map.managers.CameraManager
 import expo.modules.gaodemap.map.managers.UIManager
+import expo.modules.gaodemap.map.modules.SDKInitializer
 import expo.modules.gaodemap.map.overlays.*
 import androidx.core.graphics.createBitmap
 import androidx.core.view.isVisible
@@ -93,22 +94,11 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
 
     init {
         try {
-            // 确保隐私合规已设置
-            MapsInitializer.updatePrivacyShow(context, true, true)
-            MapsInitializer.updatePrivacyAgree(context, true)
+            SDKInitializer.applyPrivacyState(context)
 
-            // 尝试从预加载池获取 MapView
-            val preloadedMapView = MapPreloadManager.getPreloadedMapView()
-            
-            if (preloadedMapView != null) {
-                mapView = preloadedMapView
-                android.util.Log.i("ExpoGaodeMapView", "🚀 使用预加载的 MapView 实例")
-            } else {
-                // 创建地图视图
-                mapView = MapView(context)
-                mapView.onCreate(null)
-                android.util.Log.i("ExpoGaodeMapView", "⚠️ 创建新的 MapView 实例 (未命中预加载池)")
-            }
+            // 直接创建地图视图
+            mapView = MapView(context)
+            mapView.onCreate(null)
             
             aMap = mapView.map
 

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

@@ -14,24 +14,50 @@ import com.amap.api.maps.MapsInitializer
  * - 获取 SDK 版本信息
  */
 object SDKInitializer {
-    
-    /** 隐私协议是否已同意（进程内缓存） */
-    private var privacyAgreed = true
+    private var privacyAgreed = false
+    private var privacyShown = false
+    private var privacyContains = false
 
+    private fun resolveContext(context: Context): Context {
+        return context.applicationContext ?: context
+    }
+
+    fun setPrivacyShow(context: Context, hasShow: Boolean, hasContainsPrivacy: Boolean) {
+        privacyShown = hasShow
+        privacyContains = hasContainsPrivacy
+        applyPrivacyState(resolveContext(context))
+    }
+
+    fun setPrivacyAgree(context: Context, hasAgree: Boolean) {
+        privacyAgreed = hasAgree
+        applyPrivacyState(resolveContext(context))
+    }
 
-    
-    fun restorePrivacyState(context: Context) {
+    fun applyPrivacyState(context: Context) {
+        val appContext = resolveContext(context)
         try {
-            // 同步到 SDK
-            MapsInitializer.updatePrivacyShow(context, true, true)
-            AMapLocationClient.updatePrivacyShow(context, true, true)
-            MapsInitializer.updatePrivacyAgree(context, privacyAgreed)
-            AMapLocationClient.updatePrivacyAgree(context, privacyAgreed)
+            MapsInitializer.updatePrivacyShow(appContext, privacyShown, privacyContains)
+            AMapLocationClient.updatePrivacyShow(appContext, privacyShown, privacyContains)
+            MapsInitializer.updatePrivacyAgree(appContext, privacyAgreed)
+            AMapLocationClient.updatePrivacyAgree(appContext, privacyAgreed)
         } catch (e: Exception) {
-            android.util.Log.w("ExpoGaodeMap", "恢复隐私状态失败: ${e.message}")
+            android.util.Log.w("ExpoGaodeMap", "同步隐私状态失败: ${e.message}")
         }
     }
 
+    fun isPrivacyReady(): Boolean {
+        return privacyShown && privacyContains && privacyAgreed
+    }
+
+    fun getPrivacyStatus(): Map<String, Boolean> {
+        return mapOf(
+            "hasShow" to privacyShown,
+            "hasContainsPrivacy" to privacyContains,
+            "hasAgree" to privacyAgreed,
+            "isReady" to isPrivacyReady()
+        )
+    }
+
     /**
      * 初始化高德地图和定位 SDK
      *
@@ -40,13 +66,14 @@ object SDKInitializer {
      * @throws Exception 初始化失败时抛出异常
      */
     fun initSDK(context: Context, androidKey: String) {
+        val appContext = resolveContext(context)
         // 检查隐私协议状态
-        if (!privacyAgreed) {
-            // 使用 Kotlin 模块的 CodedException，让 JS 能收到标准化异常
-            throw expo.modules.kotlin.exception.CodedException("用户未同意隐私协议，无法初始化 SDK")
+        if (!isPrivacyReady()) {
+            throw expo.modules.kotlin.exception.CodedException("隐私协议未完成确认，请先调用 setPrivacyShow/setPrivacyAgree")
         }
         
         try {
+            applyPrivacyState(appContext)
             // 设置 API Key
             MapsInitializer.setApiKey(androidKey)
             AMapLocationClient.setApiKey(androidKey)

package/build/ExpoGaodeMapNaviView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapNaviView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F;;OAEG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,2GAwB/B,CAAC;AAIH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"ExpoGaodeMapNaviView.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAGtE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9F;;OAEG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,2GAyB/B,CAAC;AAIH,eAAe,oBAAoB,CAAC"}

package/build/ExpoGaodeMapNaviView.js

@@ -1,6 +1,6 @@
-import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
-const NativeView = requireNativeViewManager('ExpoGaodeMapNaviView');
+import { createLazyNativeViewManager } from './map/utils/lazyNativeViewManager';
+const getNativeView = createLazyNativeViewManager('ExpoGaodeMapNaviView');
 /**
  * 高德导航视图组件
  *
@@ -36,6 +36,7 @@ const NativeView = requireNativeViewManager('ExpoGaodeMapNaviView');
  */
 export const ExpoGaodeMapNaviView = React.forwardRef((props, ref) => {
     const nativeRef = React.useRef(null);
+    const NativeView = React.useMemo(() => getNativeView(), []);
     // 创建 API 引用
     const apiRef = React.useMemo(() => ({
         startNavigation: async (start, end, type) => {

package/build/ExpoGaodeMapNaviView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapNaviView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmB/B,MAAM,UAAU,GAA8E,wBAAwB,CAAC,sBAAsB,CAAC,CAAC;AAE/I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,UAAU,CAAqD,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACtH,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAM,IAAI,CAAC,CAAC;IAE1C,YAAY;IACZ,MAAM,MAAM,GAA4B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,eAAe,EAAE,KAAK,EAAE,KAAyB,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;YACnF,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAChF,oBAAoB;YACpB,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC;YAC7B,OAAO,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/E,CAAC;QACD,cAAc,EAAE,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAChF,OAAO,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC,EAAE,EAAE,CAAC,CAAC;IAER,iBAAiB;IACjB,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,EAAG,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,oBAAoB,CAAC,WAAW,GAAG,sBAAsB,CAAC;AAE1D,eAAe,oBAAoB,CAAC","sourcesContent":["\nimport { requireNativeViewManager } from 'expo-modules-core';\nimport * as React from 'react';\nimport type { Coordinates, ExpoGaodeMapNaviViewProps } from './types';\n\n/**\n * ExpoGaodeMapNaviView Ref 类型\n */\nexport interface ExpoGaodeMapNaviViewRef {\n  /**\n   * 开始导航\n   */\n  startNavigation: (start: Coordinates | null, end: Coordinates, type: number) => Promise<void>;\n  \n  /**\n   * 停止导航\n   */\n  stopNavigation: () => Promise<void>;\n}\n\n\nconst NativeView: React.ComponentType<ExpoGaodeMapNaviViewProps & { ref?: React.Ref<any> }> = requireNativeViewManager('ExpoGaodeMapNaviView');\n\n/**\n * 高德导航视图组件\n *\n * 使用高德官方的导航界面，提供完整的导航体验，包括：\n * - 路线规划和显示\n * - 实时导航信息（距离、时间、道路名称）\n * - 转向箭头和提示\n * - 路况信息\n * - 摄像头提示\n * - 语音播报\n *\n * @example\n * ```tsx\n * import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';\n *\n * function NavigationScreen() {\n *   return (\n *     <ExpoGaodeMapNaviView\n *       style={{ flex: 1 }}\n *       naviType={0} // GPS 导航\n *       showCamera={true}\n *       enableVoice={true}\n *       onNaviInfoUpdate={(e) => {\n *         console.log('剩余距离:', e.nativeEvent.pathRetainDistance);\n *       }}\n *       onArrive={() => {\n *         console.log('到达目的地！');\n *       }}\n *     />\n *   );\n * }\n * ```\n */\nexport const ExpoGaodeMapNaviView = React.forwardRef<ExpoGaodeMapNaviViewRef, ExpoGaodeMapNaviViewProps>((props, ref) => {\n  const nativeRef = React.useRef<any>(null);\n  \n  // 创建 API 引用\n  const apiRef: ExpoGaodeMapNaviViewRef = React.useMemo(() => ({\n    startNavigation: async (start: Coordinates | null, end: Coordinates, type: number) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      // 将对象解构为单独的参数传递给原生层\n      const startLat = start?.latitude ?? 0;\n      const startLng = start?.longitude ?? 0;\n      const endLat = end.latitude;\n      const endLng = end.longitude;\n      return nativeRef.current.startNavigation(startLat, startLng, endLat, endLng);\n    },\n    stopNavigation: async () => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.stopNavigation();\n    },\n  }), []);\n  \n  // 暴露 API 给外部 ref\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n  \n  return <NativeView ref={nativeRef} {...props} />;\n});\n\nExpoGaodeMapNaviView.displayName = 'ExpoGaodeMapNaviView';\n\nexport default ExpoGaodeMapNaviView;"]}
+{"version":3,"file":"ExpoGaodeMapNaviView.js","sourceRoot":"","sources":["../src/ExpoGaodeMapNaviView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAkBhF,MAAM,aAAa,GAAG,2BAA2B,CAAuD,sBAAsB,CAAC,CAAC;AAEhI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,UAAU,CAAqD,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACtH,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAM,IAAI,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IAE5D,YAAY;IACZ,MAAM,MAAM,GAA4B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,eAAe,EAAE,KAAK,EAAE,KAAyB,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;YACnF,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAChF,oBAAoB;YACpB,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC;YAC7B,OAAO,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/E,CAAC;QACD,cAAc,EAAE,KAAK,IAAI,EAAE;YACzB,IAAI,CAAC,SAAS,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAChF,OAAO,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC,EAAE,EAAE,CAAC,CAAC;IAER,iBAAiB;IACjB,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,EAAG,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,oBAAoB,CAAC,WAAW,GAAG,sBAAsB,CAAC;AAE1D,eAAe,oBAAoB,CAAC","sourcesContent":["import * as React from 'react';\nimport type { Coordinates, ExpoGaodeMapNaviViewProps } from './types';\nimport { createLazyNativeViewManager } from './map/utils/lazyNativeViewManager';\n\n/**\n * ExpoGaodeMapNaviView Ref 类型\n */\nexport interface ExpoGaodeMapNaviViewRef {\n  /**\n   * 开始导航\n   */\n  startNavigation: (start: Coordinates | null, end: Coordinates, type: number) => Promise<void>;\n  \n  /**\n   * 停止导航\n   */\n  stopNavigation: () => Promise<void>;\n}\n\n\nconst getNativeView = createLazyNativeViewManager<ExpoGaodeMapNaviViewProps & { ref?: React.Ref<any> }>('ExpoGaodeMapNaviView');\n\n/**\n * 高德导航视图组件\n *\n * 使用高德官方的导航界面，提供完整的导航体验，包括：\n * - 路线规划和显示\n * - 实时导航信息（距离、时间、道路名称）\n * - 转向箭头和提示\n * - 路况信息\n * - 摄像头提示\n * - 语音播报\n *\n * @example\n * ```tsx\n * import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';\n *\n * function NavigationScreen() {\n *   return (\n *     <ExpoGaodeMapNaviView\n *       style={{ flex: 1 }}\n *       naviType={0} // GPS 导航\n *       showCamera={true}\n *       enableVoice={true}\n *       onNaviInfoUpdate={(e) => {\n *         console.log('剩余距离:', e.nativeEvent.pathRetainDistance);\n *       }}\n *       onArrive={() => {\n *         console.log('到达目的地！');\n *       }}\n *     />\n *   );\n * }\n * ```\n */\nexport const ExpoGaodeMapNaviView = React.forwardRef<ExpoGaodeMapNaviViewRef, ExpoGaodeMapNaviViewProps>((props, ref) => {\n  const nativeRef = React.useRef<any>(null);\n  const NativeView = React.useMemo(() => getNativeView(), []);\n  \n  // 创建 API 引用\n  const apiRef: ExpoGaodeMapNaviViewRef = React.useMemo(() => ({\n    startNavigation: async (start: Coordinates | null, end: Coordinates, type: number) => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      // 将对象解构为单独的参数传递给原生层\n      const startLat = start?.latitude ?? 0;\n      const startLng = start?.longitude ?? 0;\n      const endLat = end.latitude;\n      const endLng = end.longitude;\n      return nativeRef.current.startNavigation(startLat, startLng, endLat, endLng);\n    },\n    stopNavigation: async () => {\n      if (!nativeRef.current) throw new Error('ExpoGaodeMapNaviView not initialized');\n      return nativeRef.current.stopNavigation();\n    },\n  }), []);\n  \n  // 暴露 API 给外部 ref\n  React.useImperativeHandle(ref, () => apiRef, [apiRef]);\n  \n  return <NativeView ref={nativeRef} {...props} />;\n});\n\nExpoGaodeMapNaviView.displayName = 'ExpoGaodeMapNaviView';\n\nexport default ExpoGaodeMapNaviView;\n"]}

package/build/ExpoGaodeMapNavigationModule.d.ts

@@ -1,9 +1,4 @@
 import { ExpoGaodeMapNavigationModule as ExpoGaodeMapNavigationModuleType } from './types/native-module.types';
-/**
- * 高德地图导航模块
- *
- * 提供路径规划功能，包括驾车、步行、骑行、公交、货车等多种出行方式
- */
-declare const ExpoGaodeMapNavigationModule: ExpoGaodeMapNavigationModuleType;
-export default ExpoGaodeMapNavigationModule;
+declare const _default: ExpoGaodeMapNavigationModuleType;
+export default _default;
 //# sourceMappingURL=ExpoGaodeMapNavigationModule.d.ts.map

package/build/ExpoGaodeMapNavigationModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapNavigationModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapNavigationModule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,IAAI,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/G;;;;GAIG;AACH,QAAA,MAAM,4BAA4B,kCAAkF,CAAC;AAErH,eAAe,4BAA4B,CAAC"}
+{"version":3,"file":"ExpoGaodeMapNavigationModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapNavigationModule.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,4BAA4B,IAAI,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;;AAe/G,wBAIG"}

package/build/ExpoGaodeMapNavigationModule.js

@@ -4,6 +4,16 @@ import { requireNativeModule } from 'expo-modules-core';
  *
  * 提供路径规划功能，包括驾车、步行、骑行、公交、货车等多种出行方式
  */
-const ExpoGaodeMapNavigationModule = requireNativeModule('ExpoGaodeMapNavigation');
-export default ExpoGaodeMapNavigationModule;
+let nativeModuleCache = null;
+function getNativeModule() {
+    if (!nativeModuleCache) {
+        nativeModuleCache = requireNativeModule('ExpoGaodeMapNavigation');
+    }
+    return nativeModuleCache;
+}
+export default new Proxy({}, {
+    get(_target, prop) {
+        return Reflect.get(getNativeModule(), prop);
+    },
+});
 //# sourceMappingURL=ExpoGaodeMapNavigationModule.js.map

package/build/ExpoGaodeMapNavigationModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapNavigationModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapNavigationModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,MAAM,4BAA4B,GAAG,mBAAmB,CAAmC,wBAAwB,CAAC,CAAC;AAErH,eAAe,4BAA4B,CAAC","sourcesContent":["\nimport { requireNativeModule } from 'expo-modules-core';\nimport { ExpoGaodeMapNavigationModule as ExpoGaodeMapNavigationModuleType } from './types/native-module.types';\n/**\n * 高德地图导航模块\n * \n * 提供路径规划功能，包括驾车、步行、骑行、公交、货车等多种出行方式\n */\nconst ExpoGaodeMapNavigationModule = requireNativeModule<ExpoGaodeMapNavigationModuleType>('ExpoGaodeMapNavigation');\n\nexport default ExpoGaodeMapNavigationModule;"]}
+{"version":3,"file":"ExpoGaodeMapNavigationModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapNavigationModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,IAAI,iBAAiB,GAA4C,IAAI,CAAC;AAEtE,SAAS,eAAe;IACtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,mBAAmB,CAAmC,wBAAwB,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,eAAe,IAAI,KAAK,CAAC,EAAsC,EAAE;IAC/D,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAY,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;CACF,CAAC,CAAC","sourcesContent":["\nimport { requireNativeModule } from 'expo-modules-core';\nimport { ExpoGaodeMapNavigationModule as ExpoGaodeMapNavigationModuleType } from './types/native-module.types';\n/**\n * 高德地图导航模块\n * \n * 提供路径规划功能，包括驾车、步行、骑行、公交、货车等多种出行方式\n */\nlet nativeModuleCache: ExpoGaodeMapNavigationModuleType | null = null;\n\nfunction getNativeModule(): ExpoGaodeMapNavigationModuleType {\n  if (!nativeModuleCache) {\n    nativeModuleCache = requireNativeModule<ExpoGaodeMapNavigationModuleType>('ExpoGaodeMapNavigation');\n  }\n  return nativeModuleCache;\n}\n\nexport default new Proxy({} as ExpoGaodeMapNavigationModuleType, {\n  get(_target, prop) {\n    return Reflect.get(getNativeModule() as object, prop);\n  },\n});\n"]}

package/build/map/ExpoGaodeMapModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../../src/map/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAoB,MAAM,sBAAsB,CAAC;AAqpBnE;;EAEE;AACF,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAE/C;AAED;;EAEE;AACF,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;wBAE0D,kBAAkB;AAA7E,wBAA8E"}
+{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../../src/map/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAiB,SAAS,EAAoB,MAAM,sBAAsB,CAAC;AAixBlF;;EAEE;AACF,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAE/C;AA4BD;;EAEE;AACF,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;wBAE0D,kBAAkB;AAA7E,wBAA8E"}

package/build/map/ExpoGaodeMapModule.js

@@ -2,30 +2,84 @@ import { requireNativeModule } from 'expo';
 import { Platform } from 'react-native';
 import { ErrorHandler, ErrorLogger } from './utils/ErrorHandler';
 import { normalizeLatLng, normalizeLatLngList } from './utils/GeoUtils';
-// 获取原生模块实例 - 添加容错处理
-let nativeModule = null;
-try {
-    nativeModule = requireNativeModule('ExpoGaodeMap');
-}
-catch (error) {
-    console.error('Failed to load ExpoGaodeMap native module:', error);
-    const moduleError = ErrorHandler.nativeModuleUnavailable();
-    ErrorLogger.log(moduleError);
+let nativeModuleCache = null;
+function getNativeModule(optional = false) {
+    if (nativeModuleCache) {
+        return nativeModuleCache;
+    }
+    try {
+        nativeModuleCache = requireNativeModule('ExpoGaodeMap');
+        return nativeModuleCache;
+    }
+    catch (error) {
+        if (optional) {
+            return null;
+        }
+        const moduleError = ErrorHandler.nativeModuleUnavailable();
+        ErrorLogger.log(moduleError);
+        throw moduleError;
+    }
 }
+const nativeModule = new Proxy({}, {
+    get(_target, prop) {
+        const module = getNativeModule(true);
+        return module ? Reflect.get(module, prop) : undefined;
+    },
+});
 // 记录最近一次 initSDK 的配置（含 webKey）
 let _sdkConfig = null;
 let _isSDKInitialized = false;
+const privacySensitiveMethodNames = new Set([
+    'start',
+    'stop',
+    'isStarted',
+    'getCurrentLocation',
+    'coordinateConvert',
+    'setLocatingWithReGeocode',
+    'setLocationMode',
+    'setInterval',
+    'setOnceLocation',
+    'setSensorEnable',
+    'setWifiScan',
+    'setGpsFirst',
+    'setOnceLocationLatest',
+    'setGeoLanguage',
+    'setLocationCacheEnable',
+    'setHttpTimeOut',
+    'setDesiredAccuracy',
+    'setLocationTimeout',
+    'setReGeocodeTimeout',
+    'setDistanceFilter',
+    'setPausesLocationUpdatesAutomatically',
+    'setAllowsBackgroundLocationUpdates',
+    'setLocationProtocol',
+    'startUpdatingHeading',
+    'stopUpdatingHeading',
+    'checkLocationPermission',
+    'requestLocationPermission',
+    'requestBackgroundLocationPermission',
+    'addLocationListener',
+]);
+function assertPrivacyReady(scene = 'sdk') {
+    const nativeModule = getNativeModule();
+    if (!nativeModule) {
+        throw ErrorHandler.nativeModuleUnavailable();
+    }
+    const status = nativeModule.getPrivacyStatus();
+    if (!status.isReady) {
+        throw ErrorHandler.privacyNotAgreed(scene);
+    }
+}
 // 扩展原生模块，添加便捷方法
-const ExpoGaodeMapModuleWithHelpers = {
-    ...(nativeModule || {}),
+const helperMethods = {
     /**
      * 初始化 SDK，并缓存配置（包含 webKey）
      * 注意：允许不提供任何 API Key，因为原生端可能已通过 Config Plugin 配置
      */
     initSDK(config) {
-        if (!nativeModule) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
             throw ErrorHandler.nativeModuleUnavailable();
-        }
         try {
             // 检查是否有任何 key 被提供
             const hasJSKeys = !!(config.androidKey || config.iosKey);
@@ -54,19 +108,53 @@ const ExpoGaodeMapModuleWithHelpers = {
     isSDKInitialized() {
         return _isSDKInitialized;
     },
+    setPrivacyShow(hasShow, hasContainsPrivacy) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.setPrivacyShow(hasShow, hasContainsPrivacy);
+    },
+    setPrivacyAgree(hasAgree) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.setPrivacyAgree(hasAgree);
+    },
+    setPrivacyConfig(config) {
+        const nativeModule = getNativeModule();
+        if (!nativeModule)
+            throw ErrorHandler.nativeModuleUnavailable();
+        nativeModule.setPrivacyShow(config.hasShow, config.hasContainsPrivacy);
+        nativeModule.setPrivacyAgree(config.hasAgree);
+    },
+    getPrivacyStatus() {
+        const nativeModule = getNativeModule();
+        if (!nativeModule) {
+            return {
+                hasShow: false,
+                hasContainsPrivacy: false,
+                hasAgree: false,
+                isReady: false,
+            };
+        }
+        return nativeModule.getPrivacyStatus();
+    },
     calculateDistanceBetweenPoints(p1, p2) {
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         return nativeModule.distanceBetweenCoordinates(normalizeLatLng(p1), normalizeLatLng(p2));
     },
     calculateDistance(lat1, lon1, lat2, lon2) {
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
         return nativeModule.distanceBetweenCoordinates({ latitude: lat1, longitude: lon1 }, { latitude: lat2, longitude: lon2 });
     },
     setLoadWorldVectorMap(enabled) {
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -77,6 +165,7 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     getVersion() {
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return '0.0.0';
         try {
@@ -88,6 +177,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     start() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -98,6 +189,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     stop() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -108,6 +201,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     isStarted() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return Promise.resolve(false);
         try {
@@ -119,6 +214,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     async getCurrentLocation() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -130,6 +227,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     async coordinateConvert(coordinate, type) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -141,6 +240,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     setLocatingWithReGeocode(isReGeocode) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return;
         try {
@@ -151,6 +252,7 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     get isBackgroundLocationEnabled() {
+        const nativeModule = getNativeModule(true);
         if (!nativeModule)
             return false;
         return nativeModule.isBackgroundLocationEnabled === true;
@@ -159,6 +261,8 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 检查位置权限状态
      */
     async checkLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -173,6 +277,8 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 请求前台位置权限（增强版）
      */
     async requestLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -192,6 +298,8 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 注意：必须在前台权限已授予后才能请求
      */
     async requestBackgroundLocationPermission() {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -211,6 +319,7 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 引导用户手动授予权限
      */
     openAppSettings() {
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -222,6 +331,8 @@ const ExpoGaodeMapModuleWithHelpers = {
         }
     },
     setAllowsBackgroundLocationUpdates(allows) {
+        assertPrivacyReady('sdk');
+        const nativeModule = getNativeModule();
         if (!nativeModule) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
@@ -256,13 +367,18 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 注意：如果使用 Config Plugin 配置了 API Key，无需调用 initSDK()
      */
     addLocationListener(listener) {
-        if (!nativeModule) {
+        assertPrivacyReady('sdk');
+        const module = getNativeModule();
+        if (!module) {
             throw ErrorHandler.nativeModuleUnavailable();
         }
-        if (!nativeModule?.addListener) {
+        if (!module.addListener) {
             ErrorLogger.warn('Native module does not support events');
+            return {
+                remove: () => { },
+            };
         }
-        return nativeModule?.addListener?.('onLocationUpdate', listener) || {
+        return module.addListener('onLocationUpdate', listener) || {
             remove: () => { },
         };
     },
@@ -617,6 +733,28 @@ const ExpoGaodeMapModuleWithHelpers = {
 export function getSDKConfig() {
     return _sdkConfig;
 }
+;
+const ExpoGaodeMapModuleWithHelpers = new Proxy(helperMethods, {
+    get(target, prop, receiver) {
+        if (Reflect.has(target, prop)) {
+            return Reflect.get(target, prop, receiver);
+        }
+        const nativeModule = getNativeModule(true);
+        if (!nativeModule) {
+            return undefined;
+        }
+        const value = Reflect.get(nativeModule, prop);
+        if (typeof prop === 'string' &&
+            privacySensitiveMethodNames.has(prop) &&
+            typeof value === 'function') {
+            return (...args) => {
+                assertPrivacyReady('sdk');
+                return value.apply(nativeModule, args);
+            };
+        }
+        return value;
+    },
+});
 /**
 * 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）
 */