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

package/plugin/src/withGaodeMap.ts

@@ -1,231 +0,0 @@
-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

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

package/src/ExpoGaodeMapNaviView.tsx

@@ -1,94 +0,0 @@
-/*
- * @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

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

package/src/ExpoGaodeMapNavigationModule.ts

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

package/src/index.ts

@@ -1,262 +0,0 @@
-import ExpoGaodeMapNavigationModule from './ExpoGaodeMapNavigationModule';
-
-// 重新导出地图模块的所有内容
-export * from './map';
-import {
-  RouteType,
-  DriveStrategy,
-  WalkStrategy,
-  RideStrategy,
-  TruckSize,
-  TravelStrategy,
-} from './types';
-import type {
-  NaviPoint,
-  RouteOptions,
-  DriveRouteOptions,
-  WalkRouteOptions,
-  RideRouteOptions,
-  EBikeRouteOptions,
-  TruckRouteOptions,
-  RouteResult,
-  DriveRouteResult,
-  IndependentRouteResult,
-  IndependentDriveRouteOptions,
-  IndependentTruckRouteOptions,
-  IndependentWalkRouteOptions,
-  IndependentRideRouteOptions,
-  SelectIndependentRouteOptions,
-  StartNaviWithIndependentPathOptions,
-  ClearIndependentRouteOptions,
-  MotorcycleRouteOptions,
-  IndependentMotorcycleRouteOptions,
-} from './types';
-
-// 导出官方导航界面组件
-export { NaviView, type NaviViewRef } from './ExpoGaodeMapNaviView';
-
-
-
-/**
- * 初始化导航模块（可选）
- */
-export function initNavigation(): void {
-  ExpoGaodeMapNavigationModule.initNavigation();
-}
-
-/**
- * 销毁所有路径计算器实例
- * 用于页面切换时释放资源，避免"Another route calculation is in progress"错误
- */
-export function destroyAllCalculators(): void {
-  ExpoGaodeMapNavigationModule.destroyAllCalculators();
-}
-
-/**
- * 路径规划（通用方法）
- * 注意：公交路径规划暂未实现
- */
-export async function calculateRoute(
-  options: RouteOptions
-): Promise<RouteResult | DriveRouteResult> {
-  // 根据传入的选项类型调用对应的方法
-  if ('carNumber' in options || 'avoidPolygons' in options) {
-    // 驾车或摩托车
-    return await calculateDriveRoute(options as DriveRouteOptions);
-  } else if ('size' in options) {
-    // 货车
-    return await calculateTruckRoute(options as TruckRouteOptions);
-  } else if ('multiple' in options || 'travelStrategy' in options) {
-    // 步行或骑行
-    if ('usePoi' in options) {
-      // 电动车
-      return await calculateEBikeRoute(options as EBikeRouteOptions);
-    } else if ((options as any).strategy === 0 || (options as any).strategy === 1) {
-      // 骑行
-      return await calculateRideRoute(options as RideRouteOptions);
-    } else {
-      // 步行
-      return await calculateWalkRoute(options as WalkRouteOptions);
-    }
-  } else {
-    // 默认当作驾车处理
-    return await calculateDriveRoute(options as DriveRouteOptions);
-  }
-}
-
-/**
- * 驾车路径规划
- */
-export async function calculateDriveRoute(
-  options: DriveRouteOptions
-): Promise<DriveRouteResult> {
-  return await ExpoGaodeMapNavigationModule.calculateDriveRoute(options);
-}
-
-/**
- * 步行路径规划
- */
-export async function calculateWalkRoute(
-  options: WalkRouteOptions
-): Promise<RouteResult> {
-  return await ExpoGaodeMapNavigationModule.calculateWalkRoute(options);
-}
-
-/**
- * 骑行路径规划
- */
-export async function calculateRideRoute(
-  options: RideRouteOptions
-): Promise<RouteResult> {
-  return await ExpoGaodeMapNavigationModule.calculateRideRoute(options);
-}
-
-/**
- * 骑行电动车路径规划
- */
-export async function calculateEBikeRoute(
-  options: EBikeRouteOptions
-): Promise<RouteResult> {
-  return await (ExpoGaodeMapNavigationModule as any).calculateEBikeRoute(options);
-}
-
-/**
- * 货车路径规划
- */
-export async function calculateTruckRoute(
-  options: TruckRouteOptions
-): Promise<DriveRouteResult> {
-  return await ExpoGaodeMapNavigationModule.calculateTruckRoute(options);
-}
-
-/**
- * 摩托车路径规划（车类型为 11，支持传入排量）
- */
-export async function calculateMotorcycleRoute(
-  options: MotorcycleRouteOptions
-): Promise<DriveRouteResult> {
-  return await ExpoGaodeMapNavigationModule.calculateMotorcycleRoute(options as any);
-}
-
-/**
-* 独立路径规划（不会影响当前导航；适合路线预览/行前选路）
-*/
-export async function independentDriveRoute(
- options: IndependentDriveRouteOptions
-): Promise<IndependentRouteResult> {
- return await ExpoGaodeMapNavigationModule.independentDriveRoute(options);
-}
-
-export async function independentTruckRoute(
- options: IndependentTruckRouteOptions
-): Promise<IndependentRouteResult> {
- return await ExpoGaodeMapNavigationModule.independentTruckRoute(options);
-}
-
-export async function independentWalkRoute(
- options: IndependentWalkRouteOptions
-): Promise<IndependentRouteResult> {
- return await ExpoGaodeMapNavigationModule.independentWalkRoute(options);
-}
-
-export async function independentRideRoute(
-  options: IndependentRideRouteOptions
-): Promise<IndependentRouteResult> {
-  return await ExpoGaodeMapNavigationModule.independentRideRoute(options);
-}
-
-/**
- * 独立摩托车路径规划（不干扰当前导航）
- */
-export async function independentMotorcycleRoute(
-  options: IndependentMotorcycleRouteOptions
-): Promise<IndependentRouteResult> {
-  return await ExpoGaodeMapNavigationModule.independentMotorcycleRoute(options as any);
-}
-
-/**
- * 独立路径组：选主路线
- */
-export async function selectIndependentRoute(
-  options: SelectIndependentRouteOptions
-): Promise<boolean> {
-  return await ExpoGaodeMapNavigationModule.selectIndependentRoute(options);
-}
-
-/**
- * 独立路径组：使用指定路线启动导航
- */
-export async function startNaviWithIndependentPath(
-  options: StartNaviWithIndependentPathOptions
-): Promise<boolean> {
-  return await ExpoGaodeMapNavigationModule.startNaviWithIndependentPath(options);
-}
-
-/**
- * 独立路径组：清理
- */
-export async function clearIndependentRoute(
-  options: ClearIndependentRouteOptions
-): Promise<boolean> {
-  return await ExpoGaodeMapNavigationModule.clearIndependentRoute(options);
-}
-
-// 导出导航相关类型与枚举（Coordinates 从 map 模块导出）
-export type {
-  NaviPoint,
-  RouteOptions,
-  DriveRouteOptions,
-  WalkRouteOptions,
-  RideRouteOptions,
-  EBikeRouteOptions,
-  TruckRouteOptions,
-  RouteResult,
-  DriveRouteResult,
-  IndependentRouteResult,
-  IndependentDriveRouteOptions,
-  IndependentTruckRouteOptions,
-  IndependentWalkRouteOptions,
-  IndependentRideRouteOptions,
-  SelectIndependentRouteOptions,
-  StartNaviWithIndependentPathOptions,
-  ClearIndependentRouteOptions,
-  MotorcycleRouteOptions,
-  IndependentMotorcycleRouteOptions,
-};
-
-export {
-  RouteType,
-  DriveStrategy,
-  WalkStrategy,
-  RideStrategy,
-  TruckSize,
-  TravelStrategy,
-};
-
-// 精简后的默认导出
-export default {
-  // 初始化
-  initNavigation,
-  destroyAllCalculators,
-
-  // 路径规划
-  calculateRoute,
-  calculateDriveRoute,
-  calculateWalkRoute,
-  calculateRideRoute,
-  calculateEBikeRoute,
-  calculateTruckRoute,
-  calculateMotorcycleRoute,
-
-  // 独立路径规划
-  independentDriveRoute,
-  independentTruckRoute,
-  independentWalkRoute,
-  independentRideRoute,
-  independentMotorcycleRoute,
-
-  // 独立路径组操作
-  selectIndependentRoute,
-  startNaviWithIndependentPath,
-  clearIndependentRoute,
-};

