expo-gaode-map-navigation 2.0.12-next.0 → 2.0.13

package/ios/services/NavigationLiveActivityManager.swift

@@ -0,0 +1,359 @@
+import Foundation
+import UIKit
+
+#if canImport(ActivityKit)
+import ActivityKit
+#endif
+
+struct NavigationLiveActivitySnapshot {
+  let appName: String
+  let currentRoadName: String
+  let nextRoadName: String
+  let pathRetainDistance: Int
+  let routeTotalDistance: Int
+  let pathRetainTime: Int
+  let curStepRetainDistance: Int
+  let iconType: Int
+  let turnIconBase64: String?
+}
+
+final class NavigationLiveActivityManager {
+  static let shared = NavigationLiveActivityManager()
+
+  private var currentActivityId: String?
+  private var hasLoggedMissingPlistSupport = false
+  private var hasLoggedSystemDisabled = false
+  private var lastSnapshot: NavigationLiveActivitySnapshot?
+  private var autoStopWorkItem: DispatchWorkItem?
+  private var delayedStopWorkItem: DispatchWorkItem?
+  private let staleTimeoutSeconds: TimeInterval = 45
+  private let maxEstimatedContentStateBytes = 3900
+  private let maxRoadNameCharacters = 22
+  private let maxAppNameCharacters = 18
+
+  private init() {}
+
+  func startOrUpdate(snapshot: NavigationLiveActivitySnapshot) {
+#if canImport(ActivityKit)
+    guard #available(iOS 16.1, *) else {
+      return
+    }
+
+    guard supportsLiveActivityByPlist() else {
+      return
+    }
+
+    guard ActivityAuthorizationInfo().areActivitiesEnabled else {
+      if !hasLoggedSystemDisabled {
+        hasLoggedSystemDisabled = true
+        NSLog("[ExpoGaodeMapNaviView][LiveActivity] Activities are disabled by system settings")
+      }
+      return
+    }
+    hasLoggedSystemDisabled = false
+
+    let normalizedSnapshot = NavigationLiveActivitySnapshot(
+      appName: snapshot.appName,
+      currentRoadName: snapshot.currentRoadName,
+      nextRoadName: snapshot.nextRoadName,
+      pathRetainDistance: max(snapshot.pathRetainDistance, 0),
+      routeTotalDistance: max(snapshot.routeTotalDistance, 0),
+      pathRetainTime: max(snapshot.pathRetainTime, 0),
+      curStepRetainDistance: max(snapshot.curStepRetainDistance, 0),
+      iconType: snapshot.iconType,
+      turnIconBase64: snapshot.turnIconBase64
+    )
+
+    let payloadSafeSnapshot = snapshotForPayloadBudget(from: normalizedSnapshot)
+    let contentState = makeContentState(from: payloadSafeSnapshot)
+    let attributes = NavigationLiveActivityAttributes(appName: payloadSafeSnapshot.appName)
+
+    if let activity = resolveCurrentActivity() {
+      lastSnapshot = payloadSafeSnapshot
+      Task {
+        if #available(iOS 16.2, *) {
+          let content = ActivityContent(state: contentState, staleDate: nil)
+          await activity.update(content)
+        } else {
+          await activity.update(using: contentState)
+        }
+      }
+      scheduleAutoStop()
+      return
+    }
+
+    do {
+      let activity: Activity<NavigationLiveActivityAttributes>
+      if #available(iOS 16.2, *) {
+        let content = ActivityContent(state: contentState, staleDate: nil)
+        activity = try Activity.request(attributes: attributes, content: content, pushType: nil)
+      } else {
+        activity = try Activity.request(attributes: attributes, contentState: contentState, pushType: nil)
+      }
+      currentActivityId = activity.id
+      lastSnapshot = payloadSafeSnapshot
+      scheduleAutoStop()
+    } catch {
+      NSLog("[ExpoGaodeMapNaviView][LiveActivity] request failed: \(error.localizedDescription)")
+    }
+#endif
+  }
+
+  func stop() {
+#if canImport(ActivityKit)
+    cancelAutoStop()
+    cancelDelayedStop()
+
+    guard #available(iOS 16.1, *) else {
+      return
+    }
+
+    guard let activity = resolveCurrentActivity() else {
+      currentActivityId = nil
+      return
+    }
+
+    let fallbackSnapshot = lastSnapshot ?? NavigationLiveActivitySnapshot(
+      appName: "",
+      currentRoadName: "",
+      nextRoadName: "",
+      pathRetainDistance: 0,
+      routeTotalDistance: 0,
+      pathRetainTime: 0,
+      curStepRetainDistance: 0,
+      iconType: 0,
+      turnIconBase64: nil
+    )
+    let fallback = NavigationLiveActivityAttributes.ContentState(
+      currentRoadName: fallbackSnapshot.currentRoadName,
+      nextRoadName: fallbackSnapshot.nextRoadName,
+      pathRetainDistance: fallbackSnapshot.pathRetainDistance,
+      routeTotalDistance: fallbackSnapshot.routeTotalDistance,
+      pathRetainTime: fallbackSnapshot.pathRetainTime,
+      curStepRetainDistance: fallbackSnapshot.curStepRetainDistance,
+      iconType: fallbackSnapshot.iconType,
+      turnIconBase64: fallbackSnapshot.turnIconBase64,
+      updatedAt: Date()
+    )
+
+    Task {
+      if #available(iOS 16.2, *) {
+        let content = ActivityContent(state: fallback, staleDate: nil)
+        await activity.end(content, dismissalPolicy: .immediate)
+      } else {
+        await activity.end(using: fallback, dismissalPolicy: .immediate)
+      }
+    }
+
+    currentActivityId = nil
+    lastSnapshot = nil
+#endif
+  }
+
+  func showArrivedAndStop(snapshot: NavigationLiveActivitySnapshot, dismissAfter seconds: TimeInterval = 6) {
+#if canImport(ActivityKit)
+    guard #available(iOS 16.1, *) else {
+      return
+    }
+
+    guard let activity = resolveCurrentActivity() else {
+      return
+    }
+
+    cancelAutoStop()
+    cancelDelayedStop()
+
+    let normalized = NavigationLiveActivitySnapshot(
+      appName: snapshot.appName,
+      currentRoadName: "",
+      nextRoadName: "",
+      pathRetainDistance: 0,
+      routeTotalDistance: max(snapshot.routeTotalDistance, 0),
+      pathRetainTime: 0,
+      curStepRetainDistance: 0,
+      iconType: 15,
+      turnIconBase64: nil
+    )
+    let payloadSafeSnapshot = snapshotForPayloadBudget(from: normalized)
+    let contentState = makeContentState(from: payloadSafeSnapshot)
+    lastSnapshot = payloadSafeSnapshot
+
+    Task {
+      if #available(iOS 16.2, *) {
+        let content = ActivityContent(state: contentState, staleDate: nil)
+        await activity.update(content)
+      } else {
+        await activity.update(using: contentState)
+      }
+    }
+
+    let delay = max(seconds, 1)
+    let workItem = DispatchWorkItem { [weak self] in
+      guard let self else {
+        return
+      }
+      NSLog(
+        "[ExpoGaodeMapNaviView][LiveActivity] arrived destination card displayed for %.0fs, stopping activity",
+        delay
+      )
+      self.stop()
+    }
+    delayedStopWorkItem = workItem
+    DispatchQueue.main.asyncAfter(deadline: .now() + delay, execute: workItem)
+#endif
+  }
+
+  private func scheduleAutoStop() {
+    cancelAutoStop()
+    let workItem = DispatchWorkItem { [weak self] in
+      guard let self else {
+        return
+      }
+      NSLog(
+        "[ExpoGaodeMapNaviView][LiveActivity] no updates for %.0fs, auto stopping activity",
+        self.staleTimeoutSeconds
+      )
+      self.stop()
+    }
+    autoStopWorkItem = workItem
+    DispatchQueue.main.asyncAfter(deadline: .now() + staleTimeoutSeconds, execute: workItem)
+  }
+
+  private func cancelAutoStop() {
+    autoStopWorkItem?.cancel()
+    autoStopWorkItem = nil
+  }
+
+  private func cancelDelayedStop() {
+    delayedStopWorkItem?.cancel()
+    delayedStopWorkItem = nil
+  }
+
+  private func supportsLiveActivityByPlist() -> Bool {
+    let enabled = (Bundle.main.object(forInfoDictionaryKey: "NSSupportsLiveActivities") as? Bool) == true
+    if !enabled && !hasLoggedMissingPlistSupport {
+      hasLoggedMissingPlistSupport = true
+      NSLog("[ExpoGaodeMapNaviView][LiveActivity] NSSupportsLiveActivities is not enabled in Info.plist")
+    }
+    return enabled
+  }
+
+#if canImport(ActivityKit)
+  @available(iOS 16.1, *)
+  private func makeContentState(from snapshot: NavigationLiveActivitySnapshot) -> NavigationLiveActivityAttributes.ContentState {
+    NavigationLiveActivityAttributes.ContentState(
+      currentRoadName: snapshot.currentRoadName,
+      nextRoadName: snapshot.nextRoadName,
+      pathRetainDistance: snapshot.pathRetainDistance,
+      routeTotalDistance: snapshot.routeTotalDistance,
+      pathRetainTime: snapshot.pathRetainTime,
+      curStepRetainDistance: snapshot.curStepRetainDistance,
+      iconType: snapshot.iconType,
+      turnIconBase64: snapshot.turnIconBase64,
+      updatedAt: Date()
+    )
+  }
+
+  @available(iOS 16.1, *)
+  private func estimateContentStateSizeBytes(snapshot: NavigationLiveActivitySnapshot) -> Int {
+    let state = makeContentState(from: snapshot)
+    guard let encoded = try? JSONEncoder().encode(state) else {
+      return Int.max
+    }
+    return encoded.count
+  }
+
+  private func truncateCharacters(_ value: String, maxCharacters: Int) -> String {
+    guard maxCharacters > 0, value.count > maxCharacters else {
+      return value
+    }
+    return String(value.prefix(maxCharacters))
+  }
+
+  @available(iOS 16.1, *)
+  private func snapshotForPayloadBudget(from snapshot: NavigationLiveActivitySnapshot) -> NavigationLiveActivitySnapshot {
+    let originalEstimated = estimateContentStateSizeBytes(snapshot: snapshot)
+    var candidate = snapshot
+    var estimated = originalEstimated
+    if estimated <= maxEstimatedContentStateBytes {
+      return candidate
+    }
+
+    // Keep turn icon as long as possible; trim text first.
+    candidate = NavigationLiveActivitySnapshot(
+      appName: truncateCharacters(candidate.appName, maxCharacters: maxAppNameCharacters),
+      currentRoadName: truncateCharacters(candidate.currentRoadName, maxCharacters: maxRoadNameCharacters),
+      nextRoadName: truncateCharacters(candidate.nextRoadName, maxCharacters: maxRoadNameCharacters),
+      pathRetainDistance: candidate.pathRetainDistance,
+      routeTotalDistance: candidate.routeTotalDistance,
+      pathRetainTime: candidate.pathRetainTime,
+      curStepRetainDistance: candidate.curStepRetainDistance,
+      iconType: candidate.iconType,
+      turnIconBase64: candidate.turnIconBase64
+    )
+    estimated = estimateContentStateSizeBytes(snapshot: candidate)
+    if estimated <= maxEstimatedContentStateBytes {
+      NSLog(
+        "[ExpoGaodeMapNaviView][LiveActivity] payload %dB exceeds budget, trimmed text to %dB while keeping turn icon",
+        originalEstimated,
+        estimated
+      )
+      return candidate
+    }
+
+    let strippedText = NavigationLiveActivitySnapshot(
+      appName: truncateCharacters(candidate.appName, maxCharacters: maxAppNameCharacters),
+      currentRoadName: "",
+      nextRoadName: "",
+      pathRetainDistance: candidate.pathRetainDistance,
+      routeTotalDistance: candidate.routeTotalDistance,
+      pathRetainTime: candidate.pathRetainTime,
+      curStepRetainDistance: candidate.curStepRetainDistance,
+      iconType: candidate.iconType,
+      turnIconBase64: candidate.turnIconBase64
+    )
+    let strippedTextEstimated = estimateContentStateSizeBytes(snapshot: strippedText)
+    if strippedTextEstimated <= maxEstimatedContentStateBytes {
+      NSLog(
+        "[ExpoGaodeMapNaviView][LiveActivity] payload %dB exceeds budget, cleared road text to %dB while keeping turn icon",
+        originalEstimated,
+        strippedTextEstimated
+      )
+      return strippedText
+    }
+
+    let droppedIcon = NavigationLiveActivitySnapshot(
+      appName: strippedText.appName,
+      currentRoadName: strippedText.currentRoadName,
+      nextRoadName: strippedText.nextRoadName,
+      pathRetainDistance: strippedText.pathRetainDistance,
+      routeTotalDistance: strippedText.routeTotalDistance,
+      pathRetainTime: strippedText.pathRetainTime,
+      curStepRetainDistance: strippedText.curStepRetainDistance,
+      iconType: strippedText.iconType,
+      turnIconBase64: nil
+    )
+    let droppedIconEstimated = estimateContentStateSizeBytes(snapshot: droppedIcon)
+    NSLog(
+      "[ExpoGaodeMapNaviView][LiveActivity] payload still too large after text trim (%dB), dropped turn icon to %dB",
+      strippedTextEstimated,
+      droppedIconEstimated
+    )
+    return droppedIcon
+  }
+#endif
+
+#if canImport(ActivityKit)
+  @available(iOS 16.1, *)
+  private func resolveCurrentActivity() -> Activity<NavigationLiveActivityAttributes>? {
+    if let id = currentActivityId,
+       let matched = Activity<NavigationLiveActivityAttributes>.activities.first(where: { $0.id == id }) {
+      return matched
+    }
+
+    let first = Activity<NavigationLiveActivityAttributes>.activities.first
+    currentActivityId = first?.id
+    return first
+  }
+#endif
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-gaode-map-navigation",
-  "version": "2.0.12-next.0",
-  "description": "高德地图导航功能模块 - 路径规划、导航引导，独立版本包含完整地图功能",
+  "version": "2.0.13",
+  "description": "React Native AMap (Gaode Map) navigation module for Expo: route planning and turn-by-turn navigation, includes full map features.",
   "author": "TomWq <582752848@qq.com> (https://github.com/TomWq)",
   "repository": {
     "type": "git",
@@ -17,22 +17,26 @@
     "lint": "expo-module lint",
     "test": "expo-module test",
     "prepare": "expo-module prepare && yarn build:plugin",
+    "postinstall": "node scripts/check-expo-modules.js",
     "prepublishOnly": "echo 'Skipping proofread check' && exit 0",
     "expo-module": "expo-module",
     "android": "expo run:android",
     "ios": "expo run:ios"
   },
   "devDependencies": {
+    "@expo/vector-icons": "^15.0.3",
     "@types/react": "~19.1.0",
-    "expo": "^54.0.31",
-    "expo-module-scripts": "^5.0.8",
-    "react-native": "0.81.5",
+    "expo": "^55.0.8",
+    "expo-module-scripts": "^55.0.2",
+    "react-native": "0.83.2",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
+    "@expo/vector-icons": "*",
     "expo": "*",
     "react": "*",
-    "react-native": "*"
+    "react-native": "*",
+    "react-native-safe-area-context": "*"
   },
   "peerDependenciesMeta": {
     "expo": {
@@ -46,7 +50,9 @@
     "build",
     "android",
     "ios",
+    "widget-template",
     "shared",
+    "scripts",
     "app.plugin.js",
     "expo-module.config.json",
     "plugin/build"
@@ -56,11 +62,20 @@
     "react-native",
     "expo",
     "expo-gaode-map",
+    "expo-gaode-map-navigation",
+    "expo-amap",
+    "react-native-amap",
+    "react-native-gaode-map",
+    "rn-amap-navigation",
     "amap",
+    "gaode-map",
     "navigation",
+    "route-planning",
+    "turn-by-turn",
     "route",
     "高德地图",
-    "导航"
+    "导航",
+    "路径规划"
   ],
   "license": "MIT"
 }

