expo-gaode-map-navigation 1.0.1-next.0

package/plugin/build/withGaodeMap.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+/**
+ * iOS: 修改 Info.plist 添加 API Key 和权限
+ */
+const withGaodeMapInfoPlist = (config, props) => {
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        // 添加高德地图 API Key
+        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')) {
+                    config.modResults.UIBackgroundModes.push('location');
+                }
+            }
+        }
+        return config;
+    });
+};
+/**
+ * iOS: 注意 - 不再需要修改 AppDelegate
+ *
+ * 高德地图 SDK 已经支持从 Info.plist 自动读取 API Key
+ * 并且我们在 ExpoGaodeMapModule.swift 中提供了 initSDK 方法
+ * 用户可以选择以下任一方式初始化：
+ * 1. 通过 Info.plist 中的 AMapApiKey 字段（自动读取）
+ * 2. 通过 JavaScript 调用 ExpoGaodeMap.initSDK({ iosKey: 'your-key' })
+ */
+/**
+ * Android: 修改 AndroidManifest.xml 添加 API Key 和权限
+ */
+const withGaodeMapAndroidManifest = (config, props) => {
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const androidManifest = config.modResults.manifest;
+        // 添加基础权限（高德地图 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.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 },
+                });
+            }
+        });
+        // 后台定位权限（可选，仅在 enableBackgroundLocation 为 true 时添加）
+        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 },
+                    });
+                }
+            });
+        }
+        // 添加前台服务（如果启用后台定位）
+        const mainApplication = androidManifest.application?.[0];
+        if (mainApplication && props.enableBackgroundLocation) {
+            if (!mainApplication['service']) {
+                mainApplication['service'] = [];
+            }
+            // 检查是否已存在 LocationForegroundService
+            const hasService = mainApplication['service'].some((item) => item.$?.['android:name'] === 'expo.modules.gaodemap.services.LocationForegroundService');
+            if (!hasService) {
+                mainApplication['service'].push({
+                    $: {
+                        'android:name': 'expo.modules.gaodemap.services.LocationForegroundService',
+                        'android:enabled': 'true',
+                        'android:exported': 'false',
+                        'android:foregroundServiceType': 'location',
+                    },
+                });
+            }
+        }
+        // 添加 API Key 到 application 标签
+        if (mainApplication && props.androidApiKey) {
+            if (!mainApplication['meta-data']) {
+                mainApplication['meta-data'] = [];
+            }
+            // 检查是否已存在
+            const hasApiKey = mainApplication['meta-data'].some((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
+            if (!hasApiKey) {
+                mainApplication['meta-data'].push({
+                    $: {
+                        'android:name': 'com.amap.api.v2.apikey',
+                        'android:value': props.androidApiKey,
+                    },
+                });
+            }
+            else {
+                // 更新现有的 API Key
+                const apiKeyIndex = mainApplication['meta-data'].findIndex((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
+                if (apiKeyIndex !== -1) {
+                    mainApplication['meta-data'][apiKeyIndex].$ = {
+                        'android:name': 'com.amap.api.v2.apikey',
+                        'android:value': props.androidApiKey,
+                    };
+                }
+            }
+        }
+        return config;
+    });
+};
+/**
+ * Android: 修改 app/build.gradle（预留扩展）
+ */
+const withGaodeMapAppBuildGradle = (config, props) => {
+    return (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
+        // Android 3D 地图 SDK 10.0+ 已内置搜索功能
+        // 不需要额外的 Gradle 配置
+        return config;
+    });
+};
+/**
+ * 主插件函数 - 组合所有修改器
+ */
+const withGaodeMap = (config, props = {}) => {
+    // 验证配置
+    if (!props.iosApiKey && !props.androidApiKey) {
+        config_plugins_1.WarningAggregator.addWarningIOS('expo-gaode-map-navigation', '未配置 API Key。请在 app.json 的 plugins 中配置 iosApiKey 和 androidApiKey');
+    }
+    // 应用 iOS 配置
+    config = withGaodeMapInfoPlist(config, props);
+    // 注意：不再需要修改 AppDelegate，因为：
+    // 1. SDK 会自动从 Info.plist 读取 AMapApiKey
+    // 2. 可以通过 ExpoGaodeMapModule.initSDK() 方法初始化
+    // 应用 Android 配置
+    config = withGaodeMapAndroidManifest(config, props);
+    config = withGaodeMapAppBuildGradle(config, props);
+    return config;
+};
+/**
+ * 导出为可运行一次的插件
+ * 这确保插件只会运行一次，即使在配置中被多次引用
+ */
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withGaodeMap, 'expo-gaode-map-navigation', '1.0.0');

package/plugin/src/withGaodeMap.ts

