expo-gaode-map-navigation 2.0.17 → 2.0.19

package/build/src/map/utils/ErrorHandler.js

@@ -0,0 +1,470 @@
+/**
+ * 高德地图错误处理工具
+ * 提供友好的错误提示和解决方案指引
+ */
+/**
+ * 错误类型枚举
+ */
+export var ErrorType;
+(function (ErrorType) {
+    /** SDK 未初始化 */
+    ErrorType["SDK_NOT_INITIALIZED"] = "SDK_NOT_INITIALIZED";
+    /** 隐私协议未确认 */
+    ErrorType["PRIVACY_NOT_AGREED"] = "PRIVACY_NOT_AGREED";
+    /** API Key 配置错误 */
+    ErrorType["INVALID_API_KEY"] = "INVALID_API_KEY";
+    /** 权限未授予 */
+    ErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** 定位失败 */
+    ErrorType["LOCATION_FAILED"] = "LOCATION_FAILED";
+    /** 原生模块不可用 */
+    ErrorType["NATIVE_MODULE_UNAVAILABLE"] = "NATIVE_MODULE_UNAVAILABLE";
+    /** 地图视图未初始化 */
+    ErrorType["MAP_VIEW_NOT_INITIALIZED"] = "MAP_VIEW_NOT_INITIALIZED";
+    /** 参数错误 */
+    ErrorType["INVALID_PARAMETER"] = "INVALID_PARAMETER";
+    /** 网络错误 */
+    ErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
+})(ErrorType || (ErrorType = {}));
+/**
+ * 自定义错误类
+ */
+export class GaodeMapError extends Error {
+    type;
+    solution;
+    docUrl;
+    originalError;
+    constructor(details) {
+        const fullMessage = `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🗺️  高德地图错误 [${details.type}]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+❌ 错误信息：
+   ${details.message}
+
+💡 解决方案：
+   ${details.solution}
+
+${details.docUrl ? `📖 详细文档：\n   ${details.docUrl}\n` : ''}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`;
+        super(fullMessage);
+        this.name = 'GaodeMapError';
+        this.type = details.type;
+        this.solution = details.solution;
+        this.docUrl = details.docUrl;
+        this.originalError = details.originalError;
+    }
+}
+/**
+ * 错误处理器类
+ */
+export class ErrorHandler {
+    static docBaseUrl = 'https://TomWq.github.io/expo-gaode-map';
+    /**
+     * SDK 未初始化错误
+     */
+    static sdkNotInitialized() {
+        return new GaodeMapError({
+            type: ErrorType.SDK_NOT_INITIALIZED,
+            message: '高德地图 SDK 尚未初始化',
+            solution: `请在使用地图功能前先调用 initSDK()：
+
+import {ExpoGaodeMapModule} from 'expo-gaode-map-navigation';
+
+useEffect(() => {
+  // 在组件挂载时初始化
+  ExpoGaodeMapModule.initSDK({
+    androidKey: 'your-android-key',
+    iosKey: 'your-ios-key',
+  });
+}, []);
+
+⚠️  常见原因：
+1. 忘记调用 initSDK() 就使用了定位或地图功能
+2. initSDK() 调用时机过晚（应在 useEffect 中尽早调用）
+3. 使用 Config Plugin 但未重新构建原生代码`,
+            docUrl: `${this.docBaseUrl}/guide/initialization.html`,
+        });
+    }
+    /**
+     * 隐私协议未确认错误
+     */
+    static privacyNotAgreed(scene) {
+        const sceneText = scene === 'map' ? '渲染 MapView' : '初始化 SDK';
+        return new GaodeMapError({
+            type: ErrorType.PRIVACY_NOT_AGREED,
+            message: `调用高德地图前未完成隐私合规确认：${sceneText}`,
+            solution: `请在调用任何高德地图 SDK 接口前，先明确完成隐私告知与同意：
+
+import {ExpoGaodeMapModule} from 'expo-gaode-map-navigation';
+
+// 应用启动后，先展示你自己的隐私弹窗
+ExpoGaodeMapModule.setPrivacyConfig({
+  hasShow: true,
+  hasContainsPrivacy: true,
+  hasAgree: true,
+});
+
+// 然后再初始化 SDK / 渲染地图
+ExpoGaodeMapModule.initSDK({
+  androidKey: 'your-android-key',
+  iosKey: 'your-ios-key',
+});
+
+⚠️  升级注意：
+1. 不能只 import 包后直接渲染 MapView
+2. Android 若未先设置隐私，原生 SDK 可能直接报 555570
+3. 推荐在应用首次启动时先弹出隐私协议，同意后再进入地图页面`,
+            docUrl: `${this.docBaseUrl}/guide/initialization.html`,
+        });
+    }
+    /**
+     * API Key 配置错误
+     */
+    static invalidApiKey(platform) {
+        const platformText = {
+            android: 'Android',
+            ios: 'iOS',
+            both: 'Android 和 iOS',
+        }[platform];
+        return new GaodeMapError({
+            type: ErrorType.INVALID_API_KEY,
+            message: `${platformText} API Key 配置错误或未配置`,
+            solution: `⚠️  API Key 与 Bundle ID 不匹配是最常见的原因！
+
+请检查以下步骤：
+
+1️⃣  确认 API Key 的配置：
+   • 访问高德开放平台：https://lbs.amap.com/
+   • 检查您的应用配置中的 Bundle ID 是否与当前项目一致
+   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier 查看
+   • Android 包名：在 android/app/build.gradle → applicationId 查看
+
+2️⃣  重新创建正确的 API Key（如果 Bundle ID 不同）：
+   • 在高德开放平台创建新应用
+   • 填写正确的 Bundle ID（iOS）或包名（Android）
+   • 获取新的 API Key
+
+3️⃣  配置 API Key（推荐使用 Config Plugin）：
+
+在 app.json 中配置：
+{
+  "expo": {
+    "plugins": [
+      [
+        "expo-gaode-map-navigation",
+        {
+          "androidKey": "your-android-key",
+          "iosKey": "your-ios-key"
+        }
+      ]
+    ]
+  }
+}
+
+然后重新构建：
+npx expo prebuild --clean
+npx expo run:${platform === 'ios' ? 'ios' : 'android'}
+
+4️⃣  或在代码中配置：
+ExpoGaodeMapModule.initSDK({
+  androidKey: 'your-android-key',
+  iosKey: 'your-ios-key',
+});`,
+            docUrl: `${this.docBaseUrl}/guide/initialization.html`,
+        });
+    }
+    /**
+     * 权限未授予错误
+     */
+    static permissionDenied(permissionType) {
+        return new GaodeMapError({
+            type: ErrorType.PERMISSION_DENIED,
+            message: '定位权限未授予，无法使用定位功能',
+            solution: `请按以下步骤授予权限：
+
+1️⃣  请求权限：
+import {ExpoGaodeMapModule} from 'expo-gaode-map-navigation';
+
+const checkPermission = async () => {
+  // 检查权限状态
+  const status = await ExpoGaodeMapModule.checkLocationPermission();
+  
+  if (!status.granted) {
+    // 请求权限
+    const result = await ExpoGaodeMapModule.requestLocationPermission();
+    
+    if (!result.granted) {
+      // 用户拒绝授权，引导用户去设置
+      Alert.alert(
+        '需要定位权限',
+        '请在设置中开启定位权限以使用地图功能',
+        [
+          { text: '取消', style: 'cancel' },
+          { text: '去设置', onPress: () => Linking.openSettings() }
+        ]
+      );
+    }
+  }
+};
+
+2️⃣  iOS 配置（在 app.json 中）：
+{
+  "expo": {
+    "ios": {
+      "infoPlist": {
+        "NSLocationWhenInUseUsageDescription": "需要获取您的位置信息以显示地图",
+        "NSLocationAlwaysAndWhenInUseUsageDescription": "需要获取您的位置信息"
+      }
+    }
+  }
+}
+
+3️⃣  Android 配置（Config Plugin 会自动添加）：
+使用 expo-gaode-map-navigation 的 Config Plugin 会自动添加必要的权限声明`,
+            docUrl: `${this.docBaseUrl}/guide/getting-started.html#权限配置`,
+        });
+    }
+    /**
+     * 定位失败错误
+     */
+    static locationFailed(reason) {
+        return new GaodeMapError({
+            type: ErrorType.LOCATION_FAILED,
+            message: `定位失败${reason ? `：${reason}` : ''}`,
+            solution: `⚠️  最常见原因：API Key 与 Bundle ID 不匹配！
+
+请按以下顺序排查：
+
+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); // 设置定位间隔
+
+// Android 特有配置
+ExpoGaodeMapModule.setLocationMode(2); // 高精度模式
+ExpoGaodeMapModule.setGpsFirst(true);  // GPS 优先
+
+// iOS 特有配置
+ExpoGaodeMapModule.setDesiredAccuracy(0); // 最佳精度`,
+            docUrl: `${this.docBaseUrl}/api/location.html`,
+        });
+    }
+    /**
+     * 原生模块不可用错误
+     */
+    static nativeModuleUnavailable() {
+        return new GaodeMapError({
+            type: ErrorType.NATIVE_MODULE_UNAVAILABLE,
+            message: 'expo-gaode-map-navigation 原生模块不可用',
+            solution: `请检查以下步骤：
+
+1️⃣  确认已正确安装：
+npm install expo-gaode-map-navigation
+# 或
+bun install expo-gaode-map-navigation
+
+2️⃣  重新构建原生代码：
+npx expo prebuild --clean
+npx expo run:android
+npx expo run:ios
+
+3️⃣  检查 Expo 版本兼容性：
+• expo-gaode-map-navigation 需要 Expo SDK 49+
+• 不支持 Expo Go，必须使用 Development Build
+
+4️⃣  检查是否与其他包冲突：
+• 不能同时安装 expo-gaode-map 和 expo-gaode-map-navigation
+• 两个包选择其一使用
+
+5️⃣  清理缓存后重试：
+cd android && ./gradlew clean && cd ..
+cd ios && pod deintegrate && pod install && cd ..`,
+            docUrl: `${this.docBaseUrl}/guide/getting-started.html`,
+        });
+    }
+    /**
+     * 地图视图未初始化错误
+     */
+    static mapViewNotInitialized(methodName) {
+        return new GaodeMapError({
+            type: ErrorType.MAP_VIEW_NOT_INITIALIZED,
+            message: `无法调用 ${methodName}：地图视图尚未初始化`,
+            solution: `请确保：
+
+1️⃣  MapView 已经渲染完成
+2️⃣  使用 ref 获取地图实例后再调用方法
+
+正确用法：
+import { MapView, MapViewRef } from 'expo-gaode-map-navigation';
+
+const App = () => {
+  const mapRef = useRef<MapViewRef>(null);
+  
+  // ❌ 错误：在渲染前调用
+  // mapRef.current?.moveCamera(...);
+  
+  // ✅ 正确：等待地图加载完成
+  const handleMapReady = () => {
+    mapRef.current?.moveCamera({
+      target: { latitude: 39.9, longitude: 116.4 },
+      zoom: 15,
+    });
+  };
+  
+  return (
+    <MapView
+      ref={mapRef}
+      onMapReady={handleMapReady}
+    />
+  );
+};`,
+            docUrl: `${this.docBaseUrl}/api/mapview.html`,
+        });
+    }
+    /**
+     * 参数错误
+     */
+    static invalidParameter(paramName, expected, received) {
+        return new GaodeMapError({
+            type: ErrorType.INVALID_PARAMETER,
+            message: `参数 "${paramName}" 类型错误`,
+            solution: `期望类型：${expected}
+实际接收：${typeof received} (${JSON.stringify(received)})
+
+请检查传入的参数是否符合要求。
+
+💡 提示：
+• 使用 TypeScript 可以在编译时发现类型错误
+• 参考 API 文档了解正确的参数类型`,
+            docUrl: `${this.docBaseUrl}/api/`,
+        });
+    }
+    /**
+     * 网络错误
+     */
+    static networkError(originalError) {
+        return new GaodeMapError({
+            type: ErrorType.NETWORK_ERROR,
+            message: '网络请求失败',
+            solution: `请检查：
+
+1️⃣  网络连接是否正常
+2️⃣  API Key 是否有效
+3️⃣  是否超出配额限制
+
+💡 如果问题持续，请：
+• 检查高德开放平台控制台
+• 查看 API 调用量和配额
+• 确认 Key 的服务是否已开通`,
+            docUrl: `${this.docBaseUrl}/guide/troubleshooting.html`,
+            originalError,
+        });
+    }
+    /**
+     * 包装原生错误，提供更友好的提示
+     */
+    static wrapNativeError(error, context) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const scene = context.includes('MapView') || context.includes('渲染') ? 'map' : 'sdk';
+        if (errorMessage.includes('PRIVACY_NOT_AGREED') ||
+            errorMessage.includes('隐私协议未完成确认') ||
+            errorMessage.includes('隐私合规校验失败') ||
+            errorMessage.includes('555570') ||
+            errorMessage.includes('确保调用SDK任何接口前先调用更新隐私合规')) {
+            return this.privacyNotAgreed(scene);
+        }
+        // SDK 未初始化相关错误
+        if (errorMessage.includes('not initialized') ||
+            errorMessage.includes('未初始化') ||
+            errorMessage.includes('SDK未设置')) {
+            return this.sdkNotInitialized();
+        }
+        // API Key 相关错误
+        if (errorMessage.includes('key') ||
+            errorMessage.includes('invalid') ||
+            errorMessage.includes('鉴权失败')) {
+            return this.invalidApiKey('both');
+        }
+        // 权限相关错误
+        if (errorMessage.includes('permission') ||
+            errorMessage.includes('权限')) {
+            return this.permissionDenied('location');
+        }
+        // 定位相关错误
+        if (errorMessage.includes('location') ||
+            errorMessage.includes('定位')) {
+            return this.locationFailed(errorMessage);
+        }
+        // 通用错误
+        return new GaodeMapError({
+            type: ErrorType.INVALID_PARAMETER,
+            message: `${context} 失败`,
+            solution: `原始错误信息：${errorMessage}
+
+如果问题持续，请：
+1. 查看完整的错误堆栈
+2. 检查 API 调用参数
+3. 提交 Issue：https://github.com/TomWq/expo-gaode-map/issues`,
+            originalError: error instanceof Error ? error : undefined,
+        });
+    }
+}
+/**
+ * 错误日志工具
+ */
+export class ErrorLogger {
+    // 兼容不同环境：Bun/Jest/Node
+    static isEnabled = typeof __DEV__ !== 'undefined' ? __DEV__ : true;
+    /**
+     * 启用/禁用错误日志
+     */
+    static setEnabled(enabled) {
+        this.isEnabled = enabled;
+    }
+    /**
+     * 记录错误
+     */
+    static log(error) {
+        if (!this.isEnabled)
+            return;
+        console.error(error.message);
+        if (error.originalError) {
+            console.error('原始错误：', error.originalError);
+        }
+    }
+    /**
+     * 记录警告
+     */
+    static warn(message, details) {
+        if (!this.isEnabled)
+            return;
+        console.warn(`⚠️  expo-gaode-map-navigation: ${message}`, details || '');
+    }
+    /**
+     * 记录调试信息
+     */
+    static info(message, details) {
+        if (!this.isEnabled)
+            return;
+        console.info(`expo-gaode-map-navigation: ${message}`, details || '');
+    }
+}
+//# sourceMappingURL=ErrorHandler.js.map

