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

package/android/src/main/java/expo/modules/gaodemap/navigation/routes/walkride/WalkRideRouteCalculator.kt

@@ -0,0 +1,158 @@
+package expo.modules.gaodemap.navigation.routes.walkride
+
+import android.content.Context
+import com.amap.api.navi.AMapNavi
+import com.amap.api.navi.enums.TravelStrategy
+import expo.modules.gaodemap.navigation.ExpoGaodeMapNavigationModule
+import expo.modules.gaodemap.navigation.listeners.RouteCalculateListener
+import expo.modules.gaodemap.navigation.utils.Converters
+import expo.modules.kotlin.Promise
+
+/**
+ * 步行/骑行 路线规划计算器
+ *
+ * 对齐官方文档：
+ * - 步行/骑行使用经纬度（NaviLatLng）算路
+ * - 通过 AMapNavi.calculateWalkRoute / calculateRideRoute 实现
+ */
+class WalkRideRouteCalculator(
+  private val context: Context,
+  private val module: ExpoGaodeMapNavigationModule
+) {
+
+  private var aMapNavi: AMapNavi? = null
+  private var routeListener: RouteCalculateListener? = null
+
+  init {
+    initNavi()
+  }
+
+  private fun initNavi() {
+    if (aMapNavi == null) {
+      aMapNavi = AMapNavi.getInstance(context)
+      
+      // 检查SDK是否正确初始化（验证API Key）
+      if (aMapNavi == null) {
+        throw Exception("高德地图导航SDK初始化失败,请检查API Key配置是否正确。请在app.json中配置android.config.gaodeMapKey")
+      }
+      
+      // 骑/步行适配：历史实现需切换到 TravelView
+      aMapNavi?.isNaviTravelView = true
+      routeListener = RouteCalculateListener(module)
+      aMapNavi?.addAMapNaviListener(routeListener)
+    }
+  }
+
+  /**
+   * 步行路径规划（NaviLatLng）
+   * options:
+   * - from: { latitude, longitude }
+   * - to: { latitude, longitude }
+   */
+  fun calculateWalkRoute(options: Map<String, Any?>, promise: Promise) {
+    // 确保SDK已初始化
+    if (aMapNavi == null) {
+      try {
+        initNavi()
+      } catch (e: Exception) {
+        promise.reject("INIT_FAILED", e.message ?: "高德地图导航SDK初始化失败", e)
+        return
+      }
+    }
+    
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+      ?: throw Exception("from is required")
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+
+    // TravelStrategy：支持两种传参方式
+    // 1) travelStrategy: 1000(SINGLE) / 1001(MULTIPLE)
+    // 2) multiple: Boolean（true=多路径=1001；false/未传=单路径=1000）
+    val travelStrategyValue: Int = when {
+      options["travelStrategy"] is Number -> (options["travelStrategy"] as Number).toInt()
+      options["multiple"] as? Boolean == true -> 1001
+      else -> 1000
+    }
+    val strategyEnum = if (travelStrategyValue == 1001) TravelStrategy.MULTIPLE else TravelStrategy.SINGLE
+
+    // 根据是否提供 POI 信息选择 API：有 name 或 poiId 则走 POI 算路，否则走经纬度算路
+    val usePoi = (from["name"] is String) || (from["poiId"] is String) || (to["name"] is String) || (to["poiId"] is String) || (options["usePoi"] as? Boolean == true)
+
+    // 标注场景与多路线期望（步行支持 SINGLE/MULTIPLE）
+    routeListener?.scene = "walk"
+    routeListener?.multiple = (strategyEnum == TravelStrategy.MULTIPLE)
+    routeListener?.currentPromise = promise
+
+    if (usePoi) {
+      val start = Converters.parseNaviPoi(from)
+      val end = Converters.parseNaviPoi(to)
+      aMapNavi?.calculateWalkRoute(start, end, strategyEnum)
+    } else {
+      val fromLatLng = Converters.parseNaviLatLng(from)
+      val toLatLng = Converters.parseNaviLatLng(to)
+      aMapNavi?.calculateWalkRoute(fromLatLng, toLatLng)
+    }
+  }
+
+  /**
+   * 骑行路径规划（NaviLatLng）
+   * options:
+   * - from: { latitude, longitude }
+   * - to: { latitude, longitude }
+   */
+  fun calculateRideRoute(options: Map<String, Any?>, promise: Promise) {
+    // 确保SDK已初始化
+    if (aMapNavi == null) {
+      try {
+        initNavi()
+      } catch (e: Exception) {
+        promise.reject("INIT_FAILED", e.message ?: "高德地图导航SDK初始化失败", e)
+        return
+      }
+    }
+    
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+      ?: throw Exception("from is required")
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+
+    val travelStrategyValue: Int = when {
+      options["travelStrategy"] is Number -> (options["travelStrategy"] as Number).toInt()
+      options["multiple"] as? Boolean == true -> 1001
+      else -> 1000
+    }
+    val strategyEnum = if (travelStrategyValue == 1001) TravelStrategy.MULTIPLE else TravelStrategy.SINGLE
+
+    val usePoi = (from["name"] is String) || (from["poiId"] is String) || (to["name"] is String) || (to["poiId"] is String) || (options["usePoi"] as? Boolean == true)
+
+    // 标注场景与多路线期望（骑行支持 SINGLE/MULTIPLE）
+    routeListener?.scene = "ride"
+    routeListener?.multiple = (strategyEnum == TravelStrategy.MULTIPLE)
+    routeListener?.currentPromise = promise
+
+    if (usePoi) {
+      val start = Converters.parseNaviPoi(from)
+      val end = Converters.parseNaviPoi(to)
+      aMapNavi?.calculateRideRoute(start, end, strategyEnum)
+    } else {
+      val fromLatLng = Converters.parseNaviLatLng(from)
+      val toLatLng = Converters.parseNaviLatLng(to)
+      aMapNavi?.calculateRideRoute(fromLatLng, toLatLng)
+    }
+  }
+
+  fun destroy() {
+    aMapNavi?.removeAMapNaviListener(routeListener)
+    try {
+      AMapNavi.destroy()
+    } catch (_: Exception) {
+    } finally {
+      aMapNavi = null
+      routeListener = null
+    }
+  }
+}