@@ -0,0 +1,231 @@
+import {
+  ConfigPlugin,
+  withInfoPlist,
+  withAndroidManifest,
+  withAppBuildGradle,
+  createRunOncePlugin,
+  WarningAggregator,
+} from '@expo/config-plugins';
+
+/**
+ * 高德地图插件配置类型
+ */
+export type GaodeMapPluginProps = {
+  /** iOS 平台 API Key */
+  iosApiKey?: string;
+  /** Android 平台 API Key */
+  androidApiKey?: string;
+  /** 是否启用定位功能 */
+  enableLocation?: boolean;
+  /** iOS 定位权限描述 */
+  locationDescription?: string;
+  /** 是否启用后台定位（Android & iOS） */
+  enableBackgroundLocation?: boolean;
+};
+
+/**
+ * iOS: 修改 Info.plist 添加 API Key 和权限
+ */
+const withGaodeMapInfoPlist: ConfigPlugin<GaodeMapPluginProps> = (config, props) => {
+  return withInfoPlist(config, (config) => {
+    // 添加高德地图 API Key
+    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')) {
+          config.modResults.UIBackgroundModes.push('location');
+        }
+      }
+    }
+
+    return config;
+  });
+};
+
+/**
+ * iOS: 注意 - 不再需要修改 AppDelegate
+ *
+ * 高德地图 SDK 已经支持从 Info.plist 自动读取 API Key
+ * 并且我们在 ExpoGaodeMapModule.swift 中提供了 initSDK 方法
+ * 用户可以选择以下任一方式初始化：
+ * 1. 通过 Info.plist 中的 AMapApiKey 字段（自动读取）
+ * 2. 通过 JavaScript 调用 ExpoGaodeMap.initSDK({ iosKey: 'your-key' })
+ */
+
+/**
+ * Android: 修改 AndroidManifest.xml 添加 API Key 和权限
+ */
+const withGaodeMapAndroidManifest: ConfigPlugin<GaodeMapPluginProps> = (config, props) => {
+  return withAndroidManifest(config, (config) => {
+    const androidManifest = config.modResults.manifest;
+
+    // 添加基础权限（高德地图 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.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 },
+        });
+      }
+    });
+
+    // 后台定位权限（可选，仅在 enableBackgroundLocation 为 true 时添加）
+    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 },
+          });
+        }
+      });
+    }
+
+    // 添加前台服务（如果启用后台定位）
+    const mainApplication = androidManifest.application?.[0];
+    if (mainApplication && props.enableBackgroundLocation) {
+      if (!mainApplication['service']) {
+        mainApplication['service'] = [];
+      }
+
+      // 检查是否已存在 LocationForegroundService
+      const hasService = mainApplication['service'].some(
+        (item) => item.$?.['android:name'] === 'expo.modules.gaodemap.services.LocationForegroundService'
+      );
+
+      if (!hasService) {
+        mainApplication['service'].push({
+          $: {
+            'android:name': 'expo.modules.gaodemap.services.LocationForegroundService',
+            'android:enabled': 'true',
+            'android:exported': 'false',
+            'android:foregroundServiceType': 'location',
+          },
+        });
+      }
+    }
+
+    // 添加 API Key 到 application 标签
+    if (mainApplication && props.androidApiKey) {
+      if (!mainApplication['meta-data']) {
+        mainApplication['meta-data'] = [];
+      }
+
+      // 检查是否已存在
+      const hasApiKey = mainApplication['meta-data'].some(
+        (item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey'
+      );
+
+      if (!hasApiKey) {
+        mainApplication['meta-data'].push({
+          $: {
+            'android:name': 'com.amap.api.v2.apikey',
+            'android:value': props.androidApiKey,
+          },
+        });
+      } else {
+        // 更新现有的 API Key
+        const apiKeyIndex = mainApplication['meta-data'].findIndex(
+          (item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey'
+        );
+        if (apiKeyIndex !== -1) {
+          mainApplication['meta-data'][apiKeyIndex].$ = {
+            'android:name': 'com.amap.api.v2.apikey',
+            'android:value': props.androidApiKey,
+          };
+        }
+      }
+    }
+
+    return config;
+  });
+};
+
+/**
+ * Android: 修改 app/build.gradle（预留扩展）
+ */
+const withGaodeMapAppBuildGradle: ConfigPlugin<GaodeMapPluginProps> = (config, props) => {
+  return withAppBuildGradle(config, (config) => {
+    // Android 3D 地图 SDK 10.0+ 已内置搜索功能
+    // 不需要额外的 Gradle 配置
+    return config;
+  });
+};
+
+/**
+ * 主插件函数 - 组合所有修改器
+ */
+const withGaodeMap: ConfigPlugin<GaodeMapPluginProps> = (config, props = {}) => {
+  // 验证配置
+  if (!props.iosApiKey && !props.androidApiKey) {
+    WarningAggregator.addWarningIOS(
+      'expo-gaode-map-navigation',
+      '未配置 API Key。请在 app.json 的 plugins 中配置 iosApiKey 和 androidApiKey'
+    );
+  }
+
+  // 应用 iOS 配置
+  config = withGaodeMapInfoPlist(config, props);
+  // 注意：不再需要修改 AppDelegate，因为：
+  // 1. SDK 会自动从 Info.plist 读取 AMapApiKey
+  // 2. 可以通过 ExpoGaodeMapModule.initSDK() 方法初始化
+
+  // 应用 Android 配置
+  config = withGaodeMapAndroidManifest(config, props);
+  config = withGaodeMapAppBuildGradle(config, props);
+
+  return config;
+};
+
+/**
+ * 导出为可运行一次的插件
+ * 这确保插件只会运行一次，即使在配置中被多次引用
+ */
+export default createRunOncePlugin(withGaodeMap, 'expo-gaode-map-navigation', '1.0.0');