package/build/src/map/utils/ErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../../../src/map/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  /** 隐私协议未确认 */\n  PRIVACY_NOT_AGREED = 'PRIVACY_NOT_AGREED',\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-navigation';\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   * 隐私协议未确认错误\n   */\n  static privacyNotAgreed(scene: 'map' | 'sdk'): GaodeMapError {\n    const sceneText = scene === 'map' ? '渲染 MapView' : '初始化 SDK';\n    return new GaodeMapError({\n      type: ErrorType.PRIVACY_NOT_AGREED,\n      message: `调用高德地图前未完成隐私合规确认：${sceneText}`,\n      solution: `请在调用任何高德地图 SDK 接口前，先明确完成隐私告知与同意：\n\nimport {ExpoGaodeMapModule} from 'expo-gaode-map-navigation';\n\n// 应用启动后，先展示你自己的隐私弹窗\nExpoGaodeMapModule.setPrivacyConfig({\n  hasShow: true,\n  hasContainsPrivacy: true,\n  hasAgree: true,\n});\n\n// 然后再初始化 SDK / 渲染地图\nExpoGaodeMapModule.initSDK({\n  androidKey: 'your-android-key',\n  iosKey: 'your-ios-key',\n});\n\n⚠️  升级注意：\n1. 不能只 import 包后直接渲染 MapView\n2. Android 若未先设置隐私，原生 SDK 可能直接报 555570\n3. 推荐在应用首次启动时先弹出隐私协议，同意后再进入地图页面`,\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-navigation\",\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-navigation';\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-navigation 的 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-navigation 原生模块不可用',\n      solution: `请检查以下步骤：\n\n1️⃣  确认已正确安装：\nnpm install expo-gaode-map-navigation\n# 或\nbun install expo-gaode-map-navigation\n\n2️⃣  重新构建原生代码：\nnpx expo prebuild --clean\nnpx expo run:android\nnpx expo run:ios\n\n3️⃣  检查 Expo 版本兼容性：\n• expo-gaode-map-navigation 需要 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-navigation';\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: unknown): 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: unknown, context: string): GaodeMapError {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const scene = context.includes('MapView') || context.includes('渲染') ? 'map' : 'sdk';\n\n    if (\n      errorMessage.includes('PRIVACY_NOT_AGREED') ||\n      errorMessage.includes('隐私协议未完成确认') ||\n      errorMessage.includes('隐私合规校验失败') ||\n      errorMessage.includes('555570') ||\n      errorMessage.includes('确保调用SDK任何接口前先调用更新隐私合规')\n    ) {\n      return this.privacyNotAgreed(scene);\n    }\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?: unknown) {\n    if (!this.isEnabled) return;\n    \n    console.warn(`⚠️  expo-gaode-map-navigation: ${message}`, details || '');\n  }\n\n  /**\n   * 记录调试信息\n   */\n  static info(message: string, details?: unknown) {\n    if (!this.isEnabled) return;\n\n    console.info(`expo-gaode-map-navigation: ${message}`, details || '');\n  }\n}\n"]}