package/android/src/main/java/expo/modules/gaodemap/navigation/services/IndependentRouteService.kt

@@ -0,0 +1,221 @@
+package expo.modules.gaodemap.navigation.services
+
+import android.content.Context
+import com.amap.api.navi.AMapNavi
+import com.amap.api.navi.model.AMapCarInfo
+import expo.modules.gaodemap.navigation.ExpoGaodeMapNavigationModule
+import expo.modules.gaodemap.navigation.listeners.IndependentRouteListener
+import expo.modules.gaodemap.navigation.utils.Converters
+import expo.modules.kotlin.Promise
+
+/**
+ * 独立路径规划业务封装
+ *
+ * - 将 ExpoGaodeMapNavigationModule 中的 independentXXX 算路逻辑下沉，避免模块文件臃肿
+ * - 注意：仍由 Module 暴露 AsyncFunction，调用到本 Service 即可
+ */
+class IndependentRouteService(
+  private val context: Context,
+  private val module: ExpoGaodeMapNavigationModule
+) {
+
+  // 驾车（小客车）
+  fun independentDriveRoute(options: Map<String, Any?>, promise: Promise) {
+    try {
+      val navi = AMapNavi.getInstance(context)
+
+      @Suppress("UNCHECKED_CAST")
+      val from = options["from"] as? Map<String, Any?>
+      @Suppress("UNCHECKED_CAST")
+      val to = options["to"] as? Map<String, Any?> ?: throw Exception("to is required")
+
+      val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+      val toPoi = Converters.parseNaviPoi(to)
+      @Suppress("UNCHECKED_CAST")
+      val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+      val strategy = resolveDriveStrategy(navi, options)
+
+      val carNumber = options["carNumber"] as? String
+      val restriction = options["restriction"] as? Boolean
+      if (carNumber != null || restriction != null) {
+        setCarInfo(navi, "0", carNumber, restriction)
+      }
+
+      navi.independentCalculateRoute(
+        fromPoi,
+        toPoi,
+        waypoints,
+        strategy,
+        1, // 驾车
+        IndependentRouteListener(module, promise)
+      )
+    } catch (e: Exception) {
+      promise.reject("CALCULATE_ERROR", e.message, e)
+    }
+  }
+
+  // 货车
+  fun independentTruckRoute(options: Map<String, Any?>, promise: Promise) {
+    try {
+      val navi = AMapNavi.getInstance(context)
+
+      val carNumber = options["carNumber"] as? String
+      val restriction = options["restriction"] as? Boolean
+      setCarInfo(navi, "1", carNumber, restriction)
+
+      @Suppress("UNCHECKED_CAST")
+      val from = options["from"] as? Map<String, Any?>
+      @Suppress("UNCHECKED_CAST")
+      val to = options["to"] as? Map<String, Any?> ?: throw Exception("to is required")
+
+      val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+      val toPoi = Converters.parseNaviPoi(to)
+      @Suppress("UNCHECKED_CAST")
+      val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+      val strategy = resolveDriveStrategy(navi, options)
+
+      navi.independentCalculateRoute(
+        fromPoi, toPoi, waypoints, strategy,
+        1, // 货车仍归于驾车类型
+        IndependentRouteListener(module, promise)
+      )
+    } catch (e: Exception) {
+      promise.reject("CALCULATE_ERROR", e.message, e)
+    }
+  }
+
+  // 步行
+  fun independentWalkRoute(options: Map<String, Any?>, promise: Promise) {
+    try {
+      val navi = AMapNavi.getInstance(context)
+
+      @Suppress("UNCHECKED_CAST")
+      val from = options["from"] as? Map<String, Any?>
+      @Suppress("UNCHECKED_CAST")
+      val to = options["to"] as? Map<String, Any?> ?: throw Exception("to is required")
+
+      val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+      val toPoi = Converters.parseNaviPoi(to)
+      @Suppress("UNCHECKED_CAST")
+      val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+      val travelStrategy: Int = when {
+        options["travelStrategy"] is Number -> (options["travelStrategy"] as Number).toInt()
+        options["multiple"] as? Boolean == true -> 1001
+        else -> 1000
+      }
+
+      navi.independentCalculateRoute(
+        fromPoi, toPoi, waypoints, travelStrategy,
+        3, // 步行
+        IndependentRouteListener(module, promise)
+      )
+    } catch (e: Exception) {
+      promise.reject("CALCULATE_ERROR", e.message, e)
+    }
+  }
+
+  // 骑行
+  fun independentRideRoute(options: Map<String, Any?>, promise: Promise) {
+    try {
+      val navi = AMapNavi.getInstance(context)
+
+      @Suppress("UNCHECKED_CAST")
+      val from = options["from"] as? Map<String, Any?>
+      @Suppress("UNCHECKED_CAST")
+      val to = options["to"] as? Map<String, Any?> ?: throw Exception("to is required")
+
+      val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+      val toPoi = Converters.parseNaviPoi(to)
+      @Suppress("UNCHECKED_CAST")
+      val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+      val travelStrategy: Int = when {
+        options["travelStrategy"] is Number -> (options["travelStrategy"] as Number).toInt()
+        options["multiple"] as? Boolean == true -> 1001
+        else -> 1000
+      }
+
+      navi.independentCalculateRoute(
+        fromPoi, toPoi, waypoints, travelStrategy,
+        2, // 骑行
+        IndependentRouteListener(module, promise)
+      )
+    } catch (e: Exception) {
+      promise.reject("CALCULATE_ERROR", e.message, e)
+    }
+  }
+
+  // 摩托车（carType=11）
+  fun independentMotorcycleRoute(options: Map<String, Any?>, promise: Promise) {
+    try {
+      val navi = AMapNavi.getInstance(context)
+
+      val carNumber = options["carNumber"] as? String
+      val motorcycleCC = (options["motorcycleCC"] as? Number)?.toInt()
+      setCarInfo(navi, "11", carNumber, null, motorcycleCC)
+
+      @Suppress("UNCHECKED_CAST")
+      val from = options["from"] as? Map<String, Any?>
+      @Suppress("UNCHECKED_CAST")
+      val to = options["to"] as? Map<String, Any?> ?: throw Exception("to is required")
+
+      val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+      val toPoi = Converters.parseNaviPoi(to)
+      @Suppress("UNCHECKED_CAST")
+      val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+      val strategy = resolveDriveStrategy(navi, options)
+
+      navi.independentCalculateRoute(
+        fromPoi, toPoi, waypoints, strategy,
+        1, // 驾车类型，由 carType=11 决定摩托车
+        IndependentRouteListener(module, promise)
+      )
+    } catch (e: Exception) {
+      promise.reject("CALCULATE_ERROR", e.message, e)
+    }
+  }
+
+  // 工具：驾车策略
+  private fun resolveDriveStrategy(navi: AMapNavi, options: Map<String, Any?>): Int {
+    return if (options.containsKey("strategy")) {
+      (options["strategy"] as? Number)?.toInt() ?: 0
+    } else {
+      val avoidCongestion = options["avoidCongestion"] as? Boolean ?: false
+      val avoidHighway = options["avoidHighway"] as? Boolean ?: false
+      val avoidCost = options["avoidCost"] as? Boolean ?: false
+      val prioritiseHighway = options["prioritiseHighway"] as? Boolean ?: false
+      try {
+        navi.strategyConvert(avoidCongestion, avoidHighway, avoidCost, prioritiseHighway, true)
+      } catch (_: Exception) { 0 }
+    }
+  }
+
+  // 工具：车辆信息
+  private fun setCarInfo(
+    navi: AMapNavi,
+    carType: String,
+    carNumber: String? = null,
+    restriction: Boolean? = null,
+    motorcycleCC: Int? = null
+  ) {
+    try {
+      val carInfo = AMapCarInfo().apply {
+        if (carNumber != null) setCarNumber(carNumber)
+        setCarType(carType)
+        if (restriction != null) isRestriction = restriction
+        if (motorcycleCC != null) {
+          try {
+              this.motorcycleCC = motorcycleCC
+          } catch (_: Exception) {}
+        }
+      }
+      navi.setCarInfo(carInfo)
+    } catch (_: Exception) {
+      // ignore
+    }
+  }
+}

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