package/plugin/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/withgaodemap.ts"],"version":"5.9.3"}

package/src/ExpoGaodeMapNaviView.tsx

@@ -0,0 +1,94 @@
+/*
+ * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @Date         : 2025-12-03 20:12:54
+ * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
+ * @LastEditTime : 2025-12-05 12:37:28
+ * @FilePath     : /expo-gaode-map/packages/navigation/src/ExpoGaodeMapNaviView.tsx
+ * @Description  : 
+ * 
+ * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
+ */
+import { requireNativeViewManager } from 'expo-modules-core';
+import * as React from 'react';
+import type { Coordinates, NaviViewProps } from './types';
+
+/**
+ * NaviView Ref 类型
+ */
+export interface NaviViewRef {
+  /**
+   * 开始导航
+   */
+  startNavigation: (start: Coordinates | null, end: Coordinates, type: number) => Promise<void>;
+  
+  /**
+   * 停止导航
+   */
+  stopNavigation: () => Promise<void>;
+}
+
+
+const NativeView: React.ComponentType<NaviViewProps & { ref?: React.Ref<any> }> = requireNativeViewManager('ExpoGaodeMapNaviView');
+
+/**
+ * 高德导航视图组件
+ *
+ * 使用高德官方的导航界面，提供完整的导航体验，包括：
+ * - 路线规划和显示
+ * - 实时导航信息（距离、时间、道路名称）
+ * - 转向箭头和提示
+ * - 路况信息
+ * - 摄像头提示
+ * - 语音播报
+ *
+ * @example
+ * ```tsx
+ * import { NaviView } from 'expo-gaode-map-navigation';
+ *
+ * function NavigationScreen() {
+ *   return (
+ *     <NaviView
+ *       style={{ flex: 1 }}
+ *       naviType={0} // GPS 导航
+ *       showCamera={true}
+ *       enableVoice={true}
+ *       onNaviInfoUpdate={(e) => {
+ *         console.log('剩余距离:', e.nativeEvent.pathRetainDistance);
+ *       }}
+ *       onArrive={() => {
+ *         console.log('到达目的地！');
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export const NaviView = React.forwardRef<NaviViewRef, NaviViewProps>((props, ref) => {
+  const nativeRef = React.useRef<any>(null);
+  
+  // 创建 API 引用
+  const apiRef: NaviViewRef = React.useMemo(() => ({
+    startNavigation: async (start: Coordinates | null, end: Coordinates, type: number) => {
+      if (!nativeRef.current) throw new Error('NaviView not initialized');
+      // 将对象解构为单独的参数传递给原生层
+      const startLat = start?.latitude ?? 0;
+      const startLng = start?.longitude ?? 0;
+      const endLat = end.latitude;
+      const endLng = end.longitude;
+      return nativeRef.current.startNavigation(startLat, startLng, endLat, endLng);
+    },
+    stopNavigation: async () => {
+      if (!nativeRef.current) throw new Error('NaviView not initialized');
+      return nativeRef.current.stopNavigation();
+    },
+  }), []);
+  
+  // 暴露 API 给外部 ref
+  React.useImperativeHandle(ref, () => apiRef, [apiRef]);
+  
+  return <NativeView ref={nativeRef} {...props} />;
+});
+
+NaviView.displayName = 'NaviView';
+
+export default NaviView;

package/src/ExpoGaodeMapNavigation.types.ts

@@ -0,0 +1,3 @@
+
+// 重新导出所有类型，保持向后兼容
+export * from './types';

package/src/ExpoGaodeMapNavigationModule.ts

@@ -0,0 +1,11 @@
+
+import { requireNativeModule } from 'expo-modules-core';
+
+/**
+ * 高德地图导航模块
+ * 
+ * 提供路径规划功能，包括驾车、步行、骑行、公交、货车等多种出行方式
+ */
+const ExpoGaodeMapNavigationModule = requireNativeModule('ExpoGaodeMapNavigation');
+
+export default ExpoGaodeMapNavigationModule;