expo-gaode-map-navigation 2.0.12 → 2.0.14

package/build/web-route-following.js

@@ -0,0 +1,178 @@
+import ExpoGaodeMapNavigationModule from './ExpoGaodeMapNavigationModule';
+import { buildAnchorWaypointsFromWebRoute, calculatePathLengthSafe, dedupeAdjacentPoints, getDistanceToPathSafe, normalizeWebRoutePolyline, samplePolyline } from './route-geometry';
+function extractRoutePolyline(route) {
+    if (Array.isArray(route.polyline) && route.polyline.length > 0) {
+        return route.polyline;
+    }
+    const segments = Array.isArray(route.segments) ? route.segments : [];
+    if (segments.length > 0) {
+        return dedupeAdjacentPoints(segments.flatMap((segment) => segment.polyline ?? []));
+    }
+    const steps = Array.isArray(route.steps) ? route.steps : [];
+    if (steps.length > 0) {
+        return dedupeAdjacentPoints(steps.flatMap((step) => step.polyline ?? []));
+    }
+    return [];
+}
+function resolveIndependentRouteId(result, route, routeIndex) {
+    if (typeof route.id === 'number') {
+        return route.id;
+    }
+    if (typeof route.routeId === 'number') {
+        return route.routeId;
+    }
+    return result.routeIds?.[routeIndex];
+}
+function scoreIndependentRouteAgainstWebPolyline(result, route, routeIndex, webPolyline, anchorWaypoints, thresholdMeters) {
+    // 评分思路很简单：看原生独立路线与 Web 折线有多接近，
+    // 再把平均偏差、最大偏差、漏掉的锚点一起折成一个排序分数。
+    const nativePolyline = extractRoutePolyline(route);
+    if (nativePolyline.length === 0 || webPolyline.length === 0) {
+        return null;
+    }
+    const sampledNativePoints = samplePolyline(nativePolyline);
+    const pointDistances = sampledNativePoints.map((point) => getDistanceToPathSafe(webPolyline, point));
+    const averageDeviationMeters = pointDistances.reduce((total, distance) => total + distance, 0) / pointDistances.length;
+    const maxDeviationMeters = Math.max(...pointDistances);
+    const missedAnchorCount = anchorWaypoints.reduce((count, point) => (getDistanceToPathSafe(nativePolyline, point) > thresholdMeters ? count + 1 : count), 0);
+    return {
+        routeId: resolveIndependentRouteId(result, route, routeIndex),
+        routeIndex,
+        averageDeviationMeters,
+        maxDeviationMeters,
+        missedAnchorCount,
+        score: averageDeviationMeters +
+            maxDeviationMeters * 0.35 +
+            missedAnchorCount * thresholdMeters * 0.5,
+    };
+}
+function evaluateIndependentResultAgainstWebRoute(independentResult, webPolyline, anchorWaypoints, maxDeviationMeters) {
+    // 先给每条原生候选路线打分，再把最接近的一条拿出来判断是 matched / approximate / preview_only。
+    const candidateMatches = independentResult.routes
+        .map((route, routeIndex) => scoreIndependentRouteAgainstWebPolyline(independentResult, route, routeIndex, webPolyline, anchorWaypoints, maxDeviationMeters))
+        .filter((candidate) => candidate !== null)
+        .sort((routeA, routeB) => routeA.score - routeB.score);
+    const bestMatch = candidateMatches[0];
+    const selectedRoute = bestMatch
+        ? independentResult.routes[bestMatch.routeIndex]
+        : undefined;
+    const nativePolyline = selectedRoute ? extractRoutePolyline(selectedRoute) : [];
+    let mode = 'preview_only';
+    let reason = '未找到足够接近 Web 规划线的原生路线';
+    if (bestMatch) {
+        if (bestMatch.averageDeviationMeters <= maxDeviationMeters / 2 &&
+            bestMatch.maxDeviationMeters <= maxDeviationMeters &&
+            bestMatch.missedAnchorCount === 0) {
+            mode = 'matched';
+            reason = '原生路线与 Web 规划线高度接近，可直接按近似结果导航';
+        }
+        else if (bestMatch.averageDeviationMeters <= maxDeviationMeters &&
+            bestMatch.maxDeviationMeters <= maxDeviationMeters * 2) {
+            mode = 'approximate';
+            reason = '原生路线与 Web 规划线接近，但仍存在可见偏差';
+        }
+    }
+    return {
+        candidateMatches,
+        bestMatch,
+        selectedRoute,
+        nativePolyline,
+        mode,
+        reason,
+    };
+}
+async function runIndependentDriveRoute(options) {
+    return ExpoGaodeMapNavigationModule.independentDriveRoute(options);
+}
+export async function followWebPlannedRoute(options) {
+    const { from, to, webRoute, strategy, carNumber, restriction, maxDeviationMeters = 120, startNavigation = false, naviType = 0, } = options;
+    const webPolyline = normalizeWebRoutePolyline(webRoute);
+    if (webPolyline.length < 2) {
+        throw new Error('webRoute.polyline 至少需要 2 个点');
+    }
+    // 第一步：从 Web 线路提取少量锚点，让原生独立算路先尽量往这条线靠。
+    const anchorWaypoints = buildAnchorWaypointsFromWebRoute(options);
+    const anchoredIndependentResult = await runIndependentDriveRoute({
+        from,
+        to,
+        strategy,
+        carNumber,
+        restriction,
+        waypoints: anchorWaypoints,
+    });
+    let independentResult = anchoredIndependentResult;
+    let evaluation = evaluateIndependentResultAgainstWebRoute(anchoredIndependentResult, webPolyline, anchorWaypoints, maxDeviationMeters);
+    let navigationUsesAnchorWaypoints = anchorWaypoints.length > 0;
+    // 如果锚点路线已经足够接近，再尝试去掉锚点重算一次。
+    // 这样可以避免“为了贴线而被锚点拖偏”的情况。
+    if (evaluation.bestMatch && evaluation.mode !== 'preview_only' && anchorWaypoints.length > 0) {
+        try {
+            const directIndependentResult = await runIndependentDriveRoute({
+                from,
+                to,
+                strategy,
+                carNumber,
+                restriction,
+            });
+            const directEvaluation = evaluateIndependentResultAgainstWebRoute(directIndependentResult, webPolyline, [], maxDeviationMeters);
+            const anchoredBest = evaluation.bestMatch;
+            const directBest = directEvaluation.bestMatch;
+            const canSwitchToDirectNavigation = Boolean(directBest) &&
+                directEvaluation.mode !== 'preview_only' &&
+                directBest.averageDeviationMeters <= Math.max(anchoredBest.averageDeviationMeters + 45, anchoredBest.averageDeviationMeters * 1.45) &&
+                directBest.maxDeviationMeters <= Math.max(anchoredBest.maxDeviationMeters + 90, anchoredBest.maxDeviationMeters * 1.45);
+            if (canSwitchToDirectNavigation) {
+                // 直连结果更自然，就切到直连结果，并清掉刚才的锚点算路缓存。
+                ExpoGaodeMapNavigationModule.clearIndependentRoute({
+                    token: anchoredIndependentResult.token,
+                }).catch(() => { });
+                independentResult = directIndependentResult;
+                evaluation = directEvaluation;
+                navigationUsesAnchorWaypoints = false;
+                evaluation.reason =
+                    directEvaluation.mode === 'matched'
+                        ? '已切换为无途经点导航结果，且与 Web 规划线高度接近'
+                        : '已切换为无途经点导航结果，但与 Web 规划线仍存在轻微偏差';
+            }
+            else {
+                // 直连结果不如锚点方案，就保留锚点方案作为最终导航依据。
+                ExpoGaodeMapNavigationModule.clearIndependentRoute({
+                    token: directIndependentResult.token,
+                }).catch(() => { });
+                evaluation.reason = `${evaluation.reason}；最终导航仍需依赖锚点途经点逼近 Web 线路`;
+            }
+        }
+        catch {
+            evaluation.reason = `${evaluation.reason}；无途经点重算失败，最终导航仍需依赖锚点途经点`;
+        }
+    }
+    let navigationStarted = false;
+    if (startNavigation && evaluation.bestMatch && evaluation.mode !== 'preview_only') {
+        // 只有当评估结果足够接近时才真正启动导航，避免把偏差过大的结果直接交给导航 SDK。
+        navigationStarted = await ExpoGaodeMapNavigationModule.startNaviWithIndependentPath({
+            token: independentResult.token,
+            naviType,
+            routeId: evaluation.bestMatch.routeId,
+            routeIndex: evaluation.bestMatch.routeId == null ? evaluation.bestMatch.routeIndex : undefined,
+        });
+    }
+    return {
+        mode: evaluation.mode,
+        token: independentResult.token,
+        anchorWaypoints,
+        webDistance: calculatePathLengthSafe(webPolyline),
+        nativeDistance: evaluation.nativePolyline.length > 1
+            ? calculatePathLengthSafe(evaluation.nativePolyline)
+            : undefined,
+        selectedRouteId: evaluation.bestMatch?.routeId,
+        selectedRouteIndex: evaluation.bestMatch?.routeIndex,
+        averageDeviationMeters: evaluation.bestMatch?.averageDeviationMeters,
+        maxDeviationMeters: evaluation.bestMatch?.maxDeviationMeters,
+        navigationStarted,
+        navigationUsesAnchorWaypoints,
+        independentResult,
+        candidateMatches: evaluation.candidateMatches,
+        reason: evaluation.reason,
+    };
+}
+//# sourceMappingURL=web-route-following.js.map