package/build/src/map/utils/GeoUtils.d.ts

@@ -0,0 +1,21 @@
+import { LatLng, LatLngPoint } from '../types/common.types';
+/**
+ * 将坐标点归一化为对象格式
+ * 支持 [longitude, latitude] 数组或 { latitude, longitude } 对象
+ * 注意：数组格式遵循 GeoJSON 标准，即 [经度, 纬度]
+ *
+ * @param point 坐标点
+ * @returns { latitude, longitude } 对象
+ */
+export declare function normalizeLatLng(point: LatLngPoint): LatLng;
+/**
+ * 将坐标点数组归一化为对象数组
+ * 支持一维数组 [p1, p2, ...] 或二维嵌套数组 [[p1, p2, ...], [p3, p4, ...]]
+ *
+ * @param points 坐标点数组或嵌套数组
+ * @returns 归一化后的坐标数组
+ */
+export declare function normalizeLatLngList(points: LatLngPoint[]): LatLng[];
+export declare function normalizeLatLngList(points: LatLngPoint[][]): LatLng[][];
+export declare function normalizeLatLngList(points: LatLngPoint[] | LatLngPoint[][]): LatLng[] | LatLng[][];
+//# sourceMappingURL=GeoUtils.d.ts.map

package/build/src/map/utils/GeoUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoUtils.d.ts","sourceRoot":"","sources":["../../../../src/map/utils/GeoUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAO5D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA2B1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC;AACrE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC"}

