expo-gaode-map 2.0.0-alpha.5 → 2.0.0-alpha.7

package/RELEASE_CHECKLIST.md

@@ -0,0 +1,146 @@
+# 🚀 发布检查清单
+
+快速参考 - 发布新版本时需要执行的命令
+
+## 📋 发布前检查
+
+```bash
+# 1. 确保在主分支且代码最新
+git checkout main
+git pull origin main
+
+# 2. 确保没有未提交的更改
+git status
+```
+
+## 🔨 构建和测试
+
+```bash
+# 1. 清理旧的构建产物
+npm run clean
+
+# 2. 安装依赖(如果需要)
+npm install
+
+# 3. 构建项目(包含主模块和 Config Plugin)
+npm run build
+
+# 4. 运行测试
+npm test
+
+# 5. 运行 lint 检查
+npm run lint
+```
+
+## 📝 更新版本信息
+
+```bash
+# 选择一个版本更新命令:
+
+# Patch 版本 (1.0.0 -> 1.0.1) - 修复 bug
+npm version patch
+
+# Minor 版本 (1.0.0 -> 1.1.0) - 新增功能
+npm version minor
+
+# Major 版本 (1.0.0 -> 2.0.0) - 破坏性更新
+npm version major
+
+# 或手动编辑 package.json 中的 version 字段
+```
+
+## 📦 发布到 npm
+
+```bash
+# 发布稳定版本(推荐)
+npm run publish:latest
+
+# 或发布预览版本(alpha/beta)
+npm run publish:next
+```
+
+## 🏷️ 创建 Git 标签
+
+```bash
+# 自动创建(如果使用 npm version 命令会自动创建标签)
+# 或手动创建:
+
+git tag -a v2.0.0 -m "Release v2.0.0"
+git push origin v2.0.0
+git push origin main
+```
+
+## 📄 完整命令序列(复制粘贴)
+
+```bash
+# === 稳定版发布 ===
+npm run clean && \
+npm run build && \
+npm test && \
+npm run lint && \
+npm version patch && \
+npm run publish:latest && \
+git push origin main && \
+git push --tags
+
+# === 预览版发布 ===
+npm run clean && \
+npm run build && \
+npm test && \
+npm run lint && \
+npm version prerelease --preid=alpha && \
+npm run publish:next && \
+git push origin main && \
+git push --tags
+```
+
+## ✅ 发布后验证
+
+```bash
+# 1. 检查 npm 上的版本
+npm view expo-gaode-map version
+
+# 2. 在测试项目中安装新版本
+cd /path/to/test-project
+npm install expo-gaode-map@latest
+
+# 3. 验证 Config Plugin 是否工作
+npx expo prebuild
+```
+
+## 🔙 回滚(如有问题)
+
+```bash
+# 废弃有问题的版本
+npm deprecate expo-gaode-map@版本号 "此版本存在问题,请使用 x.x.x 版本"
+```
+
+## 📊 检查清单
+
+- [ ] 代码已提交且推送到 main 分支
+- [ ] 运行 `npm run clean`
+- [ ] 运行 `npm run build` 成功
+- [ ] 运行 `npm test` 通过
+- [ ] 运行 `npm run lint` 无错误
+- [ ] 确认 `build/` 目录存在
+- [ ] 确认 `plugin/build/` 目录存在
+- [ ] 更新了 CHANGELOG.md
+- [ ] 版本号已更新
+- [ ] 发布到 npm 成功
+- [ ] Git 标签已创建并推送
+- [ ] 在 GitHub 创建了 Release
+- [ ] 测试项目中验证新版本可用
+
+## 💡 常用版本号规则
+
+| 类型 | 命令 | 示例 | 说明 |
+|------|------|------|------|
+| Patch | `npm version patch` | 1.0.0 → 1.0.1 | Bug 修复 |
+| Minor | `npm version minor` | 1.0.0 → 1.1.0 | 新功能(向下兼容) |
+| Major | `npm version major` | 1.0.0 → 2.0.0 | 破坏性更新 |
+| Prerelease | `npm version prerelease --preid=alpha` | 1.0.0 → 1.0.1-alpha.0 | 预发布版本 |
+
+## 🔗 相关文档
+
+- 详细发布流程: [PUBLISHING.md](./PUBLISHING.md)
+- 项目部署文档: [DEPLOY_DOCS.md](./DEPLOY_DOCS.md)

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

@@ -6,8 +6,6 @@ import android.graphics.Bitmap
 import android.graphics.BitmapFactory
 import android.graphics.Canvas
 import android.graphics.Color
-import android.graphics.Paint
-import android.graphics.Path
 import android.os.Handler
 import android.os.Looper
 import android.view.View