package/build/web-route-following.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-route-following.js","sourceRoot":"","sources":["../src/web-route-following.ts"],"names":[],"mappings":"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","sourcesContent":["import ExpoGaodeMapNavigationModule from './ExpoGaodeMapNavigationModule';\nimport { buildAnchorWaypointsFromWebRoute, calculatePathLengthSafe, dedupeAdjacentPoints, getDistanceToPathSafe, normalizeWebRoutePolyline, samplePolyline } from './route-geometry';\nimport type {\n  FollowWebPlannedRouteCandidate,\n  FollowWebPlannedRouteOptions,\n  FollowWebPlannedRouteResult,\n  IndependentRouteResult,\n  NaviPoint,\n  RouteResult,\n} from './types';\n\ntype RouteLike = RouteResult & {\n  routeId?: number;\n  steps?: Array<{ polyline?: NaviPoint[] }>;\n};\n\nfunction extractRoutePolyline(route: RouteLike): NaviPoint[] {\n  if (Array.isArray(route.polyline) && route.polyline.length > 0) {\n    return route.polyline;\n  }\n\n  const segments = Array.isArray(route.segments) ? route.segments : [];\n  if (segments.length > 0) {\n    return dedupeAdjacentPoints(\n      segments.flatMap((segment) => segment.polyline ?? [])\n    );\n  }\n\n  const steps = Array.isArray(route.steps) ? route.steps : [];\n  if (steps.length > 0) {\n    return dedupeAdjacentPoints(\n      steps.flatMap((step) => step.polyline ?? [])\n    );\n  }\n\n  return [];\n}\n\nfunction resolveIndependentRouteId(\n  result: IndependentRouteResult,\n  route: RouteLike,\n  routeIndex: number\n): number | undefined {\n  if (typeof route.id === 'number') {\n    return route.id;\n  }\n  if (typeof route.routeId === 'number') {\n    return route.routeId;\n  }\n  return result.routeIds?.[routeIndex];\n}\n\nfunction scoreIndependentRouteAgainstWebPolyline(\n  result: IndependentRouteResult,\n  route: RouteLike,\n  routeIndex: number,\n  webPolyline: NaviPoint[],\n  anchorWaypoints: NaviPoint[],\n  thresholdMeters: number\n): FollowWebPlannedRouteCandidate | null {\n  // 评分思路很简单：看原生独立路线与 Web 折线有多接近，\n  // 再把平均偏差、最大偏差、漏掉的锚点一起折成一个排序分数。\n  const nativePolyline = extractRoutePolyline(route);\n  if (nativePolyline.length === 0 || webPolyline.length === 0) {\n    return null;\n  }\n\n  const sampledNativePoints = samplePolyline(nativePolyline);\n  const pointDistances = sampledNativePoints.map((point) =>\n    getDistanceToPathSafe(webPolyline, point)\n  );\n  const averageDeviationMeters =\n    pointDistances.reduce((total, distance) => total + distance, 0) / pointDistances.length;\n  const maxDeviationMeters = Math.max(...pointDistances);\n\n  const missedAnchorCount = anchorWaypoints.reduce((count, point) => (\n    getDistanceToPathSafe(nativePolyline, point) > thresholdMeters ? count + 1 : count\n  ), 0);\n\n  return {\n    routeId: resolveIndependentRouteId(result, route, routeIndex),\n    routeIndex,\n    averageDeviationMeters,\n    maxDeviationMeters,\n    missedAnchorCount,\n    score:\n      averageDeviationMeters +\n      maxDeviationMeters * 0.35 +\n      missedAnchorCount * thresholdMeters * 0.5,\n  };\n}\n\nfunction evaluateIndependentResultAgainstWebRoute(\n  independentResult: IndependentRouteResult,\n  webPolyline: NaviPoint[],\n  anchorWaypoints: NaviPoint[],\n  maxDeviationMeters: number\n) {\n  // 先给每条原生候选路线打分，再把最接近的一条拿出来判断是 matched / approximate / preview_only。\n  const candidateMatches = independentResult.routes\n    .map((route, routeIndex) =>\n      scoreIndependentRouteAgainstWebPolyline(\n        independentResult,\n        route as RouteLike,\n        routeIndex,\n        webPolyline,\n        anchorWaypoints,\n        maxDeviationMeters\n      )\n    )\n    .filter((candidate): candidate is FollowWebPlannedRouteCandidate => candidate !== null)\n    .sort((routeA, routeB) => routeA.score - routeB.score);\n\n  const bestMatch = candidateMatches[0];\n  const selectedRoute = bestMatch\n    ? independentResult.routes[bestMatch.routeIndex] as RouteLike\n    : undefined;\n  const nativePolyline = selectedRoute ? extractRoutePolyline(selectedRoute) : [];\n\n  let mode: FollowWebPlannedRouteResult['mode'] = 'preview_only';\n  let reason = '未找到足够接近 Web 规划线的原生路线';\n\n  if (bestMatch) {\n    if (\n      bestMatch.averageDeviationMeters <= maxDeviationMeters / 2 &&\n      bestMatch.maxDeviationMeters <= maxDeviationMeters &&\n      bestMatch.missedAnchorCount === 0\n    ) {\n      mode = 'matched';\n      reason = '原生路线与 Web 规划线高度接近，可直接按近似结果导航';\n    } else if (\n      bestMatch.averageDeviationMeters <= maxDeviationMeters &&\n      bestMatch.maxDeviationMeters <= maxDeviationMeters * 2\n    ) {\n      mode = 'approximate';\n      reason = '原生路线与 Web 规划线接近，但仍存在可见偏差';\n    }\n  }\n\n  return {\n    candidateMatches,\n    bestMatch,\n    selectedRoute,\n    nativePolyline,\n    mode,\n    reason,\n  };\n}\n\nasync function runIndependentDriveRoute(options: {\n  from: FollowWebPlannedRouteOptions['from'];\n  to: FollowWebPlannedRouteOptions['to'];\n  strategy?: FollowWebPlannedRouteOptions['strategy'];\n  carNumber?: FollowWebPlannedRouteOptions['carNumber'];\n  restriction?: FollowWebPlannedRouteOptions['restriction'];\n  waypoints?: NaviPoint[];\n}): Promise<IndependentRouteResult> {\n  return ExpoGaodeMapNavigationModule.independentDriveRoute(options);\n}\n\nexport async function followWebPlannedRoute(\n  options: FollowWebPlannedRouteOptions\n): Promise<FollowWebPlannedRouteResult> {\n  const {\n    from,\n    to,\n    webRoute,\n    strategy,\n    carNumber,\n    restriction,\n    maxDeviationMeters = 120,\n    startNavigation = false,\n    naviType = 0,\n  } = options;\n\n  const webPolyline = normalizeWebRoutePolyline(webRoute);\n  if (webPolyline.length < 2) {\n    throw new Error('webRoute.polyline 至少需要 2 个点');\n  }\n\n  // 第一步：从 Web 线路提取少量锚点，让原生独立算路先尽量往这条线靠。\n  const anchorWaypoints = buildAnchorWaypointsFromWebRoute(options);\n  const anchoredIndependentResult = await runIndependentDriveRoute({\n    from,\n    to,\n    strategy,\n    carNumber,\n    restriction,\n    waypoints: anchorWaypoints,\n  });\n\n  let independentResult = anchoredIndependentResult;\n  let evaluation = evaluateIndependentResultAgainstWebRoute(\n    anchoredIndependentResult,\n    webPolyline,\n    anchorWaypoints,\n    maxDeviationMeters\n  );\n  let navigationUsesAnchorWaypoints = anchorWaypoints.length > 0;\n\n  // 如果锚点路线已经足够接近，再尝试去掉锚点重算一次。\n  // 这样可以避免“为了贴线而被锚点拖偏”的情况。\n  if (evaluation.bestMatch && evaluation.mode !== 'preview_only' && anchorWaypoints.length > 0) {\n    try {\n      const directIndependentResult = await runIndependentDriveRoute({\n        from,\n        to,\n        strategy,\n        carNumber,\n        restriction,\n      });\n\n      const directEvaluation = evaluateIndependentResultAgainstWebRoute(\n        directIndependentResult,\n        webPolyline,\n        [],\n        maxDeviationMeters\n      );\n      const anchoredBest = evaluation.bestMatch;\n      const directBest = directEvaluation.bestMatch;\n\n      const canSwitchToDirectNavigation =\n        Boolean(directBest) &&\n        directEvaluation.mode !== 'preview_only' &&\n        directBest!.averageDeviationMeters <= Math.max(\n          anchoredBest.averageDeviationMeters + 45,\n          anchoredBest.averageDeviationMeters * 1.45\n        ) &&\n        directBest!.maxDeviationMeters <= Math.max(\n          anchoredBest.maxDeviationMeters + 90,\n          anchoredBest.maxDeviationMeters * 1.45\n        );\n\n      if (canSwitchToDirectNavigation) {\n        // 直连结果更自然，就切到直连结果，并清掉刚才的锚点算路缓存。\n        ExpoGaodeMapNavigationModule.clearIndependentRoute({\n          token: anchoredIndependentResult.token,\n        }).catch(() => {});\n        independentResult = directIndependentResult;\n        evaluation = directEvaluation;\n        navigationUsesAnchorWaypoints = false;\n        evaluation.reason =\n          directEvaluation.mode === 'matched'\n            ? '已切换为无途经点导航结果，且与 Web 规划线高度接近'\n            : '已切换为无途经点导航结果，但与 Web 规划线仍存在轻微偏差';\n      } else {\n        // 直连结果不如锚点方案，就保留锚点方案作为最终导航依据。\n        ExpoGaodeMapNavigationModule.clearIndependentRoute({\n          token: directIndependentResult.token,\n        }).catch(() => {});\n        evaluation.reason = `${evaluation.reason}；最终导航仍需依赖锚点途经点逼近 Web 线路`;\n      }\n    } catch {\n      evaluation.reason = `${evaluation.reason}；无途经点重算失败，最终导航仍需依赖锚点途经点`;\n    }\n  }\n\n  let navigationStarted = false;\n  if (startNavigation && evaluation.bestMatch && evaluation.mode !== 'preview_only') {\n    // 只有当评估结果足够接近时才真正启动导航，避免把偏差过大的结果直接交给导航 SDK。\n    navigationStarted = await ExpoGaodeMapNavigationModule.startNaviWithIndependentPath({\n      token: independentResult.token,\n      naviType,\n      routeId: evaluation.bestMatch.routeId,\n      routeIndex:\n        evaluation.bestMatch.routeId == null ? evaluation.bestMatch.routeIndex : undefined,\n    });\n  }\n\n  return {\n    mode: evaluation.mode,\n    token: independentResult.token,\n    anchorWaypoints,\n    webDistance: calculatePathLengthSafe(webPolyline),\n    nativeDistance:\n      evaluation.nativePolyline.length > 1\n        ? calculatePathLengthSafe(evaluation.nativePolyline)\n        : undefined,\n    selectedRouteId: evaluation.bestMatch?.routeId,\n    selectedRouteIndex: evaluation.bestMatch?.routeIndex,\n    averageDeviationMeters: evaluation.bestMatch?.averageDeviationMeters,\n    maxDeviationMeters: evaluation.bestMatch?.maxDeviationMeters,\n    navigationStarted,\n    navigationUsesAnchorWaypoints,\n    independentResult,\n    candidateMatches: evaluation.candidateMatches,\n    reason: evaluation.reason,\n  };\n}\n"]}

package/expo-module.config.json

@@ -14,7 +14,8 @@
       "MultiPointViewModule",
       "HeatMapViewModule",
       "ClusterViewModule",
-      "ExpoGaodeMapOfflineModule"
+      "ExpoGaodeMapOfflineModule",
+      "ExpoGaodeMapSearchModule"
     ]
   },
   "android": {
@@ -30,7 +31,8 @@
       "expo.modules.gaodemap.map.overlays.MultiPointViewModule",
       "expo.modules.gaodemap.map.overlays.HeatMapViewModule",
       "expo.modules.gaodemap.map.overlays.ClusterViewModule",
-      "expo.modules.gaodemap.map.ExpoGaodeMapOfflineModule"
+      "expo.modules.gaodemap.map.ExpoGaodeMapOfflineModule",
+      "expo.modules.gaodemap.map.search.ExpoGaodeMapSearchModule"
     ]
   }
 }