@@ -0,0 +1,138 @@
+package expo.modules.gaodemap.navigation.utils
+
+import com.amap.api.maps.model.LatLng
+import com.amap.api.navi.model.*
+
+/**
+ * 数据转换工具类
+ */
+object Converters {
+  
+  /**
+   * 转换坐标点为 NaviLatLng（用于步行、骑行）
+   */
+  fun parseNaviLatLng(map: Map<String, Any?>): NaviLatLng {
+    val lat = (map["latitude"] as? Number)?.toDouble()
+      ?: throw Exception("latitude is required")
+    val lng = (map["longitude"] as? Number)?.toDouble()
+      ?: throw Exception("longitude is required")
+    
+    return NaviLatLng(lat, lng)
+  }
+  
+  /**
+   * 转换坐标点为 NaviPoi（用于驾车、货车）
+   */
+  fun parseNaviPoi(map: Map<String, Any?>): NaviPoi {
+    val lat = (map["latitude"] as? Number)?.toDouble()
+      ?: throw Exception("latitude is required")
+    val lng = (map["longitude"] as? Number)?.toDouble()
+      ?: throw Exception("longitude is required")
+    val name = map["name"] as? String
+    val poiId = map["poiId"] as? String
+    
+    // NaviPoi 构造函数需要的是地图库的 LatLng 类型
+    return NaviPoi(name, LatLng(lat, lng), poiId)
+  }
+
+  /**
+   * 转换途经点列表
+   */
+  fun parseWaypoints(list: List<Map<String, Any?>>?): List<NaviPoi> {
+    return list?.map { parseNaviPoi(it) } ?: emptyList()
+  }
+
+  /**
+   * 转换导航路径信息（用于 getNaviInfo）
+   * Android SDK 中导航信息通过路径对象获取
+   */
+  fun convertNaviPathInfo(path: AMapNaviPath): Map<String, Any?> {
+    return mapOf(
+      "currentRoadName" to "",
+      "nextRoadName" to "",
+      "currentStepRetainDistance" to 0,
+      "currentStepRetainTime" to 0,
+      "pathRetainDistance" to path.allLength,
+      "pathRetainTime" to path.allTime,
+      "currentSpeed" to 0,
+      "iconSpeed" to 0,
+      "iconType" to 0,
+      "cameraDistance" to 0,
+      "cameraType" to 0,
+      "isInHighway" to false,
+      "isOffRoute" to false
+    )
+  }
+
+  /**
+   * 转换路径步骤（简化版本，只使用确实存在的属性）
+   */
+  fun convertSteps(steps: List<AMapNaviStep>?): List<Map<String, Any?>> {
+    return steps?.map { step ->
+      mapOf(
+        "instruction" to "",
+        "road" to "",
+        "distance" to step.length,
+        "duration" to 0,
+        "polyline" to convertCoords(step.coords),
+        "tollDistance" to step.chargeLength,
+        "tollCost" to step.tollCost
+      )
+    } ?: emptyList()
+  }
+
+  /**
+   * 转换坐标列表（NaviLatLng）
+   */
+  fun convertCoords(coords: List<NaviLatLng>?): List<Map<String, Double>> {
+    return coords?.map { coord ->
+      mapOf(
+        "latitude" to coord.latitude,
+        "longitude" to coord.longitude
+      )
+    } ?: emptyList()
+  }
+
+  /**
+   * 转换路径结果（只使用确实存在的属性）
+   */
+  fun convertNaviPath(path: AMapNaviPath): Map<String, Any?> {
+    return mapOf(
+      "distance" to path.allLength,
+      "duration" to path.allTime,
+      "tollDistance" to 0,
+      "tollCost" to path.tollCost,
+      "trafficLightCount" to 0,
+      "steps" to convertSteps(path.steps),
+      "polyline" to convertCoords(path.coordList)
+    )
+  }
+
+  /**
+   * 转换驾车路径结果
+   */
+  fun convertDriveRouteResult(paths: Map<Int, AMapNaviPath>?): Map<String, Any?> {
+    val routes = paths?.values?.map { convertNaviPath(it) } ?: emptyList()
+    
+    return mapOf(
+      "routes" to routes,
+      "taxiCost" to 0
+    )
+  }
+
+  /**
+   * 转换多路线信息
+   */
+  fun convertMultiRouteInfo(paths: Map<Int, AMapNaviPath>?): List<Map<String, Any?>> {
+    return paths?.entries?.map { (id, path) ->
+      mapOf(
+        "routeId" to id,
+        "distance" to path.allLength,
+        "duration" to path.allTime,
+        "tollCost" to path.tollCost,
+        "trafficLightCount" to 0,
+        "strategyDesc" to ""
+      )
+    } ?: emptyList()
+  }
+}