@@ -54,7 +52,8 @@ class MarkerView(context: Context, appContext: AppContext) : ExpoView(context, a
   override fun generateLayoutParams(lp: android.view.ViewGroup.LayoutParams?): LayoutParams {
     return when (lp) {
       is LayoutParams -> lp
-      is MarginLayoutParams -> android.widget.LinearLayout.LayoutParams(lp)
+      is android.widget.FrameLayout.LayoutParams -> LayoutParams(lp.width, lp.height)
+      is MarginLayoutParams -> LayoutParams(lp.width, lp.height)
       else -> LayoutParams(
         lp?.width ?: LayoutParams.WRAP_CONTENT,
         lp?.height ?: LayoutParams.WRAP_CONTENT
@@ -505,9 +504,9 @@ class MarkerView(context: Context, appContext: AppContext) : ExpoView(context, a
     
     fun handleMarkerClick(marker: Marker): Boolean {
       markerViewMap[marker]?.let { view ->
-        view.onMarkerPress?.invoke(mapOf(
-          "latitude" to marker.position.latitude,
-          "longitude" to marker.position.longitude
+        view.onMarkerPress.invoke(mapOf(
+            "latitude" to marker.position.latitude,
+            "longitude" to marker.position.longitude
         ))
         // 只有在没有自定义内容（children）且有 title 或 snippet 时才显示信息窗口
         // 如果有自定义内容，说明用户已经自定义了显示内容，不需要默认信息窗口
@@ -576,39 +575,7 @@ class MarkerView(context: Context, appContext: AppContext) : ExpoView(context, a
     }
   }
   
-  /**
-   * 创建默认 marker 图标 (红色大头针)
-   */
-  private fun createDefaultMarkerBitmap(): Bitmap {
-    val width = 48
-    val height = 72
-    val bitmap = createBitmap(width, height)
-    val canvas = Canvas(bitmap)
-    
-    val paint = Paint(Paint.ANTI_ALIAS_FLAG)
-    paint.color = "#FF5252".toColorInt()
-    paint.style = Paint.Style.FILL
-    
-    // 绘制圆形顶部
-    canvas.drawCircle(width / 2f, width / 2f, width / 2f - 2, paint)
-    
-    // 绘制尖端
-    val path = Path()
-    path.moveTo(width / 2f, height.toFloat())
-    path.lineTo(width / 4f, width / 2f + 10f)
-    path.lineTo(3 * width / 4f, width / 2f + 10f)
-    path.close()
-    canvas.drawPath(path, paint)
-    
-    // 绘制白色边框
-    paint.color = Color.WHITE
-    paint.style = Paint.Style.STROKE
-    paint.strokeWidth = 3f
-    canvas.drawCircle(width / 2f, width / 2f, width / 2f - 4, paint)
-    
-    return bitmap
-  }
-  
+
   /**
    * 将视图转换为 Bitmap
    */
@@ -642,29 +609,7 @@ class MarkerView(context: Context, appContext: AppContext) : ExpoView(context, a
     }
   }
   
-  /**
-   * 创建组合 Bitmap：默认 marker + 自定义内容
-   */
-  private fun createCombinedBitmap(): Bitmap? {
-    val customBitmap = createBitmapFromView() ?: return null
-    val markerBitmap = createDefaultMarkerBitmap()
-    
-    val totalWidth = maxOf(markerBitmap.width, customBitmap.width)
-    val totalHeight = markerBitmap.height + customBitmap.height + 10
-    
-    val combinedBitmap = Bitmap.createBitmap(totalWidth, totalHeight, Bitmap.Config.ARGB_8888)
-    val canvas = Canvas(combinedBitmap)
-    
-    val customX = (totalWidth - customBitmap.width) / 2f
-    canvas.drawBitmap(customBitmap, customX, 0f, null)
-    
-    val markerX = (totalWidth - markerBitmap.width) / 2f
-    val markerY = customBitmap.height + 10f
-    canvas.drawBitmap(markerBitmap, markerX, markerY, null)
-    
-    return combinedBitmap
-  }
-  
+
   /**
    * 更新 marker 图标
    */

package/app.plugin.js

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

package/build/ExpoGaodeMapModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ExpoGaodeMapModule.d.ts","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"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"}

package/build/ExpoGaodeMapModule.js

@@ -3,11 +3,21 @@
  * 提供 SDK 初始化、定位、权限管理等功能
  */
 import { requireNativeModule } from 'expo';
-// 获取原生模块实例
-const nativeModule = requireNativeModule('ExpoGaodeMap');
+// 获取原生模块实例 - 添加容错处理
+let nativeModule = null;
+try {
+    nativeModule = requireNativeModule('ExpoGaodeMap');
+}
+catch (error) {
+    console.warn('ExpoGaodeMap 原生模块加载失败:', error);
+}
+// 如果模块加载失败，创建一个空的代理对象防止崩溃
+if (!nativeModule) {
+    console.error('ExpoGaodeMap: 原生模块不可用，请检查配置');
+}
 // 扩展原生模块，添加便捷方法
 const ExpoGaodeMapModuleWithHelpers = {
-    ...nativeModule,
+    ...(nativeModule || {}),
     /**
      * 添加定位监听器（便捷方法）
      * 自动订阅 onLocationUpdate 事件，提供容错处理
@@ -17,7 +27,7 @@ const ExpoGaodeMapModuleWithHelpers = {
      */
     addLocationListener(listener) {
         // 使用可选链和空值合并，确保即使模块不可用也不会崩溃
-        return nativeModule.addListener?.('onLocationUpdate', listener) || {
+        return nativeModule?.addListener?.('onLocationUpdate', listener) || {
             remove: () => { },
         };
     },

package/build/ExpoGaodeMapModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgPzD,WAAW;AACX,MAAM,YAAY,GAAG,mBAAmB,CAAqB,cAAc,CAAC,CAAC;AAE7E,gBAAgB;AAChB,MAAM,6BAA6B,GAAG;IACpC,GAAG,YAAY;IAEf;;;;;;OAMG;IACH,mBAAmB,CAAC,QAA0B;QAC5C,4BAA4B;QAC5B,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI;YACjE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACjB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,6BAAmD,CAAC","sourcesContent":["/**\n * 高德地图原生模块\n * 提供 SDK 初始化、定位、权限管理等功能\n */\n\nimport { NativeModule, requireNativeModule } from 'expo';\nimport type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';\nimport type {\n  LatLng,\n  CoordinateType,\n  Coordinates,\n  ReGeocode,\n  LocationMode,\n  LocationAccuracy,\n  LocationListener,\n} from './types';\n\n/**\n * SDK 配置参数\n */\nexport interface SDKConfig {\n  /** Android 平台的高德地图 API Key */\n  androidKey?: string;\n  /** iOS 平台的高德地图 API Key */\n  iosKey?: string;\n}\n\n/**\n * 权限状态\n */\nexport interface PermissionStatus {\n  /** 是否已授权 */\n  granted: boolean;\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n}\n\n/**\n * 高德地图原生模块类声明\n */\ndeclare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  // ==================== SDK 初始化 ====================\n  \n  /**\n   * 初始化高德地图 SDK\n   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key\n   */\n  initSDK(config: SDKConfig): void;\n  \n  /**\n   * 获取高德地图 SDK 版本号\n   * @returns SDK 版本字符串\n   */\n  getVersion(): string;\n  \n  // ==================== 定位控制 ====================\n  \n  /**\n   * 开始连续定位\n   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调\n   */\n  start(): void;\n  \n  /**\n   * 停止定位\n   * 停止接收位置更新\n   */\n  stop(): void;\n  \n  /**\n   * 检查是否正在定位\n   * @returns Promise<boolean> 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n  \n  /**\n   * 获取当前位置（单次定位）\n   * @returns Promise<Coordinates | ReGeocode> 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n  \n  /**\n   * 坐标转换\n   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系\n   * @param coordinate 需要转换的坐标\n   * @param type 原坐标系类型\n   * @returns Promise<LatLng> 转换后的 GCJ-02 坐标\n   */\n  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;\n  \n  // ==================== 定位配置 ====================\n  \n  /**\n   * 设置是否返回逆地理编码信息\n   * @param isReGeocode true: 返回地址信息; false: 只返回坐标\n   */\n  setLocatingWithReGeocode(isReGeocode: boolean): void;\n  \n  /**\n   * 设置定位模式（Android）\n   * @param mode 定位模式：0-低功耗, 1-仅设备, 2-高精度\n   */\n  setLocationMode(mode: LocationMode): void;\n  \n  /**\n   * 设置定位间隔（毫秒）\n   * @param interval 定位间隔时间，单位毫秒，默认 2000ms\n   */\n  setInterval(interval: number): void;\n  \n  /**\n   * 设置是否单次定位（Android）\n   * @param isOnceLocation true: 单次定位; false: 连续定位\n   */\n  setOnceLocation(isOnceLocation: boolean): void;\n  \n  /**\n   * 设置是否使用设备传感器（Android）\n   * @param sensorEnable true: 使用传感器; false: 不使用\n   */\n  setSensorEnable(sensorEnable: boolean): void;\n  \n  /**\n   * 设置是否允许 WiFi 扫描（Android）\n   * @param wifiScan true: 允许; false: 不允许\n   */\n  setWifiScan(wifiScan: boolean): void;\n  \n  /**\n   * 设置是否 GPS 优先（Android）\n   * @param gpsFirst true: GPS 优先; false: 网络优先\n   */\n  setGpsFirst(gpsFirst: boolean): void;\n  \n  /**\n   * 设置是否等待 WiFi 列表刷新（Android）\n   * @param onceLocationLatest true: 等待; false: 不等待\n   */\n  setOnceLocationLatest(onceLocationLatest: boolean): void;\n  \n  /**\n   * 设置逆地理编码语言\n   * @param language 语言代码，如 \"zh-CN\", \"en\"\n   */\n  setGeoLanguage(language: string): void;\n  \n  /**\n   * 设置是否使用缓存策略（Android）\n   * @param locationCacheEnable true: 使用缓存; false: 不使用\n   */\n  setLocationCacheEnable(locationCacheEnable: boolean): void;\n  \n  /**\n   * 设置网络请求超时时间（Android）\n   * @param httpTimeOut 超时时间，单位毫秒\n   */\n  setHttpTimeOut(httpTimeOut: number): void;\n  \n  /**\n   * 设置期望的定位精度（iOS）\n   * @param accuracy 精度级别：0-最佳, 1-10米, 2-100米, 3-1公里, 4-3公里\n   */\n  setDesiredAccuracy(accuracy: LocationAccuracy): void;\n  \n  /**\n   * 设置定位超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 10 秒\n   */\n  setLocationTimeout(timeout: number): void;\n  \n  /**\n   * 设置逆地理编码超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 5 秒\n   */\n  setReGeocodeTimeout(timeout: number): void;\n  \n  /**\n   * 设置距离过滤器（米）（iOS）\n   * 只有移动超过指定距离才会更新位置\n   * @param distance 距离阈值，单位米\n   */\n  setDistanceFilter(distance: number): void;\n  \n  /**\n   * 设置是否自动暂停位置更新（iOS）\n   * @param pauses true: 自动暂停; false: 不暂停\n   */\n  setPausesLocationUpdatesAutomatically(pauses: boolean): void;\n  \n  /**\n   * 设置是否允许后台定位（iOS）\n   * @param allows true: 允许; false: 不允许\n   */\n  setAllowsBackgroundLocationUpdates(allows: boolean): void;\n  \n  /**\n   * 设置定位协议\n   * @param protocol 协议类型\n   */\n  setLocationProtocol(protocol: string): void;\n  \n  // ==================== 方向更新 (iOS) ====================\n  \n  /**\n   * 开始更新设备方向（罗盘朝向）\n   * 通过 onHeadingUpdate 事件接收方向更新\n   * @platform ios\n   */\n  startUpdatingHeading(): void;\n  \n  /**\n   * 停止更新设备方向\n   * @platform ios\n   */\n  stopUpdatingHeading(): void;\n  \n  // ==================== 权限管理 ====================\n  \n  /**\n   * 检查位置权限状态\n   * @returns Promise<PermissionStatus> 权限状态\n   */\n  checkLocationPermission(): Promise<PermissionStatus>;\n  \n  /**\n   * 请求位置权限\n   * @returns Promise<PermissionStatus> 请求后的权限状态\n   */\n  requestLocationPermission(): Promise<PermissionStatus>;\n  \n  // ==================== 便捷方法 ====================\n  \n  /**\n   * 添加定位监听器（便捷方法）\n   * 封装了 addListener，提供更简洁的 API\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n}\n\n// 获取原生模块实例\nconst nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');\n\n// 扩展原生模块，添加便捷方法\nconst ExpoGaodeMapModuleWithHelpers = {\n  ...nativeModule,\n  \n  /**\n   * 添加定位监听器（便捷方法）\n   * 自动订阅 onLocationUpdate 事件，提供容错处理\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   * @throws 如果底层模块不可用，返回一个空操作的订阅对象\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void } {\n    // 使用可选链和空值合并，确保即使模块不可用也不会崩溃\n    return nativeModule.addListener?.('onLocationUpdate', listener) || {\n      remove: () => {},\n    };\n  },\n};\n\nexport default ExpoGaodeMapModuleWithHelpers as ExpoGaodeMapModule;\n"]}
+{"version":3,"file":"ExpoGaodeMapModule.js","sourceRoot":"","sources":["../src/ExpoGaodeMapModule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgPzD,oBAAoB;AACpB,IAAI,YAAY,GAA8B,IAAI,CAAC;AAEnD,IAAI,CAAC;IACH,YAAY,GAAG,mBAAmB,CAAqB,cAAc,CAAC,CAAC;AACzE,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,0BAA0B;AAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC/C,CAAC;AAED,gBAAgB;AAChB,MAAM,6BAA6B,GAAG;IACpC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAEvB;;;;;;OAMG;IACH,mBAAmB,CAAC,QAA0B;QAC5C,4BAA4B;QAC5B,OAAO,YAAY,EAAE,WAAW,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI;YAClE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACjB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,6BAAmD,CAAC","sourcesContent":["/**\n * 高德地图原生模块\n * 提供 SDK 初始化、定位、权限管理等功能\n */\n\nimport { NativeModule, requireNativeModule } from 'expo';\nimport type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';\nimport type {\n  LatLng,\n  CoordinateType,\n  Coordinates,\n  ReGeocode,\n  LocationMode,\n  LocationAccuracy,\n  LocationListener,\n} from './types';\n\n/**\n * SDK 配置参数\n */\nexport interface SDKConfig {\n  /** Android 平台的高德地图 API Key */\n  androidKey?: string;\n  /** iOS 平台的高德地图 API Key */\n  iosKey?: string;\n}\n\n/**\n * 权限状态\n */\nexport interface PermissionStatus {\n  /** 是否已授权 */\n  granted: boolean;\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n}\n\n/**\n * 高德地图原生模块类声明\n */\ndeclare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  // ==================== SDK 初始化 ====================\n  \n  /**\n   * 初始化高德地图 SDK\n   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key\n   */\n  initSDK(config: SDKConfig): void;\n  \n  /**\n   * 获取高德地图 SDK 版本号\n   * @returns SDK 版本字符串\n   */\n  getVersion(): string;\n  \n  // ==================== 定位控制 ====================\n  \n  /**\n   * 开始连续定位\n   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调\n   */\n  start(): void;\n  \n  /**\n   * 停止定位\n   * 停止接收位置更新\n   */\n  stop(): void;\n  \n  /**\n   * 检查是否正在定位\n   * @returns Promise<boolean> 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n  \n  /**\n   * 获取当前位置（单次定位）\n   * @returns Promise<Coordinates | ReGeocode> 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n  \n  /**\n   * 坐标转换\n   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系\n   * @param coordinate 需要转换的坐标\n   * @param type 原坐标系类型\n   * @returns Promise<LatLng> 转换后的 GCJ-02 坐标\n   */\n  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;\n  \n  // ==================== 定位配置 ====================\n  \n  /**\n   * 设置是否返回逆地理编码信息\n   * @param isReGeocode true: 返回地址信息; false: 只返回坐标\n   */\n  setLocatingWithReGeocode(isReGeocode: boolean): void;\n  \n  /**\n   * 设置定位模式（Android）\n   * @param mode 定位模式：0-低功耗, 1-仅设备, 2-高精度\n   */\n  setLocationMode(mode: LocationMode): void;\n  \n  /**\n   * 设置定位间隔（毫秒）\n   * @param interval 定位间隔时间，单位毫秒，默认 2000ms\n   */\n  setInterval(interval: number): void;\n  \n  /**\n   * 设置是否单次定位（Android）\n   * @param isOnceLocation true: 单次定位; false: 连续定位\n   */\n  setOnceLocation(isOnceLocation: boolean): void;\n  \n  /**\n   * 设置是否使用设备传感器（Android）\n   * @param sensorEnable true: 使用传感器; false: 不使用\n   */\n  setSensorEnable(sensorEnable: boolean): void;\n  \n  /**\n   * 设置是否允许 WiFi 扫描（Android）\n   * @param wifiScan true: 允许; false: 不允许\n   */\n  setWifiScan(wifiScan: boolean): void;\n  \n  /**\n   * 设置是否 GPS 优先（Android）\n   * @param gpsFirst true: GPS 优先; false: 网络优先\n   */\n  setGpsFirst(gpsFirst: boolean): void;\n  \n  /**\n   * 设置是否等待 WiFi 列表刷新（Android）\n   * @param onceLocationLatest true: 等待; false: 不等待\n   */\n  setOnceLocationLatest(onceLocationLatest: boolean): void;\n  \n  /**\n   * 设置逆地理编码语言\n   * @param language 语言代码，如 \"zh-CN\", \"en\"\n   */\n  setGeoLanguage(language: string): void;\n  \n  /**\n   * 设置是否使用缓存策略（Android）\n   * @param locationCacheEnable true: 使用缓存; false: 不使用\n   */\n  setLocationCacheEnable(locationCacheEnable: boolean): void;\n  \n  /**\n   * 设置网络请求超时时间（Android）\n   * @param httpTimeOut 超时时间，单位毫秒\n   */\n  setHttpTimeOut(httpTimeOut: number): void;\n  \n  /**\n   * 设置期望的定位精度（iOS）\n   * @param accuracy 精度级别：0-最佳, 1-10米, 2-100米, 3-1公里, 4-3公里\n   */\n  setDesiredAccuracy(accuracy: LocationAccuracy): void;\n  \n  /**\n   * 设置定位超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 10 秒\n   */\n  setLocationTimeout(timeout: number): void;\n  \n  /**\n   * 设置逆地理编码超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 5 秒\n   */\n  setReGeocodeTimeout(timeout: number): void;\n  \n  /**\n   * 设置距离过滤器（米）（iOS）\n   * 只有移动超过指定距离才会更新位置\n   * @param distance 距离阈值，单位米\n   */\n  setDistanceFilter(distance: number): void;\n  \n  /**\n   * 设置是否自动暂停位置更新（iOS）\n   * @param pauses true: 自动暂停; false: 不暂停\n   */\n  setPausesLocationUpdatesAutomatically(pauses: boolean): void;\n  \n  /**\n   * 设置是否允许后台定位（iOS）\n   * @param allows true: 允许; false: 不允许\n   */\n  setAllowsBackgroundLocationUpdates(allows: boolean): void;\n  \n  /**\n   * 设置定位协议\n   * @param protocol 协议类型\n   */\n  setLocationProtocol(protocol: string): void;\n  \n  // ==================== 方向更新 (iOS) ====================\n  \n  /**\n   * 开始更新设备方向（罗盘朝向）\n   * 通过 onHeadingUpdate 事件接收方向更新\n   * @platform ios\n   */\n  startUpdatingHeading(): void;\n  \n  /**\n   * 停止更新设备方向\n   * @platform ios\n   */\n  stopUpdatingHeading(): void;\n  \n  // ==================== 权限管理 ====================\n  \n  /**\n   * 检查位置权限状态\n   * @returns Promise<PermissionStatus> 权限状态\n   */\n  checkLocationPermission(): Promise<PermissionStatus>;\n  \n  /**\n   * 请求位置权限\n   * @returns Promise<PermissionStatus> 请求后的权限状态\n   */\n  requestLocationPermission(): Promise<PermissionStatus>;\n  \n  // ==================== 便捷方法 ====================\n  \n  /**\n   * 添加定位监听器（便捷方法）\n   * 封装了 addListener，提供更简洁的 API\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n}\n\n// 获取原生模块实例 - 添加容错处理\nlet nativeModule: ExpoGaodeMapModule | null = null;\n\ntry {\n  nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');\n} catch (error) {\n  console.warn('ExpoGaodeMap 原生模块加载失败:', error);\n}\n\n// 如果模块加载失败，创建一个空的代理对象防止崩溃\nif (!nativeModule) {\n  console.error('ExpoGaodeMap: 原生模块不可用，请检查配置');\n}\n\n// 扩展原生模块，添加便捷方法\nconst ExpoGaodeMapModuleWithHelpers = {\n  ...(nativeModule || {}),\n  \n  /**\n   * 添加定位监听器（便捷方法）\n   * 自动订阅 onLocationUpdate 事件，提供容错处理\n   * @param listener 定位回调函数\n   * @returns 订阅对象，调用 remove() 取消监听\n   * @throws 如果底层模块不可用，返回一个空操作的订阅对象\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void } {\n    // 使用可选链和空值合并，确保即使模块不可用也不会崩溃\n    return nativeModule?.addListener?.('onLocationUpdate', listener) || {\n      remove: () => {},\n    };\n  },\n};\n\nexport default ExpoGaodeMapModuleWithHelpers as ExpoGaodeMapModule;\n"]}

package/ios/modules/LocationManager.swift

@@ -178,11 +178,12 @@ class LocationManager: NSObject, AMapLocationManagerDelegate {
     private func initLocationManager() {
         locationManager = AMapLocationManager()
         locationManager?.delegate = self
-        // 推荐配置：百米精度，快速定位（2-3秒）
+        // 推荐配置：百米精度，快速定位
         locationManager?.desiredAccuracy = kCLLocationAccuracyHundredMeters
         locationManager?.distanceFilter = 10
-        locationManager?.locationTimeout = 2  // 2秒超时
-        locationManager?.reGeocodeTimeout = 2  // 2秒超时
+        // 增加超时时间，避免首次授权时超时(首次定位建议10秒以上)
+        locationManager?.locationTimeout = 10  // 10秒超时
+        locationManager?.reGeocodeTimeout = 5   // 5秒超时
         locationManager?.locatingWithReGeocode = true
         
         // iOS 9 之前:防止后台被系统挂起(默认关闭,用户可通过 setPausesLocationUpdatesAutomatically 配置)

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "expo-gaode-map",
-  "version": "2.0.0-alpha.5",
+  "version": "2.0.0-alpha.7",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "scripts": {
-    "build": "expo-module build",
-    "clean": "expo-module clean",
+    "build": "expo-module build && npm run build:plugin",
+    "build:plugin": "tsc --project plugin/tsconfig.json",
+    "clean": "expo-module clean && rm -rf plugin/build",
     "lint": "expo-module lint",
     "test": "expo-module test",
-    "prepare": "expo-module prepare",
+    "prepare": "expo-module prepare && npm run build:plugin",
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module",
     "open:ios": "xed example/ios",
@@ -35,10 +36,12 @@
     "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"
+    "react-native": "0.81.5",
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "expo": "*",

package/plugin/README.md

@@ -0,0 +1,52 @@
+# Expo Config Plugin for expo-gaode-map
+
+这是 `expo-gaode-map` 的 Expo Config Plugin 实现。
+
+## 功能
+
+- 自动配置 iOS 和 Android 平台的高德地图 API Key
+- 自动添加定位权限
+- 自动初始化高德地图 SDK
+
+## 开发
+
+### 构建插件
+
+```bash
+npm run build:plugin
+```
+
+### 目录结构
+
+```
+plugin/
+├── src/
+│   └── withGaodeMap.ts    # 插件源代码
+├── build/                  # 编译输出目录
+├── tsconfig.json          # TypeScript 配置
+└── README.md              # 本文件
+```
+
+## 使用方法
+
+请查看主文档: [CONFIG_PLUGIN.md](../docs/CONFIG_PLUGIN.md)
+
+## 技术细节
+
+### 修改的文件
+
+**iOS:**
+- `Info.plist` - 添加 API Key 和权限
+- `AppDelegate.m` - 添加 SDK 初始化代码
+
+**Android:**
+- `AndroidManifest.xml` - 添加 API Key 和权限
+
+### 依赖
+
+- `@expo/config-plugins` - Expo 配置插件核心库
+
+## 参考
+
+- [Expo Config Plugins](https://docs.expo.dev/config-plugins/introduction/)
+- [Creating a Config Plugin](https://docs.expo.dev/config-plugins/plugins-and-mods/)

package/plugin/build/withGaodeMap.d.ts

@@ -0,0 +1,20 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+/**
+ * 高德地图插件配置类型
+ */
+export type GaodeMapPluginProps = {
+    /** iOS 平台 API Key */
+    iosApiKey?: string;
+    /** Android 平台 API Key */
+    androidApiKey?: string;
+    /** 是否启用定位功能 */
+    enableLocation?: boolean;
+    /** iOS 定位权限描述 */
+    locationDescription?: string;
+};
+/**
+ * 导出为可运行一次的插件
+ * 这确保插件只会运行一次，即使在配置中被多次引用
+ */
+declare const _default: ConfigPlugin<GaodeMapPluginProps>;
+export default _default;

package/plugin/build/withGaodeMap.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+/**
+ * iOS: 修改 Info.plist 添加 API Key 和权限
+ */
+const withGaodeMapInfoPlist = (config, props) => {
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        // 添加高德地图 API Key
+        if (props.iosApiKey) {
+            config.modResults.AMapApiKey = props.iosApiKey;
+        }
+        // 添加定位相关权限
+        if (props.enableLocation !== false) {
+            const description = props.locationDescription || '需要访问您的位置信息以提供地图服务';
+            config.modResults.NSLocationWhenInUseUsageDescription = description;
+            config.modResults.NSLocationAlwaysUsageDescription = description;
+            config.modResults.NSLocationAlwaysAndWhenInUseUsageDescription = description;
+        }
+        // 添加后台定位模式（如果需要）
+        if (props.enableLocation !== false) {
+            if (!config.modResults.UIBackgroundModes) {
+                config.modResults.UIBackgroundModes = [];
+            }
+            if (!config.modResults.UIBackgroundModes.includes('location')) {
+                config.modResults.UIBackgroundModes.push('location');
+            }
+        }
+        return config;
+    });
+};
+/**
+ * iOS: 修改 AppDelegate 添加初始化代码
+ */
+const withGaodeMapAppDelegate = (config, props) => {
+    return (0, config_plugins_1.withAppDelegate)(config, (config) => {
+        if (!props.iosApiKey) {
+            return config;
+        }
+        let contents = config.modResults.contents;
+        // 添加 import 语句
+        if (!contents.includes('#import <AMapFoundationKit/AMapFoundationKit.h>')) {
+            // 在 #import "AppDelegate.h" 之后添加
+            contents = contents.replace(/#import "AppDelegate.h"/g, `#import "AppDelegate.h"\n#import <AMapFoundationKit/AMapFoundationKit.h>`);
+        }
+        // 在 didFinishLaunchingWithOptions 方法中添加初始化代码
+        const initCode = `  [AMapServices sharedServices].apiKey = @"${props.iosApiKey}";`;
+        if (!contents.includes(initCode)) {
+            // 在 didFinishLaunchingWithOptions 方法的开始处添加
+            contents = contents.replace(/(- \(BOOL\)application:\(UIApplication \*\)application didFinishLaunchingWithOptions:\(NSDictionary \*\)launchOptions\s*\{)/g, `$1\n${initCode}`);
+        }
+        config.modResults.contents = contents;
+        return config;
+    });
+};
+/**
+ * Android: 修改 AndroidManifest.xml 添加 API Key 和权限
+ */
+const withGaodeMapAndroidManifest = (config, props) => {
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const androidManifest = config.modResults.manifest;
+        // 添加权限
+        if (props.enableLocation !== false) {
+            const permissions = [
+                'android.permission.ACCESS_COARSE_LOCATION',
+                'android.permission.ACCESS_FINE_LOCATION',
+                'android.permission.ACCESS_WIFI_STATE',
+                'android.permission.ACCESS_NETWORK_STATE',
+                'android.permission.CHANGE_WIFI_STATE',
+                'android.permission.INTERNET',
+                'android.permission.WRITE_EXTERNAL_STORAGE',
+                'android.permission.READ_EXTERNAL_STORAGE',
+                'android.permission.ACCESS_LOCATION_EXTRA_COMMANDS',
+            ];
+            if (!androidManifest['uses-permission']) {
+                androidManifest['uses-permission'] = [];
+            }
+            permissions.forEach((permission) => {
+                const hasPermission = androidManifest['uses-permission']?.some((item) => item.$?.['android:name'] === permission);
+                if (!hasPermission) {
+                    androidManifest['uses-permission']?.push({
+                        $: { 'android:name': permission },
+                    });
+                }
+            });
+        }
+        // 添加 API Key 到 application 标签
+        const mainApplication = androidManifest.application?.[0];
+        if (mainApplication && props.androidApiKey) {
+            if (!mainApplication['meta-data']) {
+                mainApplication['meta-data'] = [];
+            }
+            // 检查是否已存在
+            const hasApiKey = mainApplication['meta-data'].some((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
+            if (!hasApiKey) {
+                mainApplication['meta-data'].push({
+                    $: {
+                        'android:name': 'com.amap.api.v2.apikey',
+                        'android:value': props.androidApiKey,
+                    },
+                });
+            }
+            else {
+                // 更新现有的 API Key
+                const apiKeyIndex = mainApplication['meta-data'].findIndex((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
+                if (apiKeyIndex !== -1) {
+                    mainApplication['meta-data'][apiKeyIndex].$ = {
+                        'android:name': 'com.amap.api.v2.apikey',
+                        'android:value': props.androidApiKey,
+                    };
+                }
+            }
+        }
+        return config;
+    });
+};
+/**
+ * Android: 修改 app/build.gradle 添加依赖
+ */
+const withGaodeMapAppBuildGradle = (config, props) => {
+    return (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
+        // 这里可以添加额外的 Gradle 配置，如果需要的话
+        // 例如添加 maven 仓库或其他依赖
+        return config;
+    });
+};
+/**
+ * 主插件函数 - 组合所有修改器
+ */
+const withGaodeMap = (config, props = {}) => {
+    // 验证配置
+    if (!props.iosApiKey && !props.androidApiKey) {
+        config_plugins_1.WarningAggregator.addWarningIOS('expo-gaode-map', '未配置 API Key。请在 app.json 的 plugins 中配置 iosApiKey 和 androidApiKey');
+    }
+    // 应用 iOS 配置
+    config = withGaodeMapInfoPlist(config, props);
+    config = withGaodeMapAppDelegate(config, props);
+    // 应用 Android 配置
+    config = withGaodeMapAndroidManifest(config, props);
+    config = withGaodeMapAppBuildGradle(config, props);
+    return config;
+};
+/**
+ * 导出为可运行一次的插件
+ * 这确保插件只会运行一次，即使在配置中被多次引用
+ */
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withGaodeMap, 'expo-gaode-map', '1.0.0');

package/plugin/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/withgaodemap.ts"],"version":"5.9.3"}

package/src/ExpoGaodeMapModule.ts

@@ -243,12 +243,23 @@ declare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents>
   addLocationListener(listener: LocationListener): { remove: () => void };
 }
 
-// 获取原生模块实例
-const nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');
+// 获取原生模块实例 - 添加容错处理
+let nativeModule: ExpoGaodeMapModule | null = null;
+
+try {
+  nativeModule = requireNativeModule<ExpoGaodeMapModule>('ExpoGaodeMap');
+} catch (error) {
+  console.warn('ExpoGaodeMap 原生模块加载失败:', error);
+}
+
+// 如果模块加载失败，创建一个空的代理对象防止崩溃
+if (!nativeModule) {
+  console.error('ExpoGaodeMap: 原生模块不可用，请检查配置');
+}
 
 // 扩展原生模块，添加便捷方法
 const ExpoGaodeMapModuleWithHelpers = {
-  ...nativeModule,
+  ...(nativeModule || {}),
   
   /**
    * 添加定位监听器（便捷方法）
@@ -259,7 +270,7 @@ const ExpoGaodeMapModuleWithHelpers = {
    */
   addLocationListener(listener: LocationListener): { remove: () => void } {
     // 使用可选链和空值合并，确保即使模块不可用也不会崩溃
-    return nativeModule.addListener?.('onLocationUpdate', listener) || {
+    return nativeModule?.addListener?.('onLocationUpdate', listener) || {
       remove: () => {},
     };
   },