expo-gaode-map-navigation 2.0.12 → 2.0.14

package/README.md

@@ -5,15 +5,16 @@
 ## 特性
 
 - 🗺️ **地图渲染**：内置完整地图能力，支持 Marker、Polyline、Polygon、Circle、Cluster、HeatMap 等覆盖物。
+- 🔍 **原生搜索**：内置 POI 搜索、周边搜索、沿途搜索、输入提示、逆地理编码等搜索能力。
 - 🚗 **多模式路径规划**：支持驾车、步行、骑行、电动车、货车、摩托车等多种出行方式。
-- 🧭 **实时导航 UI**：提供 `NaviView` 官方嵌入视图，并暴露完整事件与原生参数，方便你自行定制导航界面。
+- 🧭 **实时导航 UI**：提供 `ExpoGaodeMapNaviView` 官方嵌入视图，并暴露完整事件与原生参数，方便你自行定制导航界面。
 - 🛣️ **独立路径规划**：支持“先算路、再导航”的高级模式，可实现多路线对比与选择。
 - ⚙️ **策略丰富**：支持速度优先、避让拥堵、少收费、不走高速等多种算路策略。
 - ✅ **开箱即用**：封装了 Android/iOS 原生导航 SDK，统一 JS 接口。
 
 ## 安装
 
-本模块已包含地图与导航的所有能力，**不需要**、也不应同时安装 `expo-gaode-map`。
+本模块已包含地图、搜索与导航能力，**不需要**、也不应同时安装 `expo-gaode-map` 或 `expo-gaode-map-search`。
 
 ```bash
 # bun
@@ -29,6 +30,10 @@ npm install expo-gaode-map-navigation
 **⚠️ 重要提示：**
 如果项目中已安装 `expo-gaode-map`，请务必先卸载，否则会导致 Android 端二进制冲突（`3dmap` vs `navi-3dmap`）。`expo-gaode-map` 和 `expo-gaode-map-navigation` 由于 SDK 冲突不能同时安装，二选一使用。
 
+`expo-gaode-map-search` 的独立集成只维护到 `2.2.33`。从 `2.0.13` 开始，搜索能力随 `expo-gaode-map` / `expo-gaode-map-navigation` 一起维护；在导航包中请直接从 `expo-gaode-map-navigation` 导入搜索 API。
+
+高德官方 Android SDK 在 `10.0.700` 之后将远程依赖由“地图 + 定位”调整为“地图 + 定位 + 搜索”，依赖地址从 `com.amap.api:3dmap:latest.integration` 调整为 `com.amap.api:3dmap-location-search:latest.integration`。继续单独维护 search 模块会带来重复合包和依赖冲突成本，因此搜索能力改为随 core / navigation 一起维护。
+
 > ⚠️ **版本兼容性说明**：
 > - 如果你的项目使用 **Expo SDK 54 及以上**，请安装 默认的 版本。
 > - 如果你的项目使用 **Expo SDK 53 及以下**（如 50, 51, 52, 53），请使用 **V1** 版本（Tag: `v1`）。
@@ -75,8 +80,8 @@ npx expo run:ios
 - `enableBackgroundAudio` 仅 iOS 生效（默认随 `enableBackgroundLocation` 自动开启），用于注入 `UIBackgroundModes: audio`，保障后台导航语音持续播报。
 - `enableIOSLiveActivity` 仅 iOS 生效，用于注入 `NSSupportsLiveActivities`。
 - `enableIOSLiveActivityFrequentUpdates` 仅 iOS 生效，用于注入 `NSSupportsLiveActivitiesFrequentUpdates`。
-- 运行时还需要在 `NaviView` 里显式传 `androidBackgroundNavigationNotificationEnabled={true}` 才会在应用退到后台后显示导航常驻通知。
-- iOS 运行时还需要在 `NaviView` 里显式传 `iosLiveActivityEnabled={true}` 才会持续更新 Live Activity。
+- 运行时还需要在 `ExpoGaodeMapNaviView` 里显式传 `androidBackgroundNavigationNotificationEnabled={true}` 才会在应用退到后台后显示导航常驻通知。
+- iOS 运行时还需要在 `ExpoGaodeMapNaviView` 里显式传 `iosLiveActivityEnabled={true}` 才会持续更新 Live Activity。
 
 ## 示例工程
 
@@ -84,7 +89,7 @@ npx expo run:ios
 
 推荐场景：
 
-- 调试 `NaviView` 与示例工程里的自定义 HUD / 车道 HUD / 路况光柱
+- 调试 `ExpoGaodeMapNaviView` 与示例工程里的自定义 HUD / 车道 HUD / 路况光柱
 - 对比官方黑盒页、官方嵌入式页、自绘嵌入式页
 - 验证独立算路、多路线选择、近似跟线导航
 
@@ -165,15 +170,16 @@ export default function BasicMapScreen() {
 
 ### 2. 嵌入导航视图
 
-使用 `NaviView` 组件直接嵌入导航界面：
+使用 `ExpoGaodeMapNaviView` 组件直接嵌入导航界面：
 
 ```tsx
 import React, { useEffect, useRef } from 'react';
 import { View } from 'react-native';
