expo-gaode-map-navigation 1.1.4 → 1.1.5-next.1

package/build/map/ExpoGaodeMapModule.js

@@ -28,9 +28,8 @@ const ExpoGaodeMapModuleWithHelpers = {
      * 初始化 SDK，并缓存配置（包含 webKey）
      */
     initSDK(config) {
-        var _a;
-        _sdkConfig = config !== null && config !== void 0 ? config : null;
-        (_a = nativeModule === null || nativeModule === void 0 ? void 0 : nativeModule.initSDK) === null || _a === void 0 ? void 0 : _a.call(nativeModule, config);
+        _sdkConfig = config ?? null;
+        nativeModule?.initSDK?.(config);
     },
     /**
      * 添加定位监听器（便捷方法）
@@ -40,9 +39,8 @@ const ExpoGaodeMapModuleWithHelpers = {
      * @throws 如果底层模块不可用，返回一个空操作的订阅对象
      */
     addLocationListener(listener) {
-        var _a;
         // 使用可选链和空值合并，确保即使模块不可用也不会崩溃
-        return ((_a = nativeModule === null || nativeModule === void 0 ? void 0 : nativeModule.addListener) === null || _a === void 0 ? void 0 : _a.call(nativeModule, 'onLocationUpdate', listener)) || {
+        return nativeModule?.addListener?.('onLocationUpdate', listener) || {
             remove: () => { },
         };
     },
@@ -57,6 +55,6 @@ function getSDKConfig() {
 * 获取用于 Web API 的 webKey（若未初始化或未提供则返回 undefined）
 */
 function getWebKey() {
-    return _sdkConfig === null || _sdkConfig === void 0 ? void 0 : _sdkConfig.webKey;
+    return _sdkConfig?.webKey;
 }
 exports.default = ExpoGaodeMapModuleWithHelpers;

package/build/map/index.d.ts

@@ -1,9 +1,7 @@
 export * from './ExpoGaodeMap.types';
-export * from './types';
 export { default as ExpoGaodeMapModule, getWebKey, getSDKConfig } from './ExpoGaodeMapModule';
 export type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';
 export { default as MapView } from './ExpoGaodeMapView';
-export type { MapViewRef } from './ExpoGaodeMapView';
 export { Marker, Polyline, Polygon, Circle, HeatMap, MultiPoint, Cluster, } from './components/overlays';
 export { requireModule, OptionalModules, getInstalledModules, printModuleInfo, createLazyLoader, } from './utils/ModuleLoader';
 export { default } from './ExpoGaodeMapModule';

package/build/map/index.js

@@ -20,7 +20,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = exports.createLazyLoader = exports.printModuleInfo = exports.getInstalledModules = exports.OptionalModules = exports.requireModule = exports.Cluster = exports.MultiPoint = exports.HeatMap = exports.Circle = exports.Polygon = exports.Polyline = exports.Marker = exports.MapView = exports.getSDKConfig = exports.getWebKey = exports.ExpoGaodeMapModule = void 0;
 // 导出类型定义
 __exportStar(require("./ExpoGaodeMap.types"), exports);
-__exportStar(require("./types"), exports);
 // 导出原生模块 - 直接使用，无需封装
 var ExpoGaodeMapModule_1 = require("./ExpoGaodeMapModule");
 Object.defineProperty(exports, "ExpoGaodeMapModule", { enumerable: true, get: function () { return __importDefault(ExpoGaodeMapModule_1).default; } });

package/build/map/types/overlays.types.d.ts

@@ -336,5 +336,5 @@ export interface ClusterProps {
     /**
      * 聚合点点击事件
      */
-    onPress?: (event: NativeSyntheticEvent<ClusterParams>) => void;
+    onClusterPress?: (event: NativeSyntheticEvent<ClusterParams>) => void;
 }

package/build/map/utils/EventManager.js

@@ -17,7 +17,7 @@ class EventManager {
     }
     trigger(id, eventType, data) {
         const callbacks = this.callbacks.get(id);
-        const callback = callbacks === null || callbacks === void 0 ? void 0 : callbacks[eventType];
+        const callback = callbacks?.[eventType];
         if (typeof callback === 'function') {
             callback(data);
         }

package/build/types/naviview.types.d.ts

@@ -106,13 +106,6 @@ export interface NaviViewProps extends ViewProps {
      * @since 6.2.0
      */
     carOverlayVisible?: boolean;
-    /**
-     * 是否显示交通信号灯
-     * @platform android
-     * @default true
-     * @since 7.4.0
-     */
-    trafficLightsVisible?: boolean;
     /**
      * 路线标记点可见性配置
      * @platform android
@@ -152,26 +145,25 @@ export interface NaviViewProps extends ViewProps {
      */
     showTrafficLightView?: boolean;
     /**
-     * 是否显示路线
-     * @platform ios
-     * @default true
+     * 导航界面顶部与状态栏的间距（单位：dp）
+     * @platform android
+     * @default 状态栏高度（单位：dp）
      */
-    showRoute?: boolean;
+    androidStatusBarPaddingTop?: number;
     /**
-     * 是否显示转向箭头
+     * 是否显示路线
      * @platform ios
      * @default true
      */
-    showTurnArrow?: boolean;
+    showRoute?: boolean;
     /**
      * 是否显示路况光柱
-     * @platform ios
      * @default true
      */
     showTrafficBar?: boolean;
     /**
      * 是否显示全览按钮
-     * @platform ios
+     *
      * @default true
      */
     showBrowseRouteButton?: boolean;
@@ -183,31 +175,41 @@ export interface NaviViewProps extends ViewProps {
     showMoreButton?: boolean;
     /**
      * 是否显示实时交通按钮
-     * @platform ios
+     *
      * @default true
      */
     showTrafficButton?: boolean;
     /**
      * 是否显示界面元素（设为false可完全自定义界面）
-     * @platform ios
+     * 提示：ios 暂时无效，android 有效
      * @default true
      */
     showUIElements?: boolean;
     /**
      * 走过的路线是否置灰
-     * @platform ios
+     *
      * @default false
      */
     showGreyAfterPass?: boolean;
     /**
      * 是否显示牵引线（起点到终点的飞线）
-     * @platform ios
+     *
      * @default true
      */
     showVectorline?: boolean;
+    /**
+     * 设置是否为骑步行视图
+     * @platform android
+     * @default false
+     */
+    isNaviTravelView?: boolean;
+    /**
+     * 是否显示指南针
+     * @default true
+     */
+    showCompassEnabled?: boolean;
     /**
      * 是否显示红绿灯图标
-     * @platform ios
      * @default true
      */
     showTrafficLights?: boolean;

package/ios/ExpoGaodeMapNaviView.swift

@@ -5,6 +5,7 @@
 //  
 //
 
+import Foundation
 import ExpoModulesCore
 import AMapNaviKit
 
@@ -84,6 +85,11 @@ public class ExpoGaodeMapNaviView: ExpoView {
   
   // MARK: - Properties
   private var driveView: AMapNaviDriveView?
+  private var driveViewLoaded: Bool = false
+  private var pendingShowUIElements: Bool?
+  private var pendingShowUIElementsWorkItem: DispatchWorkItem?
+  private var hasStartedNavi: Bool = false
+  private var hasReceivedFirstNaviData: Bool = false
   private var driveManager: AMapNaviDriveManager?
   
   // Props - 通用属性
@@ -136,7 +142,7 @@ public class ExpoGaodeMapNaviView: ExpoView {
     didSet { driveView?.showTrafficButton = showTrafficButton }
   }
   var showUIElements: Bool = true {
-    didSet { driveView?.showUIElements = showUIElements }
+    didSet { applyShowUIElementsToDriveViewIfReady() }
   }
   var showGreyAfterPass: Bool = false {
     didSet { driveView?.showGreyAfterPass = showGreyAfterPass }
@@ -153,6 +159,10 @@ public class ExpoGaodeMapNaviView: ExpoView {
   var lineWidth: CGFloat = 0 {
     didSet { driveView?.lineWidth = lineWidth }
   }
+
+  func applyShowUIElements(_ visible: Bool) {
+    showUIElements = visible
+  }
   
   // 坐标
   private var startCoordinate: AMapNaviPoint?
@@ -222,15 +232,68 @@ public class ExpoGaodeMapNaviView: ExpoView {
     driveView?.showBrowseRouteButton = showBrowseRouteButton
     driveView?.showMoreButton = showMoreButton
     driveView?.showTrafficButton = showTrafficButton
-    driveView?.showUIElements = showUIElements
     driveView?.showGreyAfterPass = showGreyAfterPass
     driveView?.showVectorline = showVectorline
     driveView?.showTrafficLights = showTrafficLights
     if lineWidth > 0 {
       driveView?.lineWidth = lineWidth
     }
+
+    applyShowUIElementsToDriveViewIfReady()
   }
-  
+
+  private func applyShowUIElementsToDriveViewIfReady() {
+    guard driveView != nil else {
+      pendingShowUIElements = showUIElements
+      return
+    }
+
+    guard driveViewLoaded else {
+      pendingShowUIElements = showUIElements
+      return
+    }
+
+    let value = pendingShowUIElements ?? showUIElements
+    pendingShowUIElements = nil
+
+    if value == false && (!hasStartedNavi || !hasReceivedFirstNaviData) {
+      pendingShowUIElements = false
+      pendingShowUIElementsWorkItem?.cancel()
+      let workItem = DispatchWorkItem { [weak self] in
+        guard let self else { return }
+        self.applyDriveViewShowUIElements(true, remainingAttempts: 20)
+      }
+      pendingShowUIElementsWorkItem = workItem
+      DispatchQueue.main.asyncAfter(deadline: .now() + 0.08, execute: workItem)
+      return
+    }
+
+    pendingShowUIElementsWorkItem?.cancel()
+    let workItem = DispatchWorkItem { [weak self] in
+      guard let self else { return }
+      self.applyDriveViewShowUIElements(value, remainingAttempts: 20)
+    }
+    pendingShowUIElementsWorkItem = workItem
+
+    DispatchQueue.main.asyncAfter(deadline: .now() + 0.08, execute: workItem)
+  }
+
+  private func applyDriveViewShowUIElements(_ value: Bool, remainingAttempts: Int) {
+    guard let driveView else { return }
+
+    if driveView.bounds.isEmpty {
+      if remainingAttempts <= 0 {
+        return
+      }
+      DispatchQueue.main.asyncAfter(deadline: .now() + 0.05) { [weak self] in
+        self?.applyDriveViewShowUIElements(value, remainingAttempts: remainingAttempts - 1)
+      }
+      return
+    }
+
+    driveView.showUIElements = value
+  }
+
   // MARK: - Prop Setters
   private func applyShowCamera(_ show: Bool) {
     driveView?.showCamera = show
@@ -366,6 +429,7 @@ public class ExpoGaodeMapNaviView: ExpoView {
 extension ExpoGaodeMapNaviView: AMapNaviDriveManagerDelegate {
   
   public func driveManager(onCalculateRouteSuccess driveManager: AMapNaviDriveManager) {
+    hasStartedNavi = true
     onRouteCalculated([
       "success": true,
       "naviType": naviType
@@ -377,6 +441,8 @@ extension ExpoGaodeMapNaviView: AMapNaviDriveManagerDelegate {
     } else {
       driveManager.startGPSNavi()
     }
+
+    applyShowUIElementsToDriveViewIfReady()
   }
   
   public func driveManager(_ driveManager: AMapNaviDriveManager, onCalculateRouteFailure error: Error) {
@@ -387,10 +453,13 @@ extension ExpoGaodeMapNaviView: AMapNaviDriveManagerDelegate {
   }
   
   public func driveManager(_ driveManager: AMapNaviDriveManager, didStartNavi naviMode: AMapNaviMode) {
+    hasStartedNavi = true
     onNavigationStarted([
       "type": naviMode == .emulator ? 1 : 0,
       "isEmulator": naviMode == .emulator
     ])
+
+    applyShowUIElementsToDriveViewIfReady()
   }
   
   public func driveManagerNavi(_ driveManager: AMapNaviDriveManager, didArrive wayPoint: AMapNaviPoint) {
@@ -404,6 +473,10 @@ extension ExpoGaodeMapNaviView: AMapNaviDriveManagerDelegate {
   }
   
   public func driveManager(_ driveManager: AMapNaviDriveManager, didUpdate naviLocation: AMapNaviLocation) {
+    if !hasReceivedFirstNaviData {
+      hasReceivedFirstNaviData = true
+      applyShowUIElementsToDriveViewIfReady()
+    }
     onLocationUpdate([
       "latitude": naviLocation.coordinate.latitude,
       "longitude": naviLocation.coordinate.longitude,
@@ -413,6 +486,10 @@ extension ExpoGaodeMapNaviView: AMapNaviDriveManagerDelegate {
   }
   
   public func driveManager(_ driveManager: AMapNaviDriveManager, didUpdate naviInfo: AMapNaviInfo) {
+    if !hasReceivedFirstNaviData {
+      hasReceivedFirstNaviData = true
+      applyShowUIElementsToDriveViewIfReady()
+    }
     onNavigationInfoUpdate([
       "currentRoadName": naviInfo.currentRoadName ?? "",
       "nextRoadName": naviInfo.nextRoadName ?? "",
@@ -458,6 +535,13 @@ extension ExpoGaodeMapNaviView: AMapNaviDriveManagerDelegate {
 extension ExpoGaodeMapNaviView: AMapNaviDriveViewDelegate {
   
   public func driveViewDidLoad(_ driveView: AMapNaviDriveView) {
+    driveViewLoaded = true
+    applyViewOptions()
+    applyShowUIElementsToDriveViewIfReady()
     onNavigationReady([:])
   }
+
+  public func driveViewEdgePadding(_ driveView: AMapNaviDriveView) -> UIEdgeInsets {
+    return .zero
+  }
 }

package/ios/ExpoGaodeMapNaviViewModule.swift

@@ -76,7 +76,7 @@ public class ExpoGaodeMapNaviViewModule: Module {
         view.showRoute = value
       }
       
-      Prop("showTurnArrow") { (view: ExpoGaodeMapNaviView, value: Bool) in
+      Prop("naviArrowVisible") { (view: ExpoGaodeMapNaviView, value: Bool) in
         view.showTurnArrow = value
       }
       
@@ -97,7 +97,7 @@ public class ExpoGaodeMapNaviViewModule: Module {
       }
       
       Prop("showUIElements") { (view: ExpoGaodeMapNaviView, value: Bool) in
-        view.showUIElements = value
+        view.applyShowUIElements(value)
       }
       
       Prop("showGreyAfterPass") { (view: ExpoGaodeMapNaviView, value: Bool) in

package/ios/map/modules/LocationManager.swift

@@ -1,6 +1,7 @@
 import Foundation
 import AMapLocationKit
 import CoreLocation
+import ExpoModulesCore
 
 /**
  * 定位管理器
@@ -123,6 +124,13 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
      * @param allows 是否允许后台定位
      */
     func setAllowsBackgroundLocationUpdates(_ allows: Bool) {
+        if allows {
+            let backgroundModes = Bundle.main.object(forInfoDictionaryKey: "UIBackgroundModes") as? [String]
+            if backgroundModes?.contains("location") != true {
+                log.warn("⚠️ [ExpoGaodeMap] iOS 后台定位未正确配置，setAllowsBackgroundLocationUpdates(true) 可能不会生效，请检查 Info.plist 是否包含 UIBackgroundModes: location，或者在 app.json 中配置 enableBackgroundLocation: true，然后重新执行 npx expo prebuild")
+                return
+            }
+        }
         locationManager?.allowsBackgroundLocationUpdates = allows
     }
     
@@ -262,4 +270,4 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
     func amapLocationManager(_ manager: AMapLocationManager!, didFailWithError error: Error!) {
         // 定位失败 - 静默处理
     }
-}
+}

package/package.json

@@ -1,17 +1,11 @@
 {
   "name": "expo-gaode-map-navigation",
-  "version": "1.1.4",
+  "version": "1.1.5-next.1",
   "description": "高德地图导航功能模块 - 路径规划、导航引导，独立版本包含完整地图功能",
+  "author": "<TomWq> (https://github.com/TomWq)",
+  "repository": "https://github.com/TomWq/expo-gaode-map",
   "main": "build/index.js",
   "types": "build/index.d.ts",
-  "files": [
-    "build",
-    "android",
-    "ios",
-    "app.plugin.js",
-    "expo-module.config.json",
-    "plugin/build"
-  ],
   "scripts": {
     "build": "expo-module build && bun run build:plugin",
     "build:plugin": "tsc --project plugin/tsconfig.json",
@@ -19,9 +13,34 @@
     "lint": "expo-module lint",
     "test": "expo-module test",
     "prepare": "expo-module prepare && bun run build:plugin",
-    "prepublishOnly": "expo-module prepublishOnly",
+    "prepublishOnly": "echo 'Skipping proofread check' && exit 0",
     "expo-module": "expo-module"
   },
+  "devDependencies": {
+    "@expo/config-plugins": "~54.0.4",
+    "@types/react": "~19.1.0",
+    "expo": "^54.0.31",
+    "expo-module-scripts": "^5.0.8",
+    "react-native": "0.81.5",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  },
+  "bugs": {
+    "url": "https://github.com/TomWq/expo-gaode-map/issues"
+  },
+  "files": [
+    "build",
+    "android",
+    "ios",
+    "app.plugin.js",
+    "expo-module.config.json",
+    "plugin/build"
+  ],
+  "homepage": "https://github.com/TomWq/expo-gaode-map#readme",
   "keywords": [
     "react-native",
     "expo",
@@ -32,27 +51,5 @@
     "高德地图",
     "导航"
   ],
-  "repository": "https://github.com/TomWq/expo-gaode-map",
-  "bugs": {
-    "url": "https://github.com/TomWq/expo-gaode-map/issues"
-  },
-  "author": "<TomWq> (https://github.com/TomWq)",
-  "license": "MIT",
-  "homepage": "https://github.com/TomWq/expo-gaode-map#readme",
-  "dependencies": {
-    "supercluster": "^8.0.1"
-  },
-  "devDependencies": {
-    "@expo/config-plugins": "^9.1.7",
-    "@types/react": "~19.1.0",
-    "expo": "^54.0.18",
-    "expo-module-scripts": "^5.0.7",
-    "react-native": "0.81.5",
-    "typescript": "^5.9.3"
-  },
-  "peerDependencies": {
-    "expo": "*",
-    "react": "*",
-    "react-native": "*"
-  }
+  "license": "MIT"
 }