package/plugin/build/withGaodeMap.d.ts

@@ -13,6 +13,14 @@ export type GaodeMapPluginProps = {
     locationDescription?: string;
     /** 是否启用后台定位（Android & iOS） */
     enableBackgroundLocation?: boolean;
+    /** iOS 是否启用后台音频（用于后台导航语音播报） */
+    enableBackgroundAudio?: boolean;
+    /** 是否启用后台导航常驻通知（Android） */
+    enableNavigationNotification?: boolean;
+    /** 是否启用 iOS Live Activity（锁屏/灵动岛） */
+    enableIOSLiveActivity?: boolean;
+    /** 是否启用 iOS Live Activity 高频更新能力 */
+    enableIOSLiveActivityFrequentUpdates?: boolean;
     /**
      * 自定义高德地图 SDK 路径（例如 Google Play 版本）
      * 相对于项目根目录的路径，例如 "./libs/AMap_3DMap_V9.0.0_GooglePlay.aar"

package/plugin/build/withGaodeMap.js

@@ -27,8 +27,19 @@ const withGaodeMapInfoPlist = (config, props) => {
                 if (!config.modResults.UIBackgroundModes.includes('location')) {
                     config.modResults.UIBackgroundModes.push('location');
                 }
+                const shouldEnableBackgroundAudio = props.enableBackgroundAudio ?? true;
+                if (shouldEnableBackgroundAudio && !config.modResults.UIBackgroundModes.includes('audio')) {
+                    config.modResults.UIBackgroundModes.push('audio');
+                }
             }
         }
+        if (props.enableIOSLiveActivity !== undefined) {
+            config.modResults.NSSupportsLiveActivities = !!props.enableIOSLiveActivity;
+        }
+        if (props.enableIOSLiveActivityFrequentUpdates !== undefined) {
+            config.modResults.NSSupportsLiveActivitiesFrequentUpdates =
+                !!props.enableIOSLiveActivityFrequentUpdates;
+        }
         return config;
     });
 };
@@ -54,6 +65,7 @@ const withGaodeMapAndroidManifest = (config, props) => {
             'android.permission.ACCESS_NETWORK_STATE',
             'android.permission.ACCESS_WIFI_STATE',
             'android.permission.READ_PHONE_STATE',
+            'android.permission.WAKE_LOCK',
             'android.permission.BLUETOOTH',
             'android.permission.BLUETOOTH_ADMIN',
         ];
@@ -68,8 +80,9 @@ const withGaodeMapAndroidManifest = (config, props) => {
                 });
             }
         });
-        // 后台定位权限（可选，仅在 enableBackgroundLocation 为 true 时添加）
-        if (props.enableBackgroundLocation) {
+        const requiresForegroundLocationService = props.enableBackgroundLocation || props.enableNavigationNotification;
+        // 后台定位/导航前台服务权限（可选）
+        if (requiresForegroundLocationService) {
             const backgroundPermissions = [
                 'android.permission.ACCESS_BACKGROUND_LOCATION',
                 'android.permission.FOREGROUND_SERVICE',
@@ -87,6 +100,21 @@ const withGaodeMapAndroidManifest = (config, props) => {
                 }
             });
         }
+        // Android 13+ 通知权限（仅在启用导航常驻通知时添加）
+        if (props.enableNavigationNotification) {
+            const notificationPermissions = [
+                'android.permission.POST_NOTIFICATIONS',
+                'android.permission.POST_PROMOTED_NOTIFICATIONS',
+            ];
+            notificationPermissions.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) {
@@ -94,11 +122,27 @@ const withGaodeMapAndroidManifest = (config, props) => {
                 mainApplication['service'] = [];
             }
             // 检查是否已存在 LocationForegroundService
-            const hasService = mainApplication['service'].some((item) => item.$?.['android:name'] === 'expo.modules.gaodemap.services.LocationForegroundService');
+            const hasService = mainApplication['service'].some((item) => item.$?.['android:name'] === 'expo.modules.gaodemap.map.services.LocationForegroundService');
             if (!hasService) {
                 mainApplication['service'].push({
                     $: {
-                        'android:name': 'expo.modules.gaodemap.services.LocationForegroundService',
+                        'android:name': 'expo.modules.gaodemap.map.services.LocationForegroundService',
+                        'android:enabled': 'true',
+                        'android:exported': 'false',
+                        'android:foregroundServiceType': 'location',
+                    },
+                });
+            }
+        }
+        if (mainApplication && props.enableNavigationNotification) {
+            if (!mainApplication['service']) {
+                mainApplication['service'] = [];
+            }
+            const hasNavigationService = mainApplication['service'].some((item) => item.$?.['android:name'] === 'expo.modules.gaodemap.navigation.services.NavigationForegroundService');
+            if (!hasNavigationService) {
+                mainApplication['service'].push({
+                    $: {
+                        'android:name': 'expo.modules.gaodemap.navigation.services.NavigationForegroundService',
                         'android:enabled': 'true',
                         'android:exported': 'false',
                         'android:foregroundServiceType': 'location',
@@ -192,6 +236,18 @@ configurations.all {
  */
 const withGaodeMapAndroidSdk = (config, props) => {
     return (0, config_plugins_1.withGradleProperties)(config, (config) => {
+        const jetifierKey = 'android.enableJetifier';
+        const jetifier = config.modResults.find((item) => item.type === 'property' && item.key === jetifierKey);
+        if (jetifier && jetifier.type === 'property') {
+            jetifier.value = 'true';
+        }
+        else {
+            config.modResults.push({
+                type: 'property',
+                key: jetifierKey,
+                value: 'true',
+            });
+        }
         if (props.customMapSdkPath) {
             const key = 'EXPO_GAODE_MAP_CUSTOM_SDK_PATH';
             const existing = config.modResults.find((item) => item.type === 'property' && item.key === key);

package/scripts/check-expo-modules.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function resolveProjectRoot() {
+  return process.env.INIT_CWD || process.env.npm_config_local_prefix || process.cwd();
+}
+
+function hasPackage(pkgName, projectRoot) {
+  try {
+    require.resolve(`${pkgName}/package.json`, { paths: [projectRoot] });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function printWarning(lines) {
+  const prefix = '[expo-gaode-map-navigation]';
+  console.warn(`${prefix} WARNING: Expo Modules infrastructure was not detected in this React Native project.`);
+  for (const line of lines) {
+    console.warn(`${prefix} ${line}`);
+  }
+}
+
+function main() {
+  const projectRoot = resolveProjectRoot();
+
+  // Skip non-React Native consumers.
+  if (!hasPackage('react-native', projectRoot)) {
+    return;
+  }
+
+  const hasExpo = hasPackage('expo', projectRoot);
+  const hasExpoModulesCore = hasPackage('expo-modules-core', projectRoot);
+  const podfilePath = path.join(projectRoot, 'ios', 'Podfile');
+  const hasPodfile = fs.existsSync(podfilePath);
+  const hasUseExpoModules = hasPodfile
+    ? /\buse_expo_modules!\b/m.test(fs.readFileSync(podfilePath, 'utf8'))
+    : true;
+
+  if (hasExpo && hasExpoModulesCore && hasUseExpoModules) {
+    return;
+  }
+
+  const details = [];
+  if (!hasExpo) {
+    details.push('Missing dependency: expo');
+  }
+  if (!hasExpoModulesCore) {
+    details.push('Missing dependency: expo-modules-core');
+  }
+  if (!hasUseExpoModules) {
+    details.push('iOS Podfile does not contain use_expo_modules!');
+  }
+
+  printWarning([
+    ...details,
+    'This package requires Expo Modules infrastructure even in bare React Native apps.',
+    'Suggested fix:',
+    '  npx install-expo-modules@latest',
+    hasPodfile ? '  (then) cd ios && pod install' : null,
+    'Docs: https://docs.expo.dev/bare/installing-expo-modules/',
+  ].filter(Boolean));
+}
+
+main();