package/build/src/map/utils/GeoUtils.js

@@ -0,0 +1,78 @@
+import { LatLng, LatLngPoint } from '../types/common.types';
+/**
+ * 将坐标点归一化为对象格式
+ * 支持 [longitude, latitude] 数组或 { latitude, longitude } 对象
+ * 注意：数组格式遵循 GeoJSON 标准，即 [经度, 纬度]
+ *
+ * @param point 坐标点
+ * @returns { latitude, longitude } 对象
+ */
+export function normalizeLatLng(point) {
+    if (Array.isArray(point)) {
+        let longitude = point[0];
+        let latitude = point[1];
+        // 智能纠错：如果纬度超出范围 [-90, 90] 且交换后在范围内，则认为是用户传反了
+        if (Math.abs(latitude) > 90 && Math.abs(longitude) <= 90) {
+            console.warn(`[expo-gaode-map] 检测到坐标数组格式可能为 [latitude, longitude] (${point})，已自动纠正为 [longitude, latitude]。建议显式使用 [经度, 纬度] 格式以遵循 GeoJSON 标准。`);
+            return {
+                latitude: longitude,
+                longitude: latitude
+            };
+        }
+        return {
+            longitude,
+            latitude,
+        };
+    }
+    // 对象格式：强制转换为数字，防止传入 string 类型导致原生层 Crash
+    const normalizedPoint = point;
+    return {
+        latitude: Number(normalizedPoint.latitude),
+        longitude: Number(normalizedPoint.longitude),
+    };
+}
+export function normalizeLatLngList(points) {
+    if (!points || points.length === 0)
+        return [];
+    // 检查是否为嵌套数组 (检查第一项是否也是数组或对象，且不符合 LatLngPoint 的基本判断)
+    // 如果第一项是数组且长度 > 2，或者第一项的第一个元素也是数组/对象，则认为是嵌套数组
+    const firstItem = points[0];
+    if (Array.isArray(firstItem)) {
+        // 如果第一项是 [number, number]，则这可能是一个一维坐标点数组 (LatLngPoint[])
+        // 除非所有元素都是数组且至少有一个子数组长度不等于2，或者我们明确知道这是嵌套的
+        // 为了支持 Polygon 的嵌套格式，我们需要递归处理
+        // 启发式判断：如果第一项是数组且它的第一个元素也是数组或对象，那么它一定是嵌套的
+        if (Array.isArray(firstItem[0]) || (typeof firstItem[0] === 'object' && firstItem[0] !== null && 'latitude' in firstItem[0])) {
+            return points.map(ring => ring.map(normalizeLatLng));
+        }
+        // 另一种情况：用户传入的是 [[lng, lat], [lng, lat]]，这既可以看作 LatLngPoint[]，
+        // 也可以看作 LatLngPoint[][] (只有一个外轮廓)。
+        // 在 Polygon 组件中，我们希望统一处理。
+        // 如果是 Polygon 传入的，我们希望保留嵌套结构。
+        // 但 normalizeLatLngList 是通用的。
+        // 改进逻辑：如果 data[0] 是一个点，我们把它当作一维数组处理。
+        // 如果 data[0] 不是一个点（即它是点的集合），我们当作二维处理。
+        if (isPoint(firstItem)) {
+            return points.map(normalizeLatLng);
+        }
+        else {
+            return points.map(ring => ring.map(normalizeLatLng));
+        }
+    }
+    return points.map(normalizeLatLng);
+}
+/**
+ * 判断一个对象是否为坐标点 (LatLngPoint)
+ */
+function isPoint(item) {
+    if (!item || typeof item !== 'object')
+        return false;
+    // { latitude, longitude } 格式
+    if ('latitude' in item && 'longitude' in item)
+        return true;
+    // [longitude, latitude] 格式
+    if (Array.isArray(item) && item.length >= 2 && typeof item[0] === 'number' && typeof item[1] === 'number')
+        return true;
+    return false;
+}
+//# sourceMappingURL=GeoUtils.js.map

