expo-gaode-map 2.2.11 → 2.2.12

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

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;IAuDzE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,UAAU,GAAG,aAAa;IAiDlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IAuCrD;;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

@@ -97,14 +97,22 @@ useEffect(() => {
         return new GaodeMapError({
             type: ErrorType.INVALID_API_KEY,
             message: `${platformText} API Key 配置错误或未配置`,
-            solution: `请检查以下步骤：
+            solution: `⚠️  API Key 与 Bundle ID 不匹配是最常见的原因！
+
+请检查以下步骤：
 
-1️⃣  获取 API Key：
+1️⃣  确认 API Key 的配置：
    • 访问高德开放平台：https://lbs.amap.com/
-   • 注册并创建应用
-   • 获取对应平台的 API Key
+   • 检查您的应用配置中的 Bundle ID 是否与当前项目一致
+   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier 查看
+   • Android 包名：在 android/app/build.gradle → applicationId 查看
 
-2️⃣  配置 API Key（推荐使用 Config Plugin）：
+2️⃣  重新创建正确的 API Key（如果 Bundle ID 不同）：
+   • 在高德开放平台创建新应用
+   • 填写正确的 Bundle ID（iOS）或包名（Android）
+   • 获取新的 API Key
+
+3️⃣  配置 API Key（推荐使用 Config Plugin）：
 
 在 app.json 中配置：
 {
@@ -125,7 +133,7 @@ useEffect(() => {
 npx expo prebuild --clean
 npx expo run:${platform === 'ios' ? 'ios' : 'android'}
 
-3️⃣  或在代码中配置：
+4️⃣  或在代码中配置：
 ExpoGaodeMapModule.initSDK({
   androidKey: 'your-android-key',
   iosKey: 'your-ios-key',
@@ -191,15 +199,28 @@ const checkPermission = async () => {
         return new GaodeMapError({
             type: ErrorType.LOCATION_FAILED,
             message: `定位失败${reason ? `：${reason}` : ''}`,
-            solution: `请检查以下问题：
+            solution: `⚠️  最常见原因：API Key 与 Bundle ID 不匹配！
 
-1️⃣  设备 GPS 是否开启
-2️⃣  网络连接是否正常
-3️⃣  定位权限是否已授予
-4️⃣  是否在室内或信号较弱的地方
+请按以下顺序排查：
 
-💡 解决方法：
-// 配置定位参数
+1️⃣  检查 API Key 配置（最常见问题）：
+   • 访问高德开放平台：https://lbs.amap.com/
+   • 确认您的应用的 Bundle ID 与当前项目一致
+   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier
+   • Android 包名：在 android/app/build.gradle → applicationId
+   
+   如果 Bundle ID 不同，必须在高德平台重新创建应用并获取新 Key
+
+2️⃣  检查设备 GPS 和网络：
+   • 确认设备 GPS 已开启
+   • 检查网络连接是否正常
+   • 尝试在室外空旷处测试
+
+3️⃣  检查定位权限：
+   • iOS：设置 → 隐私 → 定位服务 → 允许应用访问
+   • Android：设置 → 应用 → 权限管理 → 位置信息
+
+4️⃣  配置定位参数（如果 API Key 正确但定位仍失败）：
 ExpoGaodeMapModule.setLocationTimeout(30); // 增加超时时间
 ExpoGaodeMapModule.setInterval(2000); // 设置定位间隔
 
@@ -224,7 +245,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 +389,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":"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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: `⚠️  API Key 与 Bundle ID 不匹配是最常见的原因！\n\n请检查以下步骤：\n\n1️⃣  确认 API Key 的配置：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 检查您的应用配置中的 Bundle ID 是否与当前项目一致\n   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier 查看\n   • Android 包名：在 android/app/build.gradle → applicationId 查看\n\n2️⃣  重新创建正确的 API Key（如果 Bundle ID 不同）：\n   • 在高德开放平台创建新应用\n   • 填写正确的 Bundle ID（iOS）或包名（Android）\n   • 获取新的 API Key\n\n3️⃣  配置 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\n4️⃣  或在代码中配置：\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: `⚠️  最常见原因：API Key 与 Bundle ID 不匹配！\n\n请按以下顺序排查：\n\n1️⃣  检查 API Key 配置（最常见问题）：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 确认您的应用的 Bundle ID 与当前项目一致\n   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier\n   • Android 包名：在 android/app/build.gradle → applicationId\n   \n   如果 Bundle ID 不同，必须在高德平台重新创建应用并获取新 Key\n\n2️⃣  检查设备 GPS 和网络：\n   • 确认设备 GPS 已开启\n   • 检查网络连接是否正常\n   • 尝试在室外空旷处测试\n\n3️⃣  检查定位权限：\n   • iOS：设置 → 隐私 → 定位服务 → 允许应用访问\n   • Android：设置 → 应用 → 权限管理 → 位置信息\n\n4️⃣  配置定位参数（如果 API Key 正确但定位仍失败）：\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map",
-  "version": "2.2.11",
+  "version": "2.2.12",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -12,8 +12,19 @@
     "expo-module.config.json",
     "plugin/build"
   ],
-  "jest": {
-    "preset": "expo-module-scripts"
+  "scripts": {
+    "build": "expo-module build && bun run build:plugin",
+    "build:plugin": "tsc --project plugin/tsconfig.json",
+    "clean": "expo-module clean && rm -rf plugin/build",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare && bun run build:plugin",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android",
+    "publish:next": "bun publish --tag next",
+    "publish:latest": "bun publish --tag latest"
   },
   "keywords": [
     "react-native",
@@ -54,17 +65,5 @@
     "expo": "*",
     "react": "*",
     "react-native": "*"
-  },
-  "scripts": {
-    "build": "expo-module build && pnpm run build:plugin",
-    "build:plugin": "tsc --project plugin/tsconfig.json",
-    "clean": "expo-module clean && rm -rf plugin/build",
-    "lint": "expo-module lint",
-    "test": "expo-module test",
-    "expo-module": "expo-module",
-    "open:ios": "xed example/ios",
-    "open:android": "open -a \"Android Studio\" example/android",
-    "publish:next": "pnpm publish --tag next",
-    "publish:latest": "pnpm publish --tag latest"
   }
-}
+}

package/plugin/build/withGaodeMap.js

@@ -1,8 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("@expo/config-plugins");
+const pkg = require('expo-gaode-map/package.json');
+/** 默认定位权限描述 */
+const DEFAULT_LOCATION_USAGE = '需要访问您的位置信息以提供地图服务';
 /**
- * iOS: 修改 Info.plist 添加 API Key 和权限
+ * iOS: 使用 IOSConfig 添加定位权限
+ */
+const withGaodeMapIOSPermissions = (config, props) => {
+    if (props.enableLocation === false) {
+        return config;
+    }
+    const description = props.locationDescription || DEFAULT_LOCATION_USAGE;
+    // 构建权限配置对象
+    const permissionDefaults = {
+        NSLocationWhenInUseUsageDescription: DEFAULT_LOCATION_USAGE,
+    };
+    const permissionValues = {
+        NSLocationWhenInUseUsageDescription: description,
+    };
+    // 如果启用后台定位，添加额外权限
+    if (props.enableBackgroundLocation) {
+        permissionDefaults.NSLocationAlwaysUsageDescription = DEFAULT_LOCATION_USAGE;
+        permissionDefaults.NSLocationAlwaysAndWhenInUseUsageDescription = DEFAULT_LOCATION_USAGE;
+        permissionValues.NSLocationAlwaysUsageDescription = description;
+        permissionValues.NSLocationAlwaysAndWhenInUseUsageDescription = description;
+    }
+    // 使用 IOSConfig.Permissions 简化权限配置
+    return config_plugins_1.IOSConfig.Permissions.createPermissionsPlugin(permissionDefaults)(config, permissionValues);
+};
+/**
+ * iOS: 修改 Info.plist 添加 API Key 和后台模式
  */
 const withGaodeMapInfoPlist = (config, props) => {
     return (0, config_plugins_1.withInfoPlist)(config, (config) => {
@@ -10,20 +38,14 @@ const withGaodeMapInfoPlist = (config, props) => {
         if (props.iosApiKey) {
             config.modResults.AMapApiKey = props.iosApiKey;
         }
-        // 添加定位相关权限
-        if (props.enableLocation !== false) {
-            const description = props.locationDescription || '需要访问您的位置信息以提供地图服务';
-            // 使用时定位权限（必需）
-            config.modResults.NSLocationWhenInUseUsageDescription = description;
-            // 后台定位权限（可选）
-            if (props.enableBackgroundLocation) {
-                config.modResults.NSLocationAlwaysUsageDescription = description;
-                config.modResults.NSLocationAlwaysAndWhenInUseUsageDescription = description;
-                // 添加后台定位模式
-                if (!config.modResults.UIBackgroundModes) {
-                    config.modResults.UIBackgroundModes = [];
-                }
-                if (!config.modResults.UIBackgroundModes.includes('location')) {
+        // 添加后台定位模式（如果启用）
+        if (props.enableBackgroundLocation) {
+            const modes = config.modResults.UIBackgroundModes;
+            if (!modes) {
+                config.modResults.UIBackgroundModes = ['location'];
+            }
+            else if (Array.isArray(modes)) {
+                if (modes.indexOf('location') === -1) {
                     config.modResults.UIBackgroundModes.push('location');
                 }
             }
@@ -41,55 +63,29 @@ const withGaodeMapInfoPlist = (config, props) => {
  * 2. 通过 JavaScript 调用 ExpoGaodeMap.initSDK({ iosKey: 'your-key' })
  */
 /**
- * Android: 修改 AndroidManifest.xml 添加 API Key 和权限
+ * Android: 使用 AndroidConfig 添加基础权限
+ */
+const withGaodeMapAndroidPermissions = (config, props) => {
+    // 基础定位权限（高德地图 SDK 必需）
+    const basePermissions = [
+        'android.permission.ACCESS_COARSE_LOCATION',
+        'android.permission.ACCESS_FINE_LOCATION',
+        'android.permission.ACCESS_NETWORK_STATE',
+        'android.permission.ACCESS_WIFI_STATE',
+    ];
+    // 后台定位权限（可选）
+    if (props.enableBackgroundLocation) {
+        basePermissions.push('android.permission.ACCESS_BACKGROUND_LOCATION', 'android.permission.FOREGROUND_SERVICE', 'android.permission.FOREGROUND_SERVICE_LOCATION');
+    }
+    // 使用 AndroidConfig.Permissions 简化权限配置（自动去重）
+    return config_plugins_1.AndroidConfig.Permissions.withPermissions(config, basePermissions);
+};
+/**
+ * Android: 修改 AndroidManifest.xml 添加 API Key 和服务
  */
 const withGaodeMapAndroidManifest = (config, props) => {
     return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
         const androidManifest = config.modResults.manifest;
-        // 基础权限（库中已包含，这里不重复添加）
-        // INTERNET, ACCESS_NETWORK_STATE, ACCESS_WIFI_STATE
-        // ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION
-        // 添加基础权限（高德地图 SDK 必需）
-        const basePermissions = [
-            'android.permission.ACCESS_COARSE_LOCATION',
-            'android.permission.ACCESS_FINE_LOCATION',
-            'android.permission.ACCESS_NETWORK_STATE',
-            'android.permission.ACCESS_WIFI_STATE',
-            'android.permission.WRITE_EXTERNAL_STORAGE',
-            'android.permission.READ_PHONE_STATE',
-            'android.permission.BLUETOOTH',
-            'android.permission.BLUETOOTH_ADMIN',
-        ];
-        if (!androidManifest['uses-permission']) {
-            androidManifest['uses-permission'] = [];
-        }
-        basePermissions.forEach((permission) => {
-            const hasPermission = androidManifest['uses-permission']?.some((item) => item.$?.['android:name'] === permission);
-            if (!hasPermission) {
-                androidManifest['uses-permission']?.push({
-                    $: { 'android:name': permission },
-                });
-            }
-        });
-        // 后台定位权限（可选）
-        if (props.enableBackgroundLocation) {
-            const backgroundPermissions = [
-                'android.permission.ACCESS_BACKGROUND_LOCATION',
-                'android.permission.FOREGROUND_SERVICE',
-                'android.permission.FOREGROUND_SERVICE_LOCATION',
-            ];
-            if (!androidManifest['uses-permission']) {
-                androidManifest['uses-permission'] = [];
-            }
-            backgroundPermissions.forEach((permission) => {
-                const hasPermission = androidManifest['uses-permission']?.some((item) => item.$?.['android:name'] === permission);
-                if (!hasPermission) {
-                    androidManifest['uses-permission']?.push({
-                        $: { 'android:name': permission },
-                    });
-                }
-            });
-        }
         // 添加高德定位服务（APSService）- 必需
         const mainApplication = androidManifest.application?.[0];
         if (mainApplication) {
@@ -168,12 +164,11 @@ const withGaodeMap = (config, props = {}) => {
         config_plugins_1.WarningAggregator.addWarningIOS('expo-gaode-map', '未配置 API Key。请在 app.json 的 plugins 中配置 iosApiKey 和 androidApiKey');
     }
     // 应用 iOS 配置
-    config = withGaodeMapInfoPlist(config, props);
-    // 注意：不再需要修改 AppDelegate，因为：
-    // 1. SDK 会自动从 Info.plist 读取 AMapApiKey
-    // 2. 可以通过 ExpoGaodeMapModule.initSDK() 方法初始化
+    config = withGaodeMapIOSPermissions(config, props); // 使用 IOSConfig 添加权限
+    config = withGaodeMapInfoPlist(config, props); // 添加 API Key 和后台模式
     // 应用 Android 配置
-    config = withGaodeMapAndroidManifest(config, props);
+    config = withGaodeMapAndroidPermissions(config, props); // 使用 AndroidConfig 添加权限
+    config = withGaodeMapAndroidManifest(config, props); // 添加服务和 API Key
     config = withGaodeMapAppBuildGradle(config, props);
     return config;
 };
@@ -181,4 +176,4 @@ const withGaodeMap = (config, props = {}) => {
  * 导出为可运行一次的插件
  * 这确保插件只会运行一次，即使在配置中被多次引用
  */
-exports.default = (0, config_plugins_1.createRunOncePlugin)(withGaodeMap, 'expo-gaode-map', '1.0.0');
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withGaodeMap, pkg.name, pkg.version);