-import { NaviView, type NaviViewRef } from 'expo-gaode-map-navigation';
+import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';
+import type { ExpoGaodeMapNaviViewRef } from 'expo-gaode-map-navigation';
 
 export default function NavigationScreen() {
-  const naviRef = useRef<NaviViewRef>(null);
+  const naviRef = useRef<ExpoGaodeMapNaviViewRef>(null);
 
   useEffect(() => {
     // 延迟 1 秒后开始导航
@@ -191,7 +197,7 @@ export default function NavigationScreen() {
 
   return (
     <View style={{ flex: 1 }}>
-      <NaviView
+      <ExpoGaodeMapNaviView
         ref={naviRef}
         style={{ flex: 1 }}
         showCamera={true} // 显示摄像头
@@ -206,17 +212,17 @@ export default function NavigationScreen() {
 
 ### 3. 自定义嵌入式导航 UI
 
-如果你要做“嵌入在自己页面里的导航页”，库本身提供的是底层 `NaviView`、导航事件和原生参数；完整的自定义 HUD / 车道 HUD / 路况光柱参考实现，已经迁移到仓库内的 [`example-navigation`](/Volumes/xinxin/expo-gaode-map/example-navigation/README.md)。
+如果你要做“嵌入在自己页面里的导航页”，库本身提供的是底层 `ExpoGaodeMapNaviView`、导航事件和原生参数；完整的自定义 HUD / 车道 HUD / 路况光柱参考实现，已经迁移到仓库内的 [`example-navigation`](/Volumes/xinxin/expo-gaode-map/example-navigation/README.md)。
 
 建议做法：
 
-- 用 `NaviView` 负责底层导航地图、语音、车道事件、路况事件、路口大图事件
+- 用 `ExpoGaodeMapNaviView` 负责底层导航地图、语音、车道事件、路况事件、路口大图事件
 - 用 `onNaviInfoUpdate`、`onLaneInfoUpdate`、`onTrafficStatusesUpdate`、`onNaviVisualStateChange` 在业务侧自绘 HUD
 - 直接参考 `example-navigation/lib/navigation-ui/EmbeddedNaviView.tsx` 及配套 UI 文件，按你的产品需求裁剪
 
 注意：
 
-- Android 官方嵌入式 `NaviView` 在部分 React Native / Expo 宿主中，顶部信息区、车道条、路口大图联动效果可能与高德官方 Demo 不完全一致
+- Android 官方嵌入式 `ExpoGaodeMapNaviView` 在部分 React Native / Expo 宿主中，顶部信息区、车道条、路口大图联动效果可能与高德官方 Demo 不完全一致
 - 如果你要验证官方嵌入式 UI 本身，请直接跑 `example-navigation` 里的 `official-embedded` 示例页
 - 如果你要交付稳定的嵌入式导航页，建议以示例工程里的“自定义 UI 导航界面”作为起点
 
@@ -489,6 +495,13 @@ const result = await calculateTransitRoute({
 - 可共享的范围仅限纯 TS 的 route / AOI 数据适配工具、文档和测试思路
 - 原生地图桥接、overlay 宿主逻辑、MapView facade 不会和核心包合并
 
+### 导入入口
+
+- 运行时能力优先使用命名导出，例如 `calculateRoute`、`ExpoGaodeMapNaviView`、`openOfficialNaviPage`
+- 类型请用 `import type`，例如 `RouteOptions`、`FollowWebPlannedRouteResult`
+- 默认导出保留给需要整包挂载的场景，内容与常用路径规划和导航函数一致
+- `NaviView` / `NaviViewRef` 仍作为兼容别名保留，新代码建议使用 `ExpoGaodeMapNaviView` / `ExpoGaodeMapNaviViewRef`
+
 ## API 参考
 
 ### DriveStrategy (驾车策略)
@@ -522,7 +535,7 @@ const result = await calculateTransitRoute({
 - 基于 `onTrafficStatusesUpdate` 的自绘路况光柱
 - “全览 / 锁车”与路况开关等浮层控制按钮
 
-### NaviView Props
+### ExpoGaodeMapNaviView Props
 
 | 属性 | 类型 | 说明 |
 |---|---|---|
@@ -564,7 +577,7 @@ const result = await calculateTransitRoute({
 | `onNaviInfoUpdate` | function | 导航信息更新（剩余距离、时间等） |
 | `onLaneInfoUpdate` | function | Android / iOS 车道信息更新，用于自绘车道 HUD |
 
-### NaviView UI 能力清单
+### ExpoGaodeMapNaviView UI 能力清单
 
 已开放且两端都有实现：
 
@@ -636,14 +649,14 @@ const result = await calculateTransitRoute({
 2.  **Web API**：如果需要更灵活的 HTTP 算路（如公交跨城规划、Web端展示），推荐配合 `expo-gaode-map-web-api` 使用。
 3.  **权限**：使用导航功能前，请确保应用已获取定位权限（`ACCESS_FINE_LOCATION`）。
 4.  **Android 状态栏兼容性**：`naviStatusBarEnabled` 依赖高德 Android 导航 SDK 某些版本才提供的 `AMapNaviViewOptions.setNaviStatusBarEnabled(...)`。当前封装已做兼容处理：若宿主工程解析到的 SDK 不包含该方法，则不会再编译失败，而是在运行时跳过该设置并输出 warning。此时该 prop 在 Android 上等价于 no-op。
-5.  **嵌入式 UI 边界**：库导出的是底层 `NaviView` 能力；完整自定义导航界面请参考 `example-navigation` 里的示例实现，它也不是高德官方黑盒导航页的 UI 替代品。
+5.  **嵌入式 UI 边界**：库导出的是底层 `ExpoGaodeMapNaviView` 能力；完整自定义导航界面请参考 `example-navigation` 里的示例实现，它也不是高德官方黑盒导航页的 UI 替代品。
 
 
 ## 📚 文档与资源
 
 - [在线文档](https://tomwq.github.io/expo-gaode-map/api/navigation.html)
 - [GitHub 仓库](https://github.com/TomWq/expo-gaode-map/packages/navigation)
-- [示例项目(导航)](https://github.com/TomWq/expo-gaode-map-navigation-example)
+- [导航示例工程](../../example-navigation)
 - [高德地图开放平台](https://lbs.amap.com/)
 - [Expo Modules API](https://docs.expo.dev/modules/overview/)
 

package/android/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'com.android.library'
 
 group = 'expo.modules.gaodemap.navigation'
-version = '2.0.0'
+version = '2.0.13'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -34,7 +34,7 @@ android {
   namespace "expo.modules.gaodemap.navigation"
   defaultConfig {
     versionCode 1
-    versionName "2.0.0"
+    versionName "2.0.13"
   }
   lintOptions {
     abortOnError false
@@ -60,10 +60,14 @@ dependencies {
             implementation files(sdkFile)
         } else {
             println "ExpoGaodeMapNavigation: Custom SDK path configured but file not found, falling back to Maven dependency."
-            implementation 'com.amap.api:navi-3dmap:latest.integration'
+            implementation 'com.amap.api:navi-3dmap-location-search:10.1.600_3dmap10.1.600_loc6.5.1_sea9.7.4'
+
         }
     } else {
-        implementation 'com.amap.api:navi-3dmap:latest.integration'
+        // 10.1.600 is the last Android 3D map SDK line that supports offline
+        // map downloads without the separate 11.x offline-download permission.
+        implementation 'com.amap.api:navi-3dmap-location-search:10.1.600_3dmap10.1.600_loc6.5.1_sea9.7.4'
+
     }
 
     // Live Update APIs on NotificationCompat.Builder

package/android/src/main/AndroidManifest.xml

@@ -21,4 +21,12 @@
     <!-- 蓝牙权限 - 用于室内定位 (可选) -->
     <uses-permission android:name="android.permission.BLUETOOTH" />
     <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
+
+    <application>
+        <!-- 高德 3D 地图 SDK 官方离线地图 UI 组件 -->
+        <activity
+            android:name="com.amap.api.maps.offlinemap.OfflineMapActivity"
+            android:screenOrientation="portrait"
+            android:exported="false" />
+    </application>
 </manifest>

package/android/src/main/java/expo/modules/gaodemap/map/ExpoGaodeMapOfflineModule.kt

@@ -1,14 +1,19 @@
 package expo.modules.gaodemap.map
 
+import android.app.Activity
+import android.content.Context
+import android.content.Intent
 import android.os.Bundle
 import android.os.StatFs
 import android.os.Environment
 import android.util.Log
+import com.amap.api.maps.offlinemap.OfflineMapActivity
 import com.amap.api.maps.offlinemap.OfflineMapCity
 import com.amap.api.maps.offlinemap.OfflineMapManager
 import com.amap.api.maps.offlinemap.OfflineMapProvince
 import com.amap.api.maps.offlinemap.OfflineMapStatus
 import expo.modules.gaodemap.map.modules.SDKInitializer
+import expo.modules.kotlin.exception.CodedException
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 
@@ -92,12 +97,18 @@ class ExpoGaodeMapOfflineModule : Module() {
       offlineMapManager = null
       downloadingCities.clear()
     }
+
+    AsyncFunction("openOfflineMapUI") {
+      openOfflineMapUI()
+    }
     
     // ==================== 地图列表管理 ====================
     
     AsyncFunction("getAvailableCities") {
-      val cities = getOfflineMapManager()?.offlineMapCityList ?: emptyList()
-      cities.map { city -> convertCityToMap(city) }
+      val manager = getOfflineMapManager()
+      val cities = manager?.offlineMapCityList ?: emptyList()
+      val downloadedCityKeys = getDownloadedCityKeys(manager)
+      cities.map { city -> convertCityToMap(city, downloadedCityKeys) }
     }
     
     AsyncFunction("getAvailableProvinces") {
@@ -106,15 +117,19 @@ class ExpoGaodeMapOfflineModule : Module() {
     }
     
     AsyncFunction("getCitiesByProvince") { provinceCode: String ->
-      val province = getOfflineMapManager()?.offlineMapProvinceList?.find {
-        it.provinceCode == provinceCode 
+      val manager = getOfflineMapManager()
+      val province = manager?.offlineMapProvinceList?.find {
+        it.provinceCode == provinceCode
       }
-      province?.cityList?.map { city -> convertCityToMap(city) } ?: emptyList()
+      val downloadedCityKeys = getDownloadedCityKeys(manager)
+      province?.cityList?.map { city -> convertCityToMap(city, downloadedCityKeys) } ?: emptyList()
     }
     
     AsyncFunction("getDownloadedMaps") {
-      val cities = getOfflineMapManager()?.downloadOfflineMapCityList ?: emptyList()
-      cities.map { city -> convertCityToMap(city) }
+      val manager = getOfflineMapManager()
+      val cities = manager?.downloadOfflineMapCityList ?: emptyList()
+      val downloadedCityKeys = getDownloadedCityKeys(manager)
+      cities.map { city -> convertCityToMap(city, downloadedCityKeys) }
     }
     
     // ==================== 下载管理 ====================
@@ -208,14 +223,17 @@ class ExpoGaodeMapOfflineModule : Module() {
     // ==================== 状态查询 ====================
     
     AsyncFunction("isMapDownloaded") { cityCode: String ->
-      val city = getOfflineMapManager()?.getItemByCityCode(cityCode)
-      city?.state == OfflineMapStatus.SUCCESS || 
-      city?.state == OfflineMapStatus.CHECKUPDATES
+      val manager = getOfflineMapManager()
+      val city = manager?.getItemByCityCode(cityCode)
+      city?.state == OfflineMapStatus.SUCCESS ||
+        city?.let { isDownloadedCity(it, getDownloadedCityKeys(manager)) } == true
     }
     
     AsyncFunction("getMapStatus") { cityCode: String ->
-      val city = getOfflineMapManager()?.getItemByCityCode(cityCode)
-      city?.let { convertCityToMap(it) } ?: Bundle()
+      val manager = getOfflineMapManager()
+      val city = manager?.getItemByCityCode(cityCode)
+      val downloadedCityKeys = getDownloadedCityKeys(manager)
+      city?.let { convertCityToMap(it, downloadedCityKeys) } ?: Bundle()
     }
     
     AsyncFunction("getTotalProgress") {
@@ -463,13 +481,37 @@ class ExpoGaodeMapOfflineModule : Module() {
   /**
    * 转换城市对象为 Map
    */
-  private fun convertCityToMap(city: OfflineMapCity): Bundle {
+  private fun getDownloadedCityKeys(manager: OfflineMapManager?): Set<String> {
+    return manager?.downloadOfflineMapCityList
+      ?.flatMap { getCityIdentityKeys(it) }
+      ?.toSet()
+      ?: emptySet()
+  }
+
+  private fun getCityIdentityKeys(city: OfflineMapCity): List<String> {
+    return listOfNotNull(
+      city.code?.trim()?.takeIf { it.isNotEmpty() }?.let { "code:$it" },
+      city.adcode?.trim()?.takeIf { it.isNotEmpty() }?.let { "adcode:$it" },
+      city.city?.trim()?.takeIf { it.isNotEmpty() }?.let { "name:$it" }
+    )
+  }
+
+  private fun isDownloadedCity(city: OfflineMapCity, downloadedCityKeys: Set<String>): Boolean {
+    return getCityIdentityKeys(city).any { downloadedCityKeys.contains(it) }
+  }
+
+  private fun convertCityToMap(
+    city: OfflineMapCity,
+    downloadedCityKeys: Set<String> = emptySet()
+  ): Bundle {
     val isPaused = synchronized(lock) { pausedCities.contains(city.code) }
     val isDownloading = synchronized(lock) { downloadingCities.contains(city.code) }
+    val isDownloaded = isDownloadedCity(city, downloadedCityKeys)
     
     val status = when {
       isPaused -> "paused"
       isDownloading -> "downloading"
+      isDownloaded -> "downloaded"
       else -> getStatusString(city.state)
     }
     
@@ -501,8 +543,9 @@ class ExpoGaodeMapOfflineModule : Module() {
   }
   
   /**
-   * 获取状态字符串
-   * 注意：只有 SUCCESS 状态才表示真正下载完成
+   * 获取状态字符串。
+   * CHECKUPDATES / NEW_VERSION 在 10.1.600 冷启动时可能出现在普通城市列表,
+   * 不能单独作为已下载依据；已下载状态以 downloadOfflineMapCityList 为准。
    */
   private fun getStatusString(state: Int): String {
     return when (state) {
@@ -558,4 +601,29 @@ class ExpoGaodeMapOfflineModule : Module() {
       null
     }
   }
+
+  private fun getActivityLaunchContext(): Context {
+    return appContext.currentActivity
+      ?: appContext.reactContext
+      ?: throw CodedException("NO_CONTEXT", "React context not available", null)
+  }
+
+  private fun openOfflineMapUI() {
+    val context = getActivityLaunchContext()
+    SDKInitializer.restorePersistedState(context.applicationContext)
+
+    if (!SDKInitializer.isPrivacyReady()) {
+      throw CodedException(
+        "PRIVACY_NOT_AGREED",
+        "隐私协议未完成确认，请先调用 setPrivacyConfig",
+        null
+      )
+    }
+
+    val intent = Intent(context, OfflineMapActivity::class.java)
+    if (context !is Activity) {
+      intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+    }
+    context.startActivity(intent)
+  }
 }

package/android/src/main/java/expo/modules/gaodemap/map/ExpoGaodeMapView.kt

@@ -150,6 +150,7 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
     // 缓存初始相机位置，等待地图加载完成后设置
     private var pendingCameraPosition: Map<String, Any?>? = null
     private var isMapLoaded = false
+    private var hasAppliedInitialCameraPosition = false
 
     init {
         try {
@@ -192,7 +193,7 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
 
                 val positionToApply = initialCameraPosition ?: pendingCameraPosition
                 positionToApply?.let { position ->
-                    applyInitialCameraPosition(position)
+                    applyInitialCameraPositionIfNeeded(position)
                     pendingCameraPosition = null
                 }
 
@@ -351,10 +352,14 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
     fun setInitialCameraPosition(position: Map<String, Any?>) {
         initialCameraPosition = position
 
+        if (hasAppliedInitialCameraPosition) {
+            return
+        }
+
         // 如果地图已加载,立即应用;否则缓存等待地图加载完成
         if (isMapLoaded) {
             mainHandler.post {
-                applyInitialCameraPosition(position)
+                applyInitialCameraPositionIfNeeded(position)
             }
         } else {
             pendingCameraPosition = position
@@ -365,8 +370,12 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
      * 实际应用相机位置
      * @param position 相机位置配置
      */
-    private fun applyInitialCameraPosition(position: Map<String, Any?>) {
+    private fun applyInitialCameraPositionIfNeeded(position: Map<String, Any?>) {
+        if (hasAppliedInitialCameraPosition) {
+            return
+        }
         cameraManager.setInitialCameraPosition(position)
+        hasAppliedInitialCameraPosition = true
     }
 
     // ==================== UI 控件和手势 ====================
@@ -643,6 +652,7 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
 
             // 销毁地图实例
             mapView.onDestroy()
+            hasAppliedInitialCameraPosition = false
         } catch (e: Exception) {
             // 静默处理异常,确保销毁流程不会中断
             android.util.Log.e("ExpoGaodeMapView", "Error destroying map", e)

package/android/src/main/java/expo/modules/gaodemap/map/managers/UIManager.kt

@@ -87,36 +87,46 @@ class UIManager(private val aMap: AMap, private val context: Context) : Location
   // ==================== 图层显示 ====================
   
   private var currentLocationStyle: MyLocationStyle? = null
+  private var currentFollowUserLocation: Boolean = false
+  private var explicitLocationType: Int? = null
+
+  private fun parseLocationType(locationType: String): Int? {
+    return when (locationType) {
+      "SHOW" -> MyLocationStyle.LOCATION_TYPE_SHOW
+      "LOCATE" -> MyLocationStyle.LOCATION_TYPE_LOCATE
+      "FOLLOW" -> MyLocationStyle.LOCATION_TYPE_FOLLOW
+      "MAP_ROTATE" -> MyLocationStyle.LOCATION_TYPE_MAP_ROTATE
+      "LOCATION_ROTATE" -> MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE
+      "LOCATION_ROTATE_NO_CENTER" -> MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE_NO_CENTER
+      "FOLLOW_NO_CENTER" -> MyLocationStyle.LOCATION_TYPE_FOLLOW_NO_CENTER
+      "MAP_ROTATE_NO_CENTER" -> MyLocationStyle.LOCATION_TYPE_MAP_ROTATE_NO_CENTER
+      else -> null
+    }
+  }
+
+  private fun resolveLocationType(followUserLocation: Boolean): Int {
+    explicitLocationType?.let { return it }
+    return if (followUserLocation) {
+      MyLocationStyle.LOCATION_TYPE_FOLLOW
+    } else {
+      MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE_NO_CENTER
+    }
+  }
   
   /**
    * 设置是否显示用户位置
    */
   fun setShowsUserLocation(show: Boolean, followUserLocation: Boolean = false) {
+    currentFollowUserLocation = followUserLocation
     if (show) {
-      // 创建默认的定位样式
       if (currentLocationStyle == null) {
-        currentLocationStyle = MyLocationStyle().apply {
-          // 根据是否跟随设置定位类型
-          val locationType = if (followUserLocation) {
-            MyLocationStyle.LOCATION_TYPE_FOLLOW  // 连续定位并跟随
-          } else {
-            MyLocationStyle.LOCATION_TYPE_SHOW  // 只显示定位点，不跟随
-          }
-          myLocationType(locationType)
-          interval(2000)  // 2秒定位一次
-          showMyLocation(true)
-        }
-      } else {
-        // 更新定位类型
-        val locationType = if (followUserLocation) {
-          MyLocationStyle.LOCATION_TYPE_FOLLOW
-        } else {
-          MyLocationStyle.LOCATION_TYPE_SHOW
-        }
-        currentLocationStyle?.apply {
-          myLocationType(locationType)
-          interval(2000)
-        }
+        currentLocationStyle = MyLocationStyle()
+      }
+
+      currentLocationStyle?.apply {
+        myLocationType(resolveLocationType(followUserLocation))
+        interval(2000)  // 2秒定位一次
+        showMyLocation(true)
       }
       
       // 监听定位变化（用于通知 React Native）
@@ -171,9 +181,10 @@ class UIManager(private val aMap: AMap, private val context: Context) : Location
    */
   @SuppressLint("DiscouragedApi")
   fun setUserLocationRepresentation(config: Map<String, Any>) {
+    explicitLocationType = (config["locationType"] as? String)?.let(::parseLocationType)
+
     if (currentLocationStyle == null) {
       currentLocationStyle = MyLocationStyle().apply {
-        myLocationType(MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE)
         interval(2000)
         showMyLocation(true)
       }
@@ -182,21 +193,7 @@ class UIManager(private val aMap: AMap, private val context: Context) : Location
     val style = currentLocationStyle!!
     
     // 定位蓝点展现模式 (locationType) - Android 支持8种模式
-    val locationType = config["locationType"] as? String
-    if (locationType != null) {
-      val locationTypeValue = when (locationType) {
-        "SHOW" -> MyLocationStyle.LOCATION_TYPE_SHOW
-        "LOCATE" -> MyLocationStyle.LOCATION_TYPE_LOCATE
-        "FOLLOW" -> MyLocationStyle.LOCATION_TYPE_FOLLOW
-        "MAP_ROTATE" -> MyLocationStyle.LOCATION_TYPE_MAP_ROTATE
-        "LOCATION_ROTATE" -> MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE
-        "LOCATION_ROTATE_NO_CENTER" -> MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE_NO_CENTER
-        "FOLLOW_NO_CENTER" -> MyLocationStyle.LOCATION_TYPE_FOLLOW_NO_CENTER
-        "MAP_ROTATE_NO_CENTER" -> MyLocationStyle.LOCATION_TYPE_MAP_ROTATE_NO_CENTER
-        else -> MyLocationStyle.LOCATION_TYPE_LOCATION_ROTATE // 默认值
-      }
-      style.myLocationType(locationTypeValue)
-    }
+    style.myLocationType(resolveLocationType(currentFollowUserLocation))
     
     // 是否显示定位蓝点 (showMyLocation) - Android 5.1.0+ 支持
     // 注意：这个属性在 iOS 中没有对应项，是 Android 特有的

package/android/src/main/java/expo/modules/gaodemap/map/overlays/ClusterView.kt

@@ -141,8 +141,11 @@ class ClusterView(context: Context, appContext: AppContext) : ExpoView(context,
    * 设置最小聚合数量
    */
   fun setMinClusterSize(size: Int) {
-    Log.d("ClusterView", "setMinClusterSize: $size")
-    minClusterSize = size
+    val nextSize = size.coerceAtLeast(1)
+    if (minClusterSize != nextSize) {
+      minClusterSize = nextSize
+      styleChanged = true
+    }
     updateClusters()
   }