package/ios/ExpoGaodeMapNaviView.swift

@@ -442,6 +442,7 @@ public class ExpoGaodeMapNaviView: ExpoView {
   private var hasLoggedMissingBackgroundAudioMode: Bool = false
   private var renderedCustomWaypointAnnotations: [AMapNaviCompositeCustomAnnotation] = []
   private var customWaypointMarkers: [NaviCustomWaypointMarkerModel] = []
+  private let customSpeechSynthesizer = AVSpeechSynthesizer()
 
   private enum LaneStringKind {
     case background
@@ -1231,10 +1232,6 @@ public class ExpoGaodeMapNaviView: ExpoView {
   }
 
   private func resolveTravelTurnIconImage(iconType: Int) -> UIImage? {
-    let iconEnum = AMapNaviIconType(rawValue: iconType) ?? .none
-    if activeScene == .ride {
-      return AMapNaviRideView.rideViewTurnIconImage(with: iconEnum)
-    }
     return fallbackTurnIconImage(iconType: iconType)
   }
 
@@ -1637,11 +1634,7 @@ public class ExpoGaodeMapNaviView: ExpoView {
       let resizedImage = self?.resizeImageIfNeeded(image, targetSize: self?.carImageSize) ?? image
       driveView?.setCarImage(resizedImage)
       walkView?.setCarImage(resizedImage)
-      if let resizedImage {
-        rideView?.setCarImageWithSize(resizedImage)
-      } else {
-        rideView?.setCarImage(nil)
-      }
+      rideView?.setCarImage(resizedImage)
     }
   }
 
@@ -2323,18 +2316,24 @@ public class ExpoGaodeMapNaviView: ExpoView {
   }
   
   func playCustomTTS(text: String, forcePlay: Bool, promise: Promise) {
-    guard let manager = currentNaviManager() else {
+    guard currentNaviManager() != nil else {
       promise.reject("NAVI_MANAGER_UNAVAILABLE", "导航管理器尚未初始化")
       return
     }
-    let success = manager.playTTS(text, forcePlay: forcePlay)
-    if success {
-      promise.resolve([
-        "success": true
-      ])
-    } else {
-      promise.reject("PLAY_TTS_FAILED", "当前场景暂不支持或正在播报其他导航语音")
+
+    if forcePlay {
+      customSpeechSynthesizer.stopSpeaking(at: .immediate)
+    } else if customSpeechSynthesizer.isSpeaking {
+      promise.reject("PLAY_TTS_FAILED", "当前正在播报其他导航语音")
+      return
     }
+
+    let utterance = AVSpeechUtterance(string: text)
+    utterance.voice = AVSpeechSynthesisVoice(language: "zh-CN")
+    customSpeechSynthesizer.speak(utterance)
+    promise.resolve([
+      "success": true
+    ])
   }
   
   // MARK: - Lifecycle

package/ios/ExpoGaodeMapNavigation.podspec

@@ -24,9 +24,10 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency 'AMapNavi'
+  s.dependency 'AMapNavi','= 11.1.200'
   s.dependency 'AMapFoundation'
   s.dependency 'AMapLocation'
+  s.dependency 'AMapSearch'
   
   s.library = 'c++'
 

package/ios/map/ExpoGaodeMapOfflineModule.swift

@@ -2,6 +2,8 @@ import ExpoModulesCore
 import AMapFoundationKit
 import AMapNaviKit
 import Foundation
+import AMapNaviKit
+import UIKit
 
 /**
  * 高德地图离线地图模块 (iOS)
@@ -66,6 +68,12 @@ public class ExpoGaodeMapOfflineModule: Module {
       self.downloadingCities.removeAll()
       self.pausedCities.removeAll()
     }
+
+    AsyncFunction("openOfflineMapUI") { (promise: Promise) in
+      DispatchQueue.main.async {
+        self.openOfflineMapUI(promise: promise)
+      }
+    }
     
     // ==================== 1. 地图列表管理 ====================
     
@@ -383,6 +391,59 @@ public class ExpoGaodeMapOfflineModule: Module {
 
     return offlineMapManager
   }
+
+  private func openOfflineMapUI(promise: Promise) {
+    guard getOfflineMapManager() != nil else {
+      promise.reject("ERR_SETUP", "Setup failed")
+      return
+    }
+
+    guard let detailViewController = MAOfflineMapViewController.sharedInstance() else {
+      promise.reject("ERR_OFFLINE_MAP_UI", "Offline map UI is unavailable")
+      return
+    }
+
+    guard let presenter = currentPresenterViewController() else {
+      promise.reject("ERR_NO_VIEW_CONTROLLER", "No active view controller")
+      return
+    }
+
+    if let navigationController = presenter as? UINavigationController {
+      navigationController.pushViewController(detailViewController, animated: true)
+    } else if let navigationController = presenter.navigationController {
+      navigationController.pushViewController(detailViewController, animated: true)
+    } else {
+      let navigationController = UINavigationController(rootViewController: detailViewController)
+      presenter.present(navigationController, animated: true)
+    }
+    promise.resolve(nil)
+  }
+
+  private func currentPresenterViewController() -> UIViewController? {
+    guard let scene = UIApplication.shared.connectedScenes
+      .compactMap({ $0 as? UIWindowScene })
+      .first(where: { $0.activationState == .foregroundActive }) else {
+      return topViewController(from: UIApplication.shared.windows.first(where: { $0.isKeyWindow })?.rootViewController)
+    }
+
+    let root = scene.windows.first(where: { $0.isKeyWindow })?.rootViewController
+      ?? scene.windows.first?.rootViewController
+    return topViewController(from: root)
+  }
+
+  private func topViewController(from root: UIViewController?) -> UIViewController? {
+    guard let root else { return nil }
+    if let presented = root.presentedViewController {
+      return topViewController(from: presented)
+    }
+    if let navigationController = root as? UINavigationController {
+      return topViewController(from: navigationController.visibleViewController)
+    }
+    if let tabBarController = root as? UITabBarController {
+      return topViewController(from: tabBarController.selectedViewController)
+    }
+    return root
+  }
   
   private func ensureSetup(completion: @escaping (Bool) -> Void) {
     guard let manager = getOfflineMapManager() else {