expo-gaode-map 2.2.11-next.0 → 2.2.11-next.1

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'expo.modules.gaodemap'
-version = '0.1.0'
+version = '2.2.11'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -35,7 +35,7 @@ android {
   namespace "expo.modules.gaodemap"
   defaultConfig {
     versionCode 1
-    versionName "0.1.0"
+    versionName "2.2.11"
   }
   lintOptions {
     abortOnError false

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

@@ -341,6 +341,7 @@ class ExpoGaodeMapModule : Module() {
 
       promise.resolve(mapOf(
         "granted" to foregroundStatus.granted,
+        "status" to if (foregroundStatus.granted) "granted" else if (foregroundStatus.isPermanentlyDenied) "denied" else "notDetermined",
         "fineLocation" to foregroundStatus.fineLocation,
         "coarseLocation" to foregroundStatus.coarseLocation,
         "backgroundLocation" to backgroundStatus.backgroundLocation,
@@ -386,6 +387,7 @@ class ExpoGaodeMapModule : Module() {
             handler.removeCallbacks(this)
             promise.resolve(mapOf(
               "granted" to status.granted,
+              "status" to if (status.granted) "granted" else if (status.isPermanentlyDenied) "denied" else "notDetermined",
               "fineLocation" to status.fineLocation,
               "coarseLocation" to status.coarseLocation,
               "shouldShowRationale" to status.shouldShowRationale,
@@ -455,6 +457,7 @@ class ExpoGaodeMapModule : Module() {
             handler.removeCallbacks(this)
             promise.resolve(mapOf(
               "granted" to status.granted,
+              "status" to if (status.granted) "granted" else if (status.isPermanentlyDenied) "denied" else "notDetermined",
               "backgroundLocation" to status.backgroundLocation,
               "shouldShowRationale" to status.shouldShowRationale,
               "isPermanentlyDenied" to status.isPermanentlyDenied
@@ -575,7 +578,7 @@ class ExpoGaodeMapModule : Module() {
      */
     AsyncFunction("calculatePolygonArea") { polygon: List<Map<String, Double>>, promise: expo.modules.kotlin.Promise ->
       try {
-        android.util.Log.d("ExpoGaodeMap", "📐 calculatePolygonArea 被调用，参数: $polygon")
+        
         
         if (polygon.size < 3) {
           return@AsyncFunction promise.reject("INVALID_ARGUMENT", "Polygon must have at least 3 vertices", null)
@@ -591,7 +594,7 @@ class ExpoGaodeMapModule : Module() {
           }
         }
 
-        android.util.Log.d("ExpoGaodeMap", "📐 转换后的坐标数: ${polygonPoints.size}")
+     
         
         if (polygonPoints.size < 3) {
           return@AsyncFunction promise.reject("INVALID_ARGUMENT", "Invalid polygon coordinates", null)
@@ -599,7 +602,7 @@ class ExpoGaodeMapModule : Module() {
 
         // 使用高德官方 API 计算多边形面积
         val area = AMapUtils.calculateArea(polygonPoints)
-        android.util.Log.d("ExpoGaodeMap", "📐 AMapUtils.calculateArea 结果: $area")
+       
         promise.resolve(area)
       } catch (e: Exception) {
         android.util.Log.e("ExpoGaodeMap", "📐 calculatePolygonArea 错误: ${e.message}", e)
@@ -615,7 +618,6 @@ class ExpoGaodeMapModule : Module() {
      */
     AsyncFunction("calculateRectangleArea") { southWest: Map<String, Double>, northEast: Map<String, Double>, promise: expo.modules.kotlin.Promise ->
       try {
-        android.util.Log.d("ExpoGaodeMap", "📐 calculateRectangleArea 被调用，参数: sw=$southWest, ne=$northEast")
         
         val swLat = southWest["latitude"] ?: return@AsyncFunction promise.reject("INVALID_ARGUMENT", "Invalid southWest latitude", null)
         val swLon = southWest["longitude"] ?: return@AsyncFunction promise.reject("INVALID_ARGUMENT", "Invalid southWest longitude", null)
@@ -631,7 +633,7 @@ class ExpoGaodeMapModule : Module() {
         )
 
         val area = AMapUtils.calculateArea(rectangle)
-        android.util.Log.d("ExpoGaodeMap", "📐 calculateRectangleArea 结果: $area")
+        
         promise.resolve(area)
       } catch (e: Exception) {
         android.util.Log.e("ExpoGaodeMap", "📐 calculateRectangleArea 错误: ${e.message}", e)

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

@@ -13,7 +13,7 @@ class ExpoGaodeMapViewModule : Module() {
     View(ExpoGaodeMapView::class) {
       Events("onMapPress", "onMapLongPress", "onLoad", "onLocation", "onCameraMove", "onCameraIdle")
       
-      // ✅ 关键修复：拦截 React Native 的视图操作异常
+
       
       // 延迟销毁地图，避免页面退出动画未完成时地图就变成白屏
       OnViewDestroys { view: ExpoGaodeMapView ->

package/android/src/main/java/expo/modules/gaodemap/utils/PermissionHelper.kt

@@ -40,6 +40,7 @@ object PermissionHelper {
         val fineLocation: Boolean = false,
         val coarseLocation: Boolean = false,
         val backgroundLocation: Boolean = false
+
     )
     
     /**

package/build/index.d.ts

@@ -14,6 +14,16 @@ export { FoldableMapView, useFoldableMap, } from './components/FoldableMapView';
 export type { FoldableMapViewProps, FoldableConfig, } from './components/FoldableMapView';
 export { default as ExpoGaodeMapOfflineModule } from './utils/OfflineMapManager';
 export type { OfflineMapInfo, OfflineMapStatus, OfflineMapDownloadConfig, OfflineMapDownloadEvent, OfflineMapCompleteEvent, OfflineMapErrorEvent, OfflineMapPausedEvent, OfflineMapCancelledEvent, OfflineMapStorageInfo, OfflineMapEvents, } from './types/offline.types';
+/**
+ * Check or request permissions to access the location.
+ * This uses both `requestPermissionsAsync` and `getPermissionsAsync` to interact with the permissions.
+ *
+ * @example
+ * ```ts
+ * const [status, requestPermission] = useLocationPermissions();
+ * ```
+ */
+export declare const useLocationPermissions: (options?: import("expo-modules-core").PermissionHookOptions<object> | undefined) => [import("./types").PermissionStatus | null, () => Promise<import("./types").PermissionStatus>, () => Promise<import("./types").PermissionStatus>];
 export { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';
 export { default } from './ExpoGaodeMapModule';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -1,3 +1,5 @@
+import { createPermissionHook } from 'expo-modules-core';
+import ExpoGaodeMapModuleWithHelpers from './ExpoGaodeMapModule';
 // 导出类型定义（包含所有通用类型）
 export * from './types';
 // 导出原生模块
@@ -19,6 +21,21 @@ LocationPermissionType, } from './utils/PermissionUtils';
 export { FoldableMapView, useFoldableMap, } from './components/FoldableMapView';
 // 导出离线地图 API
 export { default as ExpoGaodeMapOfflineModule } from './utils/OfflineMapManager';
+const requestPermissionsAsync = ExpoGaodeMapModuleWithHelpers.requestLocationPermission;
+const getPermissionsAsync = ExpoGaodeMapModuleWithHelpers.checkLocationPermission;
+/**
+ * Check or request permissions to access the location.
+ * This uses both `requestPermissionsAsync` and `getPermissionsAsync` to interact with the permissions.
+ *
+ * @example
+ * ```ts
+ * const [status, requestPermission] = useLocationPermissions();
+ * ```
+ */
+export const useLocationPermissions = createPermissionHook({
+    getMethod: getPermissionsAsync,
+    requestMethod: requestPermissionsAsync,
+});
 // 导出便捷读取的 SDK 配置与 webKey
 export { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';
 // 默认导出原生模块

package/build/index.js.map

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

package/build/types/common.types.d.ts

@@ -2,6 +2,7 @@
  * 高德地图通用类型定义
  * 基于 Expo Modules API
  */
+import { PermissionResponse } from 'expo-modules-core';
 /**
  * SDK 配置参数
  */
@@ -16,11 +17,9 @@ export interface SDKConfig {
 /**
  * 权限状态（增强版，支持 Android 14+ 和 iOS 17+）
  */
-export interface PermissionStatus {
+export interface PermissionStatus extends PermissionResponse {
     /** 是否已授权（前台位置权限） */
     granted: boolean;
-    /** iOS 权限状态字符串 */
-    status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';
     /** Android 精确位置权限 */
     fineLocation?: boolean;
     /** Android 粗略位置权限 */

package/build/types/common.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IAGjB,kBAAkB;IAClB,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAG5G,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,oBAAY,OAAO;IACjB;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,IAAI,IAAI;IAER;;;OAGG;IACH,GAAG,IAAI;CACR;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IAGjB,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,oBAAY,OAAO;IACjB;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,IAAI,IAAI;IAER;;;OAGG;IACH,GAAG,IAAI;CACR;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/build/types/common.types.js

@@ -1,7 +1,3 @@
-/**
- * 高德地图通用类型定义
- * 基于 Expo Modules API
- */
 /**
  * 地图类型
  */

package/build/types/common.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgIH;;GAEG;AACH,MAAM,CAAN,IAAY,OA0BX;AA1BD,WAAY,OAAO;IACjB;;OAEG;IACH,6CAAY,CAAA;IAEZ;;OAEG;IACH,+CAAa,CAAA;IAEb;;OAEG;IACH,uCAAS,CAAA;IAET;;OAEG;IACH,qCAAQ,CAAA;IAER;;;OAGG;IACH,mCAAO,CAAA;AACT,CAAC,EA1BW,OAAO,KAAP,OAAO,QA0BlB","sourcesContent":["/**\n * 高德地图通用类型定义\n * 基于 Expo Modules API\n */\n\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 */\nexport interface Point {\n  x: number;\n  y: number;\n}\n\n/**\n * 地理坐标\n */\nexport interface LatLng {\n  /**\n   * 纬度\n   */\n  latitude: number;\n\n  /**\n   * 经度\n   */\n  longitude: number;\n}\n\n/**\n * 地图标注点（POI）\n */\nexport interface MapPoi {\n  /**\n   * 标注点 ID\n   */\n  id: string;\n\n  /**\n   * 标注点名称\n   */\n  name: string;\n\n  /**\n   * 标注点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 矩形坐标边界\n */\nexport interface LatLngBounds {\n  /**\n   * 西南坐标\n   */\n  southwest: LatLng;\n\n  /**\n   * 东北坐标\n   */\n  northeast: LatLng;\n}\n\n/**\n * 地图相机位置\n */\nexport interface CameraPosition {\n  /**\n   * 中心坐标\n   */\n  target?: LatLng;\n\n  /**\n   * 缩放级别（3-20）\n   */\n  zoom?: number;\n\n  /**\n   * 朝向、旋转角度（0-360度）\n   */\n  bearing?: number;\n\n  /**\n   * 倾斜角度（0-60度）\n   */\n  tilt?: number;\n}\n\n/**\n * 地图类型\n */\nexport enum MapType {\n  /**\n   * 标准地图\n   */\n  Standard = 0,\n\n  /**\n   * 卫星地图\n   */\n  Satellite = 1,\n\n  /**\n   * 夜间地图\n   */\n  Night = 2,\n\n  /**\n   * 导航地图\n   */\n  Navi = 3,\n\n  /**\n   * 公交地图\n   * @platform android\n   */\n  Bus = 4,\n}\n\n/**\n * 颜色值类型\n * 支持：\n * - 十六进制字符串: '#AARRGGBB' 或 '#RRGGBB'\n * - 数字格式: 0xAARRGGBB (用于 Android)\n */\nexport type ColorValue = string | number;\n\n"]}
+{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AA+HA;;GAEG;AACH,MAAM,CAAN,IAAY,OA0BX;AA1BD,WAAY,OAAO;IACjB;;OAEG;IACH,6CAAY,CAAA;IAEZ;;OAEG;IACH,+CAAa,CAAA;IAEb;;OAEG;IACH,uCAAS,CAAA;IAET;;OAEG;IACH,qCAAQ,CAAA;IAER;;;OAGG;IACH,mCAAO,CAAA;AACT,CAAC,EA1BW,OAAO,KAAP,OAAO,QA0BlB","sourcesContent":["/**\n * 高德地图通用类型定义\n * 基于 Expo Modules API\n */\nimport { PermissionResponse } from 'expo-modules-core';\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 extends PermissionResponse{\n  /** 是否已授权（前台位置权限） */\n  granted: boolean;\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 */\nexport interface Point {\n  x: number;\n  y: number;\n}\n\n/**\n * 地理坐标\n */\nexport interface LatLng {\n  /**\n   * 纬度\n   */\n  latitude: number;\n\n  /**\n   * 经度\n   */\n  longitude: number;\n}\n\n/**\n * 地图标注点（POI）\n */\nexport interface MapPoi {\n  /**\n   * 标注点 ID\n   */\n  id: string;\n\n  /**\n   * 标注点名称\n   */\n  name: string;\n\n  /**\n   * 标注点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 矩形坐标边界\n */\nexport interface LatLngBounds {\n  /**\n   * 西南坐标\n   */\n  southwest: LatLng;\n\n  /**\n   * 东北坐标\n   */\n  northeast: LatLng;\n}\n\n/**\n * 地图相机位置\n */\nexport interface CameraPosition {\n  /**\n   * 中心坐标\n   */\n  target?: LatLng;\n\n  /**\n   * 缩放级别（3-20）\n   */\n  zoom?: number;\n\n  /**\n   * 朝向、旋转角度（0-360度）\n   */\n  bearing?: number;\n\n  /**\n   * 倾斜角度（0-60度）\n   */\n  tilt?: number;\n}\n\n/**\n * 地图类型\n */\nexport enum MapType {\n  /**\n   * 标准地图\n   */\n  Standard = 0,\n\n  /**\n   * 卫星地图\n   */\n  Satellite = 1,\n\n  /**\n   * 夜间地图\n   */\n  Night = 2,\n\n  /**\n   * 导航地图\n   */\n  Navi = 3,\n\n  /**\n   * 公交地图\n   * @platform android\n   */\n  Bus = 4,\n}\n\n/**\n * 颜色值类型\n * 支持：\n * - 十六进制字符串: '#AARRGGBB' 或 '#RRGGBB'\n * - 数字格式: 0xAARRGGBB (用于 Android)\n */\nexport type ColorValue = string | number;\n"]}

package/build/utils/ErrorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,eAAe;IACf,mBAAmB,wBAAwB;IAC3C,mBAAmB;IACnB,eAAe,oBAAoB;IACnC,YAAY;IACZ,iBAAiB,sBAAsB;IACvC,WAAW;IACX,eAAe,oBAAoB;IACnC,cAAc;IACd,yBAAyB,8BAA8B;IACvD,eAAe;IACf,wBAAwB,6BAA6B;IACrD,WAAW;IACX,iBAAiB,sBAAsB;IACvC,WAAW;IACX,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAEV,OAAO,EAAE,YAAY;CAqBlC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4C;IAErE;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,aAAa;IAwBzC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,aAAa;IA+CzE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,UAAU,GAAG,aAAa;IAiDlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IA0BrD;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,aAAa;IA+B/C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAqC/D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,aAAa;IAgB1F;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,aAAa;IAmBzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;CAkDnE;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAW;IAEnC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO;IAIlC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa;IAU/B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAK3C"}
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,eAAe;IACf,mBAAmB,wBAAwB;IAC3C,mBAAmB;IACnB,eAAe,oBAAoB;IACnC,YAAY;IACZ,iBAAiB,sBAAsB;IACvC,WAAW;IACX,eAAe,oBAAoB;IACnC,cAAc;IACd,yBAAyB,8BAA8B;IACvD,eAAe;IACf,wBAAwB,6BAA6B;IACrD,WAAW;IACX,iBAAiB,sBAAsB;IACvC,WAAW;IACX,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAEV,OAAO,EAAE,YAAY;CAqBlC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4C;IAErE;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,aAAa;IAwBzC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,aAAa;IA+CzE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,UAAU,GAAG,aAAa;IAiDlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IA0BrD;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,aAAa;IA+B/C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAqC/D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,aAAa;IAgB1F;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,aAAa;IAmBzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;CAkDnE;AAED;;GAEG;AACH,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAmD;IAE3E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO;IAIlC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa;IAU/B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAK3C"}

package/build/utils/ErrorHandler.js

@@ -224,7 +224,7 @@ ExpoGaodeMapModule.setDesiredAccuracy(0); // 最佳精度`,
 1️⃣  确认已正确安装：
 npm install expo-gaode-map
 # 或
-pnpm install expo-gaode-map
+bun install expo-gaode-map
 
 2️⃣  重新构建原生代码：
 npx expo prebuild --clean
@@ -368,7 +368,8 @@ const App = () => {
  * 错误日志工具
  */
 export class ErrorLogger {
-    static isEnabled = __DEV__;
+    // 兼容不同环境：Bun/Jest/Node
+    static isEnabled = typeof __DEV__ !== 'undefined' ? __DEV__ : true;
     /**
      * 启用/禁用错误日志
      */

package/build/utils/ErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 高德地图错误处理工具\n * 提供友好的错误提示和解决方案指引\n */\n\n/**\n * 错误类型枚举\n */\nexport enum ErrorType {\n  /** SDK 未初始化 */\n  SDK_NOT_INITIALIZED = 'SDK_NOT_INITIALIZED',\n  /** API Key 配置错误 */\n  INVALID_API_KEY = 'INVALID_API_KEY',\n  /** 权限未授予 */\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  /** 定位失败 */\n  LOCATION_FAILED = 'LOCATION_FAILED',\n  /** 原生模块不可用 */\n  NATIVE_MODULE_UNAVAILABLE = 'NATIVE_MODULE_UNAVAILABLE',\n  /** 地图视图未初始化 */\n  MAP_VIEW_NOT_INITIALIZED = 'MAP_VIEW_NOT_INITIALIZED',\n  /** 参数错误 */\n  INVALID_PARAMETER = 'INVALID_PARAMETER',\n  /** 网络错误 */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n}\n\n/**\n * 错误详情接口\n */\nexport interface ErrorDetails {\n  /** 错误类型 */\n  type: ErrorType;\n  /** 错误消息 */\n  message: string;\n  /** 解决方案 */\n  solution: string;\n  /** 文档链接 */\n  docUrl?: string;\n  /** 原始错误 */\n  originalError?: Error;\n}\n\n/**\n * 自定义错误类\n */\nexport class GaodeMapError extends Error {\n  type: ErrorType;\n  solution: string;\n  docUrl?: string;\n  originalError?: Error;\n\n  constructor(details: ErrorDetails) {\n    const fullMessage = `\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n🗺️  高德地图错误 [${details.type}]\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n❌ 错误信息：\n   ${details.message}\n\n💡 解决方案：\n   ${details.solution}\n\n${details.docUrl ? `📖 详细文档：\\n   ${details.docUrl}\\n` : ''}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;\n    super(fullMessage);\n    this.name = 'GaodeMapError';\n    this.type = details.type;\n    this.solution = details.solution;\n    this.docUrl = details.docUrl;\n    this.originalError = details.originalError;\n  }\n}\n\n/**\n * 错误处理器类\n */\nexport class ErrorHandler {\n  private static docBaseUrl = 'https://TomWq.github.io/expo-gaode-map';\n\n  /**\n   * SDK 未初始化错误\n   */\n  static sdkNotInitialized(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.SDK_NOT_INITIALIZED,\n      message: '高德地图 SDK 尚未初始化',\n      solution: `请在使用地图功能前先调用 initSDK()：\n\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nuseEffect(() => {\n  // 在组件挂载时初始化\n  ExpoGaodeMapModule.initSDK({\n    androidKey: 'your-android-key',\n    iosKey: 'your-ios-key',\n  });\n}, []);\n\n⚠️  常见原因：\n1. 忘记调用 initSDK() 就使用了定位或地图功能\n2. initSDK() 调用时机过晚（应在 useEffect 中尽早调用）\n3. 使用 Config Plugin 但未重新构建原生代码`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * API Key 配置错误\n   */\n  static invalidApiKey(platform: 'android' | 'ios' | 'both'): GaodeMapError {\n    const platformText = {\n      android: 'Android',\n      ios: 'iOS',\n      both: 'Android 和 iOS',\n    }[platform];\n\n    return new GaodeMapError({\n      type: ErrorType.INVALID_API_KEY,\n      message: `${platformText} API Key 配置错误或未配置`,\n      solution: `请检查以下步骤：\n\n1️⃣  获取 API Key：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 注册并创建应用\n   • 获取对应平台的 API Key\n\n2️⃣  配置 API Key（推荐使用 Config Plugin）：\n\n在 app.json 中配置：\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"expo-gaode-map\",\n        {\n          \"androidKey\": \"your-android-key\",\n          \"iosKey\": \"your-ios-key\"\n        }\n      ]\n    ]\n  }\n}\n\n然后重新构建：\nnpx expo prebuild --clean\nnpx expo run:${platform === 'ios' ? 'ios' : 'android'}\n\n3️⃣  或在代码中配置：\nExpoGaodeMapModule.initSDK({\n  androidKey: 'your-android-key',\n  iosKey: 'your-ios-key',\n});`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * 权限未授予错误\n   */\n  static permissionDenied(permissionType: 'location'): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.PERMISSION_DENIED,\n      message: '定位权限未授予，无法使用定位功能',\n      solution: `请按以下步骤授予权限：\n\n1️⃣  请求权限：\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nconst checkPermission = async () => {\n  // 检查权限状态\n  const status = await ExpoGaodeMapModule.checkLocationPermission();\n  \n  if (!status.granted) {\n    // 请求权限\n    const result = await ExpoGaodeMapModule.requestLocationPermission();\n    \n    if (!result.granted) {\n      // 用户拒绝授权，引导用户去设置\n      Alert.alert(\n        '需要定位权限',\n        '请在设置中开启定位权限以使用地图功能',\n        [\n          { text: '取消', style: 'cancel' },\n          { text: '去设置', onPress: () => Linking.openSettings() }\n        ]\n      );\n    }\n  }\n};\n\n2️⃣  iOS 配置（在 app.json 中）：\n{\n  \"expo\": {\n    \"ios\": {\n      \"infoPlist\": {\n        \"NSLocationWhenInUseUsageDescription\": \"需要获取您的位置信息以显示地图\",\n        \"NSLocationAlwaysAndWhenInUseUsageDescription\": \"需要获取您的位置信息\"\n      }\n    }\n  }\n}\n\n3️⃣  Android 配置（Config Plugin 会自动添加）：\n使用 expo-gaode-map 的 Config Plugin 会自动添加必要的权限声明`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html#权限配置`,\n    });\n  }\n\n  /**\n   * 定位失败错误\n   */\n  static locationFailed(reason?: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.LOCATION_FAILED,\n      message: `定位失败${reason ? `：${reason}` : ''}`,\n      solution: `请检查以下问题：\n\n1️⃣  设备 GPS 是否开启\n2️⃣  网络连接是否正常\n3️⃣  定位权限是否已授予\n4️⃣  是否在室内或信号较弱的地方\n\n💡 解决方法：\n// 配置定位参数\nExpoGaodeMapModule.setLocationTimeout(30); // 增加超时时间\nExpoGaodeMapModule.setInterval(2000); // 设置定位间隔\n\n// Android 特有配置\nExpoGaodeMapModule.setLocationMode(2); // 高精度模式\nExpoGaodeMapModule.setGpsFirst(true);  // GPS 优先\n\n// iOS 特有配置\nExpoGaodeMapModule.setDesiredAccuracy(0); // 最佳精度`,\n      docUrl: `${this.docBaseUrl}/api/location.html`,\n    });\n  }\n\n  /**\n   * 原生模块不可用错误\n   */\n  static nativeModuleUnavailable(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NATIVE_MODULE_UNAVAILABLE,\n      message: 'expo-gaode-map 原生模块不可用',\n      solution: `请检查以下步骤：\n\n1️⃣  确认已正确安装：\nnpm install expo-gaode-map\n# 或\npnpm install expo-gaode-map\n\n2️⃣  重新构建原生代码：\nnpx expo prebuild --clean\nnpx expo run:android\nnpx expo run:ios\n\n3️⃣  检查 Expo 版本兼容性：\n• expo-gaode-map 需要 Expo SDK 49+\n• 不支持 Expo Go，必须使用 Development Build\n\n4️⃣  检查是否与其他包冲突：\n• 不能同时安装 expo-gaode-map 和 expo-gaode-map-navigation\n• 两个包选择其一使用\n\n5️⃣  清理缓存后重试：\ncd android && ./gradlew clean && cd ..\ncd ios && pod deintegrate && pod install && cd ..`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html`,\n    });\n  }\n\n  /**\n   * 地图视图未初始化错误\n   */\n  static mapViewNotInitialized(methodName: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.MAP_VIEW_NOT_INITIALIZED,\n      message: `无法调用 ${methodName}：地图视图尚未初始化`,\n      solution: `请确保：\n\n1️⃣  MapView 已经渲染完成\n2️⃣  使用 ref 获取地图实例后再调用方法\n\n正确用法：\nimport { MapView, MapViewRef } from 'expo-gaode-map';\n\nconst App = () => {\n  const mapRef = useRef<MapViewRef>(null);\n  \n  // ❌ 错误：在渲染前调用\n  // mapRef.current?.moveCamera(...);\n  \n  // ✅ 正确：等待地图加载完成\n  const handleMapReady = () => {\n    mapRef.current?.moveCamera({\n      target: { latitude: 39.9, longitude: 116.4 },\n      zoom: 15,\n    });\n  };\n  \n  return (\n    <MapView\n      ref={mapRef}\n      onMapReady={handleMapReady}\n    />\n  );\n};`,\n      docUrl: `${this.docBaseUrl}/api/mapview.html`,\n    });\n  }\n\n  /**\n   * 参数错误\n   */\n  static invalidParameter(paramName: string, expected: string, received: any): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `参数 \"${paramName}\" 类型错误`,\n      solution: `期望类型：${expected}\n实际接收：${typeof received} (${JSON.stringify(received)})\n\n请检查传入的参数是否符合要求。\n\n💡 提示：\n• 使用 TypeScript 可以在编译时发现类型错误\n• 参考 API 文档了解正确的参数类型`,\n      docUrl: `${this.docBaseUrl}/api/`,\n    });\n  }\n\n  /**\n   * 网络错误\n   */\n  static networkError(originalError?: Error): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NETWORK_ERROR,\n      message: '网络请求失败',\n      solution: `请检查：\n\n1️⃣  网络连接是否正常\n2️⃣  API Key 是否有效\n3️⃣  是否超出配额限制\n\n💡 如果问题持续，请：\n• 检查高德开放平台控制台\n• 查看 API 调用量和配额\n• 确认 Key 的服务是否已开通`,\n      docUrl: `${this.docBaseUrl}/guide/troubleshooting.html`,\n      originalError,\n    });\n  }\n\n  /**\n   * 包装原生错误，提供更友好的提示\n   */\n  static wrapNativeError(error: any, context: string): GaodeMapError {\n    const errorMessage = error?.message || String(error);\n    \n    // SDK 未初始化相关错误\n    if (\n      errorMessage.includes('not initialized') ||\n      errorMessage.includes('未初始化') ||\n      errorMessage.includes('SDK未设置')\n    ) {\n      return this.sdkNotInitialized();\n    }\n    \n    // API Key 相关错误\n    if (\n      errorMessage.includes('key') ||\n      errorMessage.includes('invalid') ||\n      errorMessage.includes('鉴权失败')\n    ) {\n      return this.invalidApiKey('both');\n    }\n    \n    // 权限相关错误\n    if (\n      errorMessage.includes('permission') ||\n      errorMessage.includes('权限')\n    ) {\n      return this.permissionDenied('location');\n    }\n    \n    // 定位相关错误\n    if (\n      errorMessage.includes('location') ||\n      errorMessage.includes('定位')\n    ) {\n      return this.locationFailed(errorMessage);\n    }\n    \n    // 通用错误\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `${context} 失败`,\n      solution: `原始错误信息：${errorMessage}\n\n如果问题持续，请：\n1. 查看完整的错误堆栈\n2. 检查 API 调用参数\n3. 提交 Issue：https://github.com/TomWq/expo-gaode-map/issues`,\n      originalError: error instanceof Error ? error : undefined,\n    });\n  }\n}\n\n/**\n * 错误日志工具\n */\nexport class ErrorLogger {\n  private static isEnabled = __DEV__;\n\n  /**\n   * 启用/禁用错误日志\n   */\n  static setEnabled(enabled: boolean) {\n    this.isEnabled = enabled;\n  }\n\n  /**\n   * 记录错误\n   */\n  static log(error: GaodeMapError) {\n    if (!this.isEnabled) return;\n\n    console.error(error.message);\n    \n    if (error.originalError) {\n      console.error('原始错误：', error.originalError);\n    }\n  }\n\n  /**\n   * 记录警告\n   */\n  static warn(message: string, details?: any) {\n    if (!this.isEnabled) return;\n    \n    console.warn(`⚠️  expo-gaode-map: ${message}`, details || '');\n  }\n}"]}
+{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../src/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,SAiBX;AAjBD,WAAY,SAAS;IACnB,eAAe;IACf,wDAA2C,CAAA;IAC3C,mBAAmB;IACnB,gDAAmC,CAAA;IACnC,YAAY;IACZ,oDAAuC,CAAA;IACvC,WAAW;IACX,gDAAmC,CAAA;IACnC,cAAc;IACd,oEAAuD,CAAA;IACvD,eAAe;IACf,kEAAqD,CAAA;IACrD,WAAW;IACX,oDAAuC,CAAA;IACvC,WAAW;IACX,4CAA+B,CAAA;AACjC,CAAC,EAjBW,SAAS,KAAT,SAAS,QAiBpB;AAkBD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,IAAI,CAAY;IAChB,QAAQ,CAAS;IACjB,MAAM,CAAU;IAChB,aAAa,CAAS;IAEtB,YAAY,OAAqB;QAC/B,MAAM,WAAW,GAAG;;eAET,OAAO,CAAC,IAAI;;;;KAItB,OAAO,CAAC,OAAO;;;KAGf,OAAO,CAAC,QAAQ;;EAEnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE;CACzD,CAAC;QACE,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,UAAU,GAAG,wCAAwC,CAAC;IAErE;;OAEG;IACH,MAAM,CAAC,iBAAiB;QACtB,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,mBAAmB;YACnC,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE;;;;;;;;;;;;;;;+BAee;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,4BAA4B;SACvD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAoC;QACvD,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE,SAAS;YAClB,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,eAAe;SACtB,CAAC,QAAQ,CAAC,CAAC;QAEZ,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,eAAe;YAC/B,OAAO,EAAE,GAAG,YAAY,mBAAmB;YAC3C,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;eA0BD,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;;;;;;IAMjD;YACE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,4BAA4B;SACvD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAA0B;QAChD,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CAwC+B;YACzC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,kCAAkC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAe;QACnC,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,eAAe;YAC/B,OAAO,EAAE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5C,QAAQ,EAAE;;;;;;;;;;;;;;;;;kDAiBkC;YAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,oBAAoB;SAC/C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB;QAC5B,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,yBAAyB;YACzC,OAAO,EAAE,wBAAwB;YACjC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;kDAsBkC;YAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,6BAA6B;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAkB;QAC7C,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,wBAAwB;YACxC,OAAO,EAAE,QAAQ,UAAU,YAAY;YACvC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4Bb;YACG,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,mBAAmB;SAC9C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAiB,EAAE,QAAgB,EAAE,QAAa;QACxE,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,OAAO,EAAE,OAAO,SAAS,QAAQ;YACjC,QAAQ,EAAE,QAAQ,QAAQ;OACzB,OAAO,QAAQ,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;;;;;;qBAM9B;YACf,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,OAAO;SAClC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,aAAqB;QACvC,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,aAAa;YAC7B,OAAO,EAAE,QAAQ;YACjB,QAAQ,EAAE;;;;;;;;;kBASE;YACZ,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,6BAA6B;YACvD,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAU,EAAE,OAAe;QAChD,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAErD,eAAe;QACf,IACE,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACxC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7B,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC/B,CAAC;YACD,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClC,CAAC;QAED,eAAe;QACf,IACE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC5B,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;YAChC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC7B,CAAC;YACD,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,SAAS;QACT,IACE,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;YACnC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC3B,CAAC;YACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;QAED,SAAS;QACT,IACE,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;YACjC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC3B,CAAC;YACD,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO;QACP,OAAO,IAAI,aAAa,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,iBAAiB;YACjC,OAAO,EAAE,GAAG,OAAO,KAAK;YACxB,QAAQ,EAAE,UAAU,YAAY;;;;;2DAKqB;YACrD,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC1D,CAAC,CAAC;IACL,CAAC;;AAGH;;GAEG;AACH,MAAM,OAAO,WAAW;IACtB,uBAAuB;IACf,MAAM,CAAC,SAAS,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAgB;QAChC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAoB;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAE5B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE7B,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,OAAa;QACxC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAE5B,OAAO,CAAC,IAAI,CAAC,uBAAuB,OAAO,EAAE,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC","sourcesContent":["/**\n * 高德地图错误处理工具\n * 提供友好的错误提示和解决方案指引\n */\n\n/**\n * 错误类型枚举\n */\nexport enum ErrorType {\n  /** SDK 未初始化 */\n  SDK_NOT_INITIALIZED = 'SDK_NOT_INITIALIZED',\n  /** API Key 配置错误 */\n  INVALID_API_KEY = 'INVALID_API_KEY',\n  /** 权限未授予 */\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  /** 定位失败 */\n  LOCATION_FAILED = 'LOCATION_FAILED',\n  /** 原生模块不可用 */\n  NATIVE_MODULE_UNAVAILABLE = 'NATIVE_MODULE_UNAVAILABLE',\n  /** 地图视图未初始化 */\n  MAP_VIEW_NOT_INITIALIZED = 'MAP_VIEW_NOT_INITIALIZED',\n  /** 参数错误 */\n  INVALID_PARAMETER = 'INVALID_PARAMETER',\n  /** 网络错误 */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n}\n\n/**\n * 错误详情接口\n */\nexport interface ErrorDetails {\n  /** 错误类型 */\n  type: ErrorType;\n  /** 错误消息 */\n  message: string;\n  /** 解决方案 */\n  solution: string;\n  /** 文档链接 */\n  docUrl?: string;\n  /** 原始错误 */\n  originalError?: Error;\n}\n\n/**\n * 自定义错误类\n */\nexport class GaodeMapError extends Error {\n  type: ErrorType;\n  solution: string;\n  docUrl?: string;\n  originalError?: Error;\n\n  constructor(details: ErrorDetails) {\n    const fullMessage = `\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n🗺️  高德地图错误 [${details.type}]\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n❌ 错误信息：\n   ${details.message}\n\n💡 解决方案：\n   ${details.solution}\n\n${details.docUrl ? `📖 详细文档：\\n   ${details.docUrl}\\n` : ''}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;\n    super(fullMessage);\n    this.name = 'GaodeMapError';\n    this.type = details.type;\n    this.solution = details.solution;\n    this.docUrl = details.docUrl;\n    this.originalError = details.originalError;\n  }\n}\n\n/**\n * 错误处理器类\n */\nexport class ErrorHandler {\n  private static docBaseUrl = 'https://TomWq.github.io/expo-gaode-map';\n\n  /**\n   * SDK 未初始化错误\n   */\n  static sdkNotInitialized(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.SDK_NOT_INITIALIZED,\n      message: '高德地图 SDK 尚未初始化',\n      solution: `请在使用地图功能前先调用 initSDK()：\n\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nuseEffect(() => {\n  // 在组件挂载时初始化\n  ExpoGaodeMapModule.initSDK({\n    androidKey: 'your-android-key',\n    iosKey: 'your-ios-key',\n  });\n}, []);\n\n⚠️  常见原因：\n1. 忘记调用 initSDK() 就使用了定位或地图功能\n2. initSDK() 调用时机过晚（应在 useEffect 中尽早调用）\n3. 使用 Config Plugin 但未重新构建原生代码`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * API Key 配置错误\n   */\n  static invalidApiKey(platform: 'android' | 'ios' | 'both'): GaodeMapError {\n    const platformText = {\n      android: 'Android',\n      ios: 'iOS',\n      both: 'Android 和 iOS',\n    }[platform];\n\n    return new GaodeMapError({\n      type: ErrorType.INVALID_API_KEY,\n      message: `${platformText} API Key 配置错误或未配置`,\n      solution: `请检查以下步骤：\n\n1️⃣  获取 API Key：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 注册并创建应用\n   • 获取对应平台的 API Key\n\n2️⃣  配置 API Key（推荐使用 Config Plugin）：\n\n在 app.json 中配置：\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"expo-gaode-map\",\n        {\n          \"androidKey\": \"your-android-key\",\n          \"iosKey\": \"your-ios-key\"\n        }\n      ]\n    ]\n  }\n}\n\n然后重新构建：\nnpx expo prebuild --clean\nnpx expo run:${platform === 'ios' ? 'ios' : 'android'}\n\n3️⃣  或在代码中配置：\nExpoGaodeMapModule.initSDK({\n  androidKey: 'your-android-key',\n  iosKey: 'your-ios-key',\n});`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * 权限未授予错误\n   */\n  static permissionDenied(permissionType: 'location'): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.PERMISSION_DENIED,\n      message: '定位权限未授予，无法使用定位功能',\n      solution: `请按以下步骤授予权限：\n\n1️⃣  请求权限：\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nconst checkPermission = async () => {\n  // 检查权限状态\n  const status = await ExpoGaodeMapModule.checkLocationPermission();\n  \n  if (!status.granted) {\n    // 请求权限\n    const result = await ExpoGaodeMapModule.requestLocationPermission();\n    \n    if (!result.granted) {\n      // 用户拒绝授权，引导用户去设置\n      Alert.alert(\n        '需要定位权限',\n        '请在设置中开启定位权限以使用地图功能',\n        [\n          { text: '取消', style: 'cancel' },\n          { text: '去设置', onPress: () => Linking.openSettings() }\n        ]\n      );\n    }\n  }\n};\n\n2️⃣  iOS 配置（在 app.json 中）：\n{\n  \"expo\": {\n    \"ios\": {\n      \"infoPlist\": {\n        \"NSLocationWhenInUseUsageDescription\": \"需要获取您的位置信息以显示地图\",\n        \"NSLocationAlwaysAndWhenInUseUsageDescription\": \"需要获取您的位置信息\"\n      }\n    }\n  }\n}\n\n3️⃣  Android 配置（Config Plugin 会自动添加）：\n使用 expo-gaode-map 的 Config Plugin 会自动添加必要的权限声明`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html#权限配置`,\n    });\n  }\n\n  /**\n   * 定位失败错误\n   */\n  static locationFailed(reason?: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.LOCATION_FAILED,\n      message: `定位失败${reason ? `：${reason}` : ''}`,\n      solution: `请检查以下问题：\n\n1️⃣  设备 GPS 是否开启\n2️⃣  网络连接是否正常\n3️⃣  定位权限是否已授予\n4️⃣  是否在室内或信号较弱的地方\n\n💡 解决方法：\n// 配置定位参数\nExpoGaodeMapModule.setLocationTimeout(30); // 增加超时时间\nExpoGaodeMapModule.setInterval(2000); // 设置定位间隔\n\n// Android 特有配置\nExpoGaodeMapModule.setLocationMode(2); // 高精度模式\nExpoGaodeMapModule.setGpsFirst(true);  // GPS 优先\n\n// iOS 特有配置\nExpoGaodeMapModule.setDesiredAccuracy(0); // 最佳精度`,\n      docUrl: `${this.docBaseUrl}/api/location.html`,\n    });\n  }\n\n  /**\n   * 原生模块不可用错误\n   */\n  static nativeModuleUnavailable(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NATIVE_MODULE_UNAVAILABLE,\n      message: 'expo-gaode-map 原生模块不可用',\n      solution: `请检查以下步骤：\n\n1️⃣  确认已正确安装：\nnpm install expo-gaode-map\n# 或\nbun install expo-gaode-map\n\n2️⃣  重新构建原生代码：\nnpx expo prebuild --clean\nnpx expo run:android\nnpx expo run:ios\n\n3️⃣  检查 Expo 版本兼容性：\n• expo-gaode-map 需要 Expo SDK 49+\n• 不支持 Expo Go，必须使用 Development Build\n\n4️⃣  检查是否与其他包冲突：\n• 不能同时安装 expo-gaode-map 和 expo-gaode-map-navigation\n• 两个包选择其一使用\n\n5️⃣  清理缓存后重试：\ncd android && ./gradlew clean && cd ..\ncd ios && pod deintegrate && pod install && cd ..`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html`,\n    });\n  }\n\n  /**\n   * 地图视图未初始化错误\n   */\n  static mapViewNotInitialized(methodName: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.MAP_VIEW_NOT_INITIALIZED,\n      message: `无法调用 ${methodName}：地图视图尚未初始化`,\n      solution: `请确保：\n\n1️⃣  MapView 已经渲染完成\n2️⃣  使用 ref 获取地图实例后再调用方法\n\n正确用法：\nimport { MapView, MapViewRef } from 'expo-gaode-map';\n\nconst App = () => {\n  const mapRef = useRef<MapViewRef>(null);\n  \n  // ❌ 错误：在渲染前调用\n  // mapRef.current?.moveCamera(...);\n  \n  // ✅ 正确：等待地图加载完成\n  const handleMapReady = () => {\n    mapRef.current?.moveCamera({\n      target: { latitude: 39.9, longitude: 116.4 },\n      zoom: 15,\n    });\n  };\n  \n  return (\n    <MapView\n      ref={mapRef}\n      onMapReady={handleMapReady}\n    />\n  );\n};`,\n      docUrl: `${this.docBaseUrl}/api/mapview.html`,\n    });\n  }\n\n  /**\n   * 参数错误\n   */\n  static invalidParameter(paramName: string, expected: string, received: any): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `参数 \"${paramName}\" 类型错误`,\n      solution: `期望类型：${expected}\n实际接收：${typeof received} (${JSON.stringify(received)})\n\n请检查传入的参数是否符合要求。\n\n💡 提示：\n• 使用 TypeScript 可以在编译时发现类型错误\n• 参考 API 文档了解正确的参数类型`,\n      docUrl: `${this.docBaseUrl}/api/`,\n    });\n  }\n\n  /**\n   * 网络错误\n   */\n  static networkError(originalError?: Error): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NETWORK_ERROR,\n      message: '网络请求失败',\n      solution: `请检查：\n\n1️⃣  网络连接是否正常\n2️⃣  API Key 是否有效\n3️⃣  是否超出配额限制\n\n💡 如果问题持续，请：\n• 检查高德开放平台控制台\n• 查看 API 调用量和配额\n• 确认 Key 的服务是否已开通`,\n      docUrl: `${this.docBaseUrl}/guide/troubleshooting.html`,\n      originalError,\n    });\n  }\n\n  /**\n   * 包装原生错误，提供更友好的提示\n   */\n  static wrapNativeError(error: any, context: string): GaodeMapError {\n    const errorMessage = error?.message || String(error);\n    \n    // SDK 未初始化相关错误\n    if (\n      errorMessage.includes('not initialized') ||\n      errorMessage.includes('未初始化') ||\n      errorMessage.includes('SDK未设置')\n    ) {\n      return this.sdkNotInitialized();\n    }\n    \n    // API Key 相关错误\n    if (\n      errorMessage.includes('key') ||\n      errorMessage.includes('invalid') ||\n      errorMessage.includes('鉴权失败')\n    ) {\n      return this.invalidApiKey('both');\n    }\n    \n    // 权限相关错误\n    if (\n      errorMessage.includes('permission') ||\n      errorMessage.includes('权限')\n    ) {\n      return this.permissionDenied('location');\n    }\n    \n    // 定位相关错误\n    if (\n      errorMessage.includes('location') ||\n      errorMessage.includes('定位')\n    ) {\n      return this.locationFailed(errorMessage);\n    }\n    \n    // 通用错误\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `${context} 失败`,\n      solution: `原始错误信息：${errorMessage}\n\n如果问题持续，请：\n1. 查看完整的错误堆栈\n2. 检查 API 调用参数\n3. 提交 Issue：https://github.com/TomWq/expo-gaode-map/issues`,\n      originalError: error instanceof Error ? error : undefined,\n    });\n  }\n}\n\n/**\n * 错误日志工具\n */\nexport class ErrorLogger {\n  // 兼容不同环境：Bun/Jest/Node\n  private static isEnabled = typeof __DEV__ !== 'undefined' ? __DEV__ : true;\n\n  /**\n   * 启用/禁用错误日志\n   */\n  static setEnabled(enabled: boolean) {\n    this.isEnabled = enabled;\n  }\n\n  /**\n   * 记录错误\n   */\n  static log(error: GaodeMapError) {\n    if (!this.isEnabled) return;\n\n    console.error(error.message);\n    \n    if (error.originalError) {\n      console.error('原始错误：', error.originalError);\n    }\n  }\n\n  /**\n   * 记录警告\n   */\n  static warn(message: string, details?: any) {\n    if (!this.isEnabled) return;\n    \n    console.warn(`⚠️  expo-gaode-map: ${message}`, details || '');\n  }\n}\n"]}

package/ios/ExpoGaodeMapModule.swift

@@ -51,7 +51,7 @@ public class ExpoGaodeMapModule: Module {
                 let isPreloading = (status["isPreloading"] as? Bool) ?? false
                 
                 if !MapPreloadManager.shared.hasPreloadedMapView() && !isPreloading {
-                    print("🚀 ExpoGaodeMap: 自动启动地图预加载")
+                   
                     MapPreloadManager.shared.startPreload(poolSize: poolSize)
                 }
             }
@@ -569,7 +569,7 @@ public class ExpoGaodeMapModule: Module {
          * @returns 面积（单位：平方米）
          */
         AsyncFunction("calculatePolygonArea") { (polygon: [[String: Double]], promise: Promise) in
-            print("📐 calculatePolygonArea 被调用，参数: \(polygon)")
+         
             
             let polygonCoords = polygon.compactMap { coord -> CLLocationCoordinate2D? in
                 guard let lat = coord["latitude"],
@@ -579,7 +579,7 @@ public class ExpoGaodeMapModule: Module {
                 return CLLocationCoordinate2D(latitude: lat, longitude: lon)
             }
             
-            print("📐 转换后的坐标数: \(polygonCoords.count)")
+   
             
             guard polygonCoords.count >= 3 else {
                 promise.reject("INVALID_ARGUMENT", "多边形至少需要3个顶点")
@@ -590,10 +590,10 @@ public class ExpoGaodeMapModule: Module {
             let area = polygonCoords.withUnsafeBufferPointer { buffer in
                 let mutablePointer = UnsafeMutablePointer<CLLocationCoordinate2D>(mutating: buffer.baseAddress!)
                 let result = MAAreaForPolygon(mutablePointer, Int32(polygonCoords.count))
-                print("📐 MAAreaForPolygon 结果: \(result)")
+              
                 return result
             }
-            print("📐 最终面积: \(area)")
+          
             promise.resolve(area)
         }
         
@@ -604,7 +604,7 @@ public class ExpoGaodeMapModule: Module {
          * @returns 面积（单位：平方米）
          */
         AsyncFunction("calculateRectangleArea") { (southWest: [String: Double], northEast: [String: Double], promise: Promise) in
-            print("📐 calculateRectangleArea 被调用，参数: sw=\(southWest), ne=\(northEast)")
+          
             
             guard let swLat = southWest["latitude"],
                   let swLon = southWest["longitude"],
@@ -624,9 +624,9 @@ public class ExpoGaodeMapModule: Module {
                 MAMapPointForCoordinate(CLLocationCoordinate2D(latitude: neLat, longitude: swLon))
             )
             
-            print("📐 宽: \(width), 高: \(height)")
+            
             let area = width * height
-            print("📐 最终面积: \(area)")
+            
             promise.resolve(area)
         }
         

package/ios/MapPreloadManager.swift

@@ -43,7 +43,7 @@ class MapPreloadManager {
     private var cleanupTimer: Timer?
 
     private init() {
-        print("🔧 [MapPreload] 初始化预加载管理器（自适应版本）")
+     
         
         // 注册内存警告监听
         NotificationCenter.default.addObserver(
@@ -79,13 +79,12 @@ class MapPreloadManager {
         }
         
         if expiredCount > 0 {
-            print("🧹 [MapPreload] 清理了 \(expiredCount) 个过期实例（当前TTL: \(Int(currentTTL))秒）")
         }
     }
     
     /// 处理内存警告
     @objc private func handleMemoryWarning() {
-        print("⚠️ [MapPreload] 收到内存警告，自动清理预加载池")
+      
         clearPool()
     }
     
@@ -93,7 +92,7 @@ class MapPreloadManager {
     /// - Parameter poolSize: 预加载的地图实例数量（会根据内存自适应调整）
     func startPreload(poolSize: Int) {
         guard !isPreloading else {
-            print("⚠️ [MapPreload] 预加载已在进行中")
+         
             return
         }
         
@@ -106,13 +105,12 @@ class MapPreloadManager {
         
         // 检查内存是否充足
         guard hasEnoughMemory() else {
-            print("⚠️ [MapPreload] 内存不足，跳过预加载")
+           
             return
         }
         
         isPreloading = true
         let targetSize = min(poolSize, adaptiveMaxPoolSize)
-        print("🚀 [MapPreload] 开始预加载 \(targetSize) 个地图实例 (自适应池大小: \(adaptiveMaxPoolSize), TTL: \(Int(currentTTL))秒)")
         
         for i in 0..<targetSize {
             preloadGroup.enter()  // 进入预加载队列
@@ -127,7 +125,6 @@ class MapPreloadManager {
                     DispatchQueue.main.async {
                         let instance = PreloadedMapInstance(mapView: mapView, timestamp: Date())
                         self.preloadedMapInstances.append(instance)
-                        print("✅ [MapPreload] 预加载实例 \(i + 1)/\(targetSize) 完成")
                         self.preloadGroup.leave()
                     }
                 }
@@ -137,7 +134,6 @@ class MapPreloadManager {
         // 等待所有实例加载完成
         preloadGroup.notify(queue: DispatchQueue.main) {
             self.isPreloading = false
-            print("🎉 [MapPreload] 所有实例预加载完成")
         }
     }
     
@@ -191,16 +187,12 @@ class MapPreloadManager {
         
         switch availableMB {
         case 500...:
-            print("📊 [MapPreload] 高内存设备 (\(availableMB)MB)，池大小: \(maxPoolSizeHighMemory)")
             return maxPoolSizeHighMemory
         case 300..<500:
-            print("📊 [MapPreload] 中等内存设备 (\(availableMB)MB)，池大小: \(maxPoolSizeMediumMemory)")
             return maxPoolSizeMediumMemory
         case 150..<300:
-            print("📊 [MapPreload] 低内存设备 (\(availableMB)MB)，池大小: \(maxPoolSizeLowMemory)")
             return maxPoolSizeLowMemory
         default:
-            print("⚠️ [MapPreload] 内存极低 (\(availableMB)MB)，禁用预加载")
             return 0
         }
     }
@@ -215,15 +207,12 @@ class MapPreloadManager {
         switch usagePercent {
         case 0..<60:
             memoryPressureLevel = 0
-            print("📊 [MapPreload] 内存充足 (使用率: \(usagePercent)%)，TTL: \(Int(ttlNormal))秒")
             return ttlNormal
         case 60..<80:
             memoryPressureLevel = 1
-            print("📊 [MapPreload] 内存压力 (使用率: \(usagePercent)%)，TTL: \(Int(ttlMemoryPressure))秒")
             return ttlMemoryPressure
         default:
             memoryPressureLevel = 2
-            print("⚠️ [MapPreload] 内存严重不足 (使用率: \(usagePercent)%)，TTL: \(Int(ttlLowMemory))秒")
             return ttlLowMemory
         }
     }
@@ -266,18 +255,15 @@ class MapPreloadManager {
         preloadedMapInstances.removeAll { instance in
             let isExpired = now.timeIntervalSince(instance.timestamp) > currentTTL
             if isExpired {
-                print("🗑️ [MapPreload] 预加载实例已过期（TTL: \(Int(currentTTL))秒），已删除")
             }
             return isExpired
         }
         
         if let instance = preloadedMapInstances.first {
             preloadedMapInstances.removeFirst()
-            print("📤 [MapPreload] 使用预加载实例，剩余: \(preloadedMapInstances.count)")
             return instance.mapView
         }
         
-        print("⚠️ [MapPreload] 预加载池为空，返回 nil")
         return nil
     }
     
@@ -285,7 +271,6 @@ class MapPreloadManager {
     func clearPool() {
         let count = preloadedMapInstances.count
         preloadedMapInstances.removeAll()
-        print("🗑️ [MapPreload] 预加载池已清空，清理了 \(count) 个实例")
     }
     
     /// 获取预加载状态（包含动态配置信息）
@@ -328,7 +313,6 @@ class MapPreloadManager {
         cleanupTimer?.invalidate()
         cleanupTimer = nil
         clearPool()
-        print("🧹 [MapPreload] 预加载管理器已清理")
     }
     
     deinit {

package/ios/overlays/MarkerView.swift

@@ -320,22 +320,18 @@ class MarkerView: ExpoView {
                 guard let self = self, let annotationView = annotationView else { return }
                 // 再次检查缓存（避免重复渲染）
                 if let cached = IconBitmapCache.shared.image(forKey: key) {
-                    print("🔄 iOS Marker: 使用缓存图片, key: \(key)")
                     annotationView.image = cached
                     annotationView.centerOffset = CGPoint(x: 0, y: 0)
                     return
                 }
                 
-                print("⏰ iOS Marker: 0.5秒后开始渲染, key: \(key)")
                 // 调用你的原生渲染逻辑（保留空白检测、多次 layout）
                 if let generated = self.createImageFromSubviews() {
                     // 写入缓存（仅当用户传了 cacheKey 才缓存；否则建议仍缓存由 fingerprint 决定）
                     IconBitmapCache.shared.setImage(generated, forKey: key)
                     annotationView.image = generated
                     annotationView.centerOffset = CGPoint(x: 0, y: 0)
-                    print("✅ iOS Marker: 渲染成功并显示, size: \(generated.size)")
                 } else {
-                    print("⚠️ iOS Marker: 渲染失败,图片为空")
                 }
             }
 
@@ -503,33 +499,7 @@ class MarkerView: ExpoView {
             return nil
         }
         
-        // 🔑 检查图片是否真的有内容（不是空白图片）
-        // 暂时禁用空白检测,因为 React Native Image 可能需要额外的渲染时间
-        // guard let cgImage = image.cgImage else {
-        //     print("⚠️ iOS Marker: cgImage 为 nil")
-        //     return nil
-        // }
-        
-        // let dataProvider = cgImage.dataProvider
-        // let data = dataProvider?.data
-        // let buffer = CFDataGetBytePtr(data)
-        
-        // var isBlank = true
-        // if let buffer = buffer {
-        //     let length = CFDataGetLength(data)
-        //     let checkLength = min(100, length)
-        //     for i in 0..<checkLength {
-        //         if buffer[i] != 0 {
-        //             isBlank = false
-        //             break
-        //         }
-        //     }
-        // }
-        
-        // if isBlank {
-        //     print("⚠️ iOS Marker: 渲染的图片是空白的")
-        //     return nil
-        // }
+   
         
         // 🔑 写入缓存
         if let key = cacheKey {