package/build/src/map/utils/GeoUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoUtils.js","sourceRoot":"","sources":["../../../../src/map/utils/GeoUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { LatLng, LatLngPoint } from '../types/common.types';\n\ntype LatLngLike = {\n  latitude?: unknown;\n  longitude?: unknown;\n};\n\n/**\n * 将坐标点归一化为对象格式\n * 支持 [longitude, latitude] 数组或 { latitude, longitude } 对象\n * 注意：数组格式遵循 GeoJSON 标准，即 [经度, 纬度]\n * \n * @param point 坐标点\n * @returns { latitude, longitude } 对象\n */\nexport function normalizeLatLng(point: LatLngPoint): LatLng {\n  if (Array.isArray(point)) {\n    let longitude = point[0];\n    let latitude = point[1];\n\n    // 智能纠错：如果纬度超出范围 [-90, 90] 且交换后在范围内，则认为是用户传反了\n    if (Math.abs(latitude) > 90 && Math.abs(longitude) <= 90) {\n      console.warn(\n        `[expo-gaode-map] 检测到坐标数组格式可能为 [latitude, longitude] (${point})，已自动纠正为 [longitude, latitude]。建议显式使用 [经度, 纬度] 格式以遵循 GeoJSON 标准。`\n      );\n      return {\n        latitude: longitude,\n        longitude: latitude\n      };\n    }\n\n    return {\n      longitude,\n      latitude,\n    };\n  }\n  // 对象格式：强制转换为数字，防止传入 string 类型导致原生层 Crash\n  const normalizedPoint = point as LatLngLike;\n  return {\n    latitude: Number(normalizedPoint.latitude),\n    longitude: Number(normalizedPoint.longitude),\n  };\n}\n\n/**\n * 将坐标点数组归一化为对象数组\n * 支持一维数组 [p1, p2, ...] 或二维嵌套数组 [[p1, p2, ...], [p3, p4, ...]]\n * \n * @param points 坐标点数组或嵌套数组\n * @returns 归一化后的坐标数组\n */\nexport function normalizeLatLngList(points: LatLngPoint[]): LatLng[];\nexport function normalizeLatLngList(points: LatLngPoint[][]): LatLng[][];\nexport function normalizeLatLngList(points: LatLngPoint[] | LatLngPoint[][]): LatLng[] | LatLng[][];\nexport function normalizeLatLngList(\n  points: LatLngPoint[] | LatLngPoint[][]\n): LatLng[] | LatLng[][] {\n  if (!points || points.length === 0) return [];\n\n  // 检查是否为嵌套数组 (检查第一项是否也是数组或对象，且不符合 LatLngPoint 的基本判断)\n  // 如果第一项是数组且长度 > 2，或者第一项的第一个元素也是数组/对象，则认为是嵌套数组\n  const firstItem = points[0];\n  \n  if (Array.isArray(firstItem)) {\n    // 如果第一项是 [number, number]，则这可能是一个一维坐标点数组 (LatLngPoint[])\n    // 除非所有元素都是数组且至少有一个子数组长度不等于2，或者我们明确知道这是嵌套的\n    // 为了支持 Polygon 的嵌套格式，我们需要递归处理\n    \n    // 启发式判断：如果第一项是数组且它的第一个元素也是数组或对象，那么它一定是嵌套的\n    if (Array.isArray(firstItem[0]) || (typeof firstItem[0] === 'object' && firstItem[0] !== null && 'latitude' in firstItem[0])) {\n      return (points as LatLngPoint[][]).map(ring => ring.map(normalizeLatLng));\n    }\n    \n    // 另一种情况：用户传入的是 [[lng, lat], [lng, lat]]，这既可以看作 LatLngPoint[]，\n    // 也可以看作 LatLngPoint[][] (只有一个外轮廓)。\n    // 在 Polygon 组件中，我们希望统一处理。\n    // 如果是 Polygon 传入的，我们希望保留嵌套结构。\n    // 但 normalizeLatLngList 是通用的。\n    \n    // 改进逻辑：如果 data[0] 是一个点，我们把它当作一维数组处理。\n    // 如果 data[0] 不是一个点（即它是点的集合），我们当作二维处理。\n    if (isPoint(firstItem)) {\n      return (points as LatLngPoint[]).map(normalizeLatLng);\n    } else {\n      return (points as LatLngPoint[][]).map(ring => ring.map(normalizeLatLng));\n    }\n  }\n\n  return (points as LatLngPoint[]).map(normalizeLatLng);\n}\n\n/**\n * 判断一个对象是否为坐标点 (LatLngPoint)\n */\nfunction isPoint(item: unknown): item is LatLngPoint {\n  if (!item || typeof item !== 'object') return false;\n  // { latitude, longitude } 格式\n  if ('latitude' in item && 'longitude' in (item as Record<string, unknown>)) return true;\n  // [longitude, latitude] 格式\n  if (Array.isArray(item) && item.length >= 2 && typeof item[0] === 'number' && typeof item[1] === 'number') return true;\n  return false;\n}\n"]}