package/app.plugin.js

@@ -0,0 +1,9 @@
+
+// Expo Config Plugin 入口文件
+// 这个文件会在用户运行 npx expo prebuild 时被调用
+
+// 导入编译后的插件
+const withGaodeMap = require('./plugin/build/withGaodeMap').default;
+
+// 导出插件
+module.exports = withGaodeMap;

package/build/ExpoGaodeMapNaviView.d.ts

@@ -0,0 +1,50 @@
+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>;
+}
+/**
+ * 高德导航视图组件
+ *
+ * 使用高德官方的导航界面，提供完整的导航体验，包括：
+ * - 路线规划和显示
+ * - 实时导航信息（距离、时间、道路名称）
+ * - 转向箭头和提示
+ * - 路况信息
+ * - 摄像头提示
+ * - 语音播报
+ *
+ * @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 declare const NaviView: React.ForwardRefExoticComponent<NaviViewProps & React.RefAttributes<NaviViewRef>>;
+export default NaviView;

package/build/ExpoGaodeMapNaviView.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NaviView = void 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.
+ */
+const expo_modules_core_1 = require("expo-modules-core");
+const React = __importStar(require("react"));
+const NativeView = (0, expo_modules_core_1.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('到达目的地！');
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+exports.NaviView = React.forwardRef((props, ref) => {
+    const nativeRef = React.useRef(null);
+    // 创建 API 引用
+    const apiRef = React.useMemo(() => ({
+        startNavigation: async (start, end, type) => {
+            var _a, _b;
+            if (!nativeRef.current)
+                throw new Error('NaviView not initialized');
+            // 将对象解构为单独的参数传递给原生层
+            const startLat = (_a = start === null || start === void 0 ? void 0 : start.latitude) !== null && _a !== void 0 ? _a : 0;
+            const startLng = (_b = start === null || start === void 0 ? void 0 : start.longitude) !== null && _b !== void 0 ? _b : 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}/>;
+});
+exports.NaviView.displayName = 'NaviView';
+exports.default = exports.NaviView;

package/build/ExpoGaodeMapNavigation.types.d.ts

@@ -0,0 +1 @@
+export * from './types';