package/src/map/ExpoGaodeMap.types.ts

@@ -1,46 +0,0 @@
-/**
- * 高德地图 Expo 模块类型定义
- *
- * 此文件定义了 Expo 模块专用的类型，包括事件类型等
- * 其他通用类型请从 './types' 导入
- */
-
-import type { Coordinates, ReGeocode } from './types';
-
-// 重新导出所有通用类型，方便使用
-export * from './types';
-
-/**
- * Expo 模块事件类型
- * 定义了原生模块可以触发的事件
- */
-export type ExpoGaodeMapModuleEvents = {
-  /**
-   * 定位更新事件
-   * 当位置发生变化时触发
-   * @param location 位置信息，包含坐标和可选的逆地理编码信息
-   */
-  onLocationUpdate: (location: Coordinates | ReGeocode) => void;
-  
-  /**
-   * 方向更新事件（iOS）
-   * 当设备方向发生变化时触发
-   * @param heading 方向信息
-   */
-  onHeadingUpdate: (heading: {
-    /** 磁北方向角度 (0-359.9) */
-    magneticHeading: number;
-    /** 真北方向角度 (0-359.9) */
-    trueHeading: number;
-    /** 方向精度 */
-    headingAccuracy: number;
-    /** X 轴原始数据 */
-    x: number;
-    /** Y 轴原始数据 */
-    y: number;
-    /** Z 轴原始数据 */
-    z: number;
-    /** 时间戳 */
-    timestamp: number;
-  }) => void;
-};