expo-gaode-map 2.0.0 → 2.1.0-beta.0

package/.eslintrc.js

@@ -1,5 +1,2 @@
-module.exports = {
-  root: true,
-  extends: ['universe/native', 'universe/web'],
-  ignorePatterns: ['build'],
-};
+// @generated by expo-module-scripts
+module.exports = require('expo-module-scripts/eslintrc.base.js');

package/README.md

@@ -1,136 +1,35 @@
 # expo-gaode-map
 
-[English](./README.en.md) | 简体中文
+一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。
 
-一个功能完整的高德地图 React Native 组件库，**基于 Expo Modules 开发**，提供地图显示、定位、覆盖物等功能。
+# API documentation
 
-> 💡 本组件使用 [Expo Modules API](https://docs.expo.dev/modules/overview/) 构建，提供了类型安全的原生模块接口和优秀的开发体验。
+- [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/gaode-map/)
+- [Documentation for the main branch](https://docs.expo.dev/versions/unversioned/sdk/gaode-map/)
 
-## 📖 完整文档
+# Installation in managed Expo projects
 
-**👉 [在线文档网站](https://TomWq.github.io/expo-gaode-map/)** - 包含完整的 API 文档、使用指南和示例代码
+For [managed](https://docs.expo.dev/archive/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](#api-documentation). If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.
 
-## ✨ 主要特性
+# Installation in bare React Native projects
 
-- ✅ 完整的地图功能（多种地图类型、手势控制、相机操作）
-- ✅ 精准定位（连续定位、单次定位、坐标转换）
-- ✅ 丰富的覆盖物（Circle、Marker、Polyline、Polygon、HeatMap、Cluster 等）
-- ✅ 完整的 TypeScript 类型定义
-- ✅ 跨平台支持（Android、iOS）
-- ✅ 同时支持 React Native 新旧架构（Paper & Fabric）
+For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
 
-## 📦 安装
+### Add the package to your npm dependencies
 
-### 稳定版本（推荐）
-
-```bash
-npm install expo-gaode-map
-# 或
-yarn add expo-gaode-map
-# 或
-pnpm add expo-gaode-map
 ```
-
-## 🚀 快速开始
-
-### 1. 获取高德地图 API Key
-
-前往 [高德开放平台](https://lbs.amap.com/) 注册并创建应用，获取 API Key。
-
-> ⚠️ **重要提示**: 高德地图 SDK 需要在原生项目中进行配置（API Key、权限、隐私合规等）
-> 
-> 详细配置请查看：[初始化指南](https://TomWq.github.io/expo-gaode-map/guide/initialization.html)
-
-### 2. 基础使用
-
-```tsx
-import { useEffect, useState } from 'react';
-import { MapView, ExpoGaodeMapModule } from 'expo-gaode-map';
-
-export default function App() {
-  const [initialPosition, setInitialPosition] = useState(null);
-
-  useEffect(() => {
-    const initialize = async () => {
-      // 1. 初始化 SDK
-      ExpoGaodeMapModule.initSDK({
-        androidKey: 'your-android-api-key',
-        iosKey: 'your-ios-api-key',
-      });
-      
-      // 2. 检查并请求权限
-      const status = await ExpoGaodeMapModule.checkLocationPermission();
-      if (!status.granted) {
-        await ExpoGaodeMapModule.requestLocationPermission();
-      }
-      
-      // 3. 获取位置并设置地图
-      try {
-        const location = await ExpoGaodeMapModule.getCurrentLocation();
-        setInitialPosition({
-          target: { latitude: location.latitude, longitude: location.longitude },
-          zoom: 15
-        });
-      } catch (error) {
-        // 使用默认位置
-        setInitialPosition({
-          target: { latitude: 39.9, longitude: 116.4 },
-          zoom: 10
-        });
-      }
-    };
-    
-    initialize();
-  }, []);
-
-  if (!initialPosition) return null;
-
-  return (
-    <MapView
-      style={{ flex: 1 }}
-      initialCameraPosition={initialPosition}
-      myLocationEnabled={true}
-    />
-  );
-}
+npm install expo-gaode-map
 ```
 
-## 📚 文档导航
-
-- [快速开始](https://TomWq.github.io/expo-gaode-map/guide/getting-started.html) - 快速上手指南
-- [初始化指南](https://TomWq.github.io/expo-gaode-map/guide/initialization.html) - SDK 初始化和权限配置
-- [API 文档](https://TomWq.github.io/expo-gaode-map/api/) - 完整的 API 参考
-- [使用示例](https://TomWq.github.io/expo-gaode-map/examples/) - 详细的代码示例
-- [架构文档](https://TomWq.github.io/expo-gaode-map/guide/architecture.html) - 项目结构说明
-
-## 🤝 贡献
-
-欢迎提交 Issue 和 Pull Request！
-
-## 📄 许可证
-
-MIT
-
-## 🔗 相关链接
-
-- [在线文档](https://TomWq.github.io/expo-gaode-map/)
-- [GitHub 仓库](https://github.com/TomWq/expo-gaode-map)
-- [高德地图开放平台](https://lbs.amap.com/)
-- [Expo Modules API](https://docs.expo.dev/modules/overview/)
+### Configure for Android
 
-## 🙏 致谢
 
-本项目在开发过程中参考了以下优秀项目：
 
-- **[react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d)** - 一个优秀的 React Native 高德地图组件
 
-感谢这些开源项目的贡献者们！
+### Configure for iOS
 
-## 📮 反馈与支持
+Run `npx pod-install` after installing the npm package.
 
-如果你在使用过程中遇到问题或有任何建议，欢迎：
+# Contributing
 
-- 📝 提交 [GitHub Issue](https://github.com/TomWq/expo-gaode-map/issues)
-- 💬 参与 [Discussions](https://github.com/TomWq/expo-gaode-map/discussions)
-- ⭐ 给项目点个 Star 支持一下
-- 💬 加入 QQ 群：952241387
+Contributions are very welcome! Please refer to guidelines described in the [contributing guide]( https://github.com/expo/expo#contributing).

package/android/build.gradle

@@ -43,6 +43,7 @@ android {
 }
 
 dependencies {
-    // 3D地图SDK（已包含定位功能）
+
     implementation 'com.amap.api:3dmap:10.0.600'
+
 }

package/android/src/main/AndroidManifest.xml

@@ -1,52 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
   
-  <!-- 高德地图必需权限 -->
-  <!-- 用于访问网络 -->
+  <!-- 网络权限 (必需) -->
   <uses-permission android:name="android.permission.INTERNET" />
-  <!-- 用于获取网络状态 -->
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
-  <!-- 用于访问wifi网络信息 -->
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
-  <!-- 用于获取wifi的获取权限 -->
-  <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
   
-  <!-- 定位相关权限 -->
-  <!-- 用于访问GPS定位 -->
+  <!-- 基础定位权限 (必需) -->
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
-  <!-- 用于获取运营商信息，用于支持提供运营商信息相关的接口 -->
-  <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
-  
-  <!-- Android 10及以上需要后台定位权限 -->
-  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
-  
-  <!-- 前台服务权限 (Android 9+) -->
-  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
-  <!-- Android 14+ 需要指定前台服务类型 -->
-  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
-  
-  <!-- 写入扩展存储，用于缓存地图数据 -->
-  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
-  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
-  
-  <!-- 用于读取手机当前的状态 -->
-  <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   
   <application>
-    <!-- 高德地图 API Key（这里只是示例，实际会通过代码设置） -->
-    <!--
-    <meta-data
-      android:name="com.amap.api.v2.apikey"
-      android:value="YOUR_API_KEY_HERE"/>
-    -->
-    
-    <!-- 定位前台服务 -->
+  
+    <!-- 高德地图定位服务 (必需) -->
     <service
-      android:name="expo.modules.gaodemap.services.LocationForegroundService"
+      android:name="com.amap.api.location.APSService"
       android:enabled="true"
-      android:exported="false"
-      android:foregroundServiceType="location" />
+      android:exported="false" />
+    
   </application>
   
 </manifest>

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

@@ -396,16 +396,28 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
     /** 销毁地图 */
     @Suppress("unused")
     fun onDestroy() {
-        // 清理 Handler 回调,防止内存泄露
-        mainHandler.removeCallbacksAndMessages(null)
-
-        // 清理地图监听器
-        aMap.setOnMapClickListener(null)
-        aMap.setOnMapLongClickListener(null)
-        aMap.setOnMapLoadedListener(null)
+               try {
+            // 清理 Handler 回调,防止内存泄露
+            mainHandler.removeCallbacksAndMessages(null)
+
+            // 清理所有地图监听器
+            aMap.setOnMapClickListener(null)
+            aMap.setOnMapLongClickListener(null)
+            aMap.setOnMapLoadedListener(null)
+            aMap.setOnCameraChangeListener(null)
+            aMap.setOnMarkerClickListener(null)
+            aMap.setOnMarkerDragListener(null)
+
+            // 清除所有覆盖物
+            aMap.clear()
+
+            // 销毁地图实例
+            mapView.onDestroy()
+        } catch (e: Exception) {
+            // 静默处理异常,确保销毁流程不会中断
+            android.util.Log.e("ExpoGaodeMapView", "Error destroying map", e)
+        }
 
-        // 销毁地图
-        mapView.onDestroy()
     }
 
     /** 保存实例状态 */

package/android/src/main/java/expo/modules/gaodemap/ExpoGaodeMapViewModule.kt

@@ -14,9 +14,13 @@ class ExpoGaodeMapViewModule : Module() {
       Events("onMapPress", "onMapLongPress", "onLoad", "onLocation", "onCameraMove", "onCameraIdle")
       
       // ✅ 关键修复：拦截 React Native 的视图操作异常
-      OnViewDestroys { _: ExpoGaodeMapView ->
+   
+      OnViewDestroys { view: ExpoGaodeMapView ->
+        // 销毁地图实例,释放资源
+        view.onDestroy()
       }
 
+
       Prop<Int>("mapType") { view, type ->
         view.mapType = type
         view.setMapType(type)

package/build/index.d.ts

@@ -5,5 +5,6 @@ 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';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/build/index.js

@@ -7,6 +7,8 @@ export { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';
 export { default as MapView } 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';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKrE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块 - 直接使用，无需封装\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 从 ExpoGaodeMapModule 重新导出类型，方便使用\nexport type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKrE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\n// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块 - 直接使用，无需封装\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 从 ExpoGaodeMapModule 重新导出类型，方便使用\nexport type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}

package/build/utils/ModuleLoader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 模块检测器 - 用于检测可选模块是否已安装
+ */
+/**
+ * 可选模块名称常量
+ */
+export declare const OptionalModules: {
+    readonly SEARCH: "@expo-gaode-map/search";
+    readonly NAVIGATION: "@expo-gaode-map/navigation";
+    readonly ROUTE: "@expo-gaode-map/route";
+    readonly GEOCODER: "@expo-gaode-map/geocoder";
+};
+/**
+ * 延迟加载可选模块
+ * 使用示例:
+ *
+ * @example
+ * ```typescript
+ * import { OptionalModules, lazyLoad } from 'expo-gaode-map';
+ *
+ * let SearchModule = null;
+ *
+ * function loadSearch() {
+ *   if (SearchModule == null) {
+ *     try {
+ *       SearchModule = require('expo-gaode-map-search');
+ *     } catch (error) {
+ *       console.warn('搜索模块未安装');
+ *       return null;
+ *     }
+ *   }
+ *   return SearchModule;
+ * }
+ *
+ * // 使用
+ * const search = loadSearch();
+ * if (search) {
+ *   const results = await search.searchPOI({ keyword: '餐厅' });
+ * }
+ * ```
+ */
+/**
+ * 检查必需模块,如果未安装则抛出错误
+ * @param moduleName 模块名称
+ * @param featureName 功能名称(用于错误提示)
+ */
+export declare function requireModule(moduleName: string, featureName: string): void;
+/**
+ * 获取已安装的可选模块列表
+ * 注意: 此函数无法在运行时准确检测,仅作为文档说明
+ */
+export declare function getInstalledModules(): string[];
+/**
+ * 打印已安装模块信息(用于调试)
+ */
+export declare function printModuleInfo(): void;
+/**
+ * 创建延迟加载器
+ *
+ * @example
+ * ```typescript
+ * import { createLazyLoader } from 'expo-gaode-map';
+ *
+ * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));
+ *
+ * // 使用时
+ * const SearchModule = loadSearch();
+ * if (SearchModule) {
+ *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });
+ * }
+ * ```
+ */
+export declare function createLazyLoader<T>(loader: () => T): () => T | null;
+//# sourceMappingURL=ModuleLoader.d.ts.map

package/build/utils/ModuleLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleLoader.d.ts","sourceRoot":"","sources":["../../src/utils/ModuleLoader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAM3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAM9C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAQtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAgBnE"}

package/build/utils/ModuleLoader.js

@@ -0,0 +1,106 @@
+/**
+ * 模块检测器 - 用于检测可选模块是否已安装
+ */
+/**
+ * 可选模块名称常量
+ */
+export const OptionalModules = {
+    SEARCH: '@expo-gaode-map/search',
+    NAVIGATION: '@expo-gaode-map/navigation',
+    ROUTE: '@expo-gaode-map/route',
+    GEOCODER: '@expo-gaode-map/geocoder',
+};
+/**
+ * 延迟加载可选模块
+ * 使用示例:
+ *
+ * @example
+ * ```typescript
+ * import { OptionalModules, lazyLoad } from 'expo-gaode-map';
+ *
+ * let SearchModule = null;
+ *
+ * function loadSearch() {
+ *   if (SearchModule == null) {
+ *     try {
+ *       SearchModule = require('expo-gaode-map-search');
+ *     } catch (error) {
+ *       console.warn('搜索模块未安装');
+ *       return null;
+ *     }
+ *   }
+ *   return SearchModule;
+ * }
+ *
+ * // 使用
+ * const search = loadSearch();
+ * if (search) {
+ *   const results = await search.searchPOI({ keyword: '餐厅' });
+ * }
+ * ```
+ */
+/**
+ * 检查必需模块,如果未安装则抛出错误
+ * @param moduleName 模块名称
+ * @param featureName 功能名称(用于错误提示)
+ */
+export function requireModule(moduleName, featureName) {
+    console.warn(`[expo-gaode-map] 使用 ${featureName} 需要安装 ${moduleName}。\n` +
+        `请运行: npm install ${moduleName}\n` +
+        `然后使用 try-catch 包裹 require('${moduleName}') 来加载`);
+}
+/**
+ * 获取已安装的可选模块列表
+ * 注意: 此函数无法在运行时准确检测,仅作为文档说明
+ */
+export function getInstalledModules() {
+    console.warn('[expo-gaode-map] getInstalledModules() 无法在运行时检测。\n' +
+        '请在编译时检查 package.json 中安装的模块');
+    return [];
+}
+/**
+ * 打印已安装模块信息(用于调试)
+ */
+export function printModuleInfo() {
+    console.log('[expo-gaode-map] 核心模块: 已加载');
+    console.log('[expo-gaode-map] 可选模块检测:');
+    console.log('  - 使用 try-catch 包裹 require() 来检测可选模块');
+    console.log('  - 可用的可选模块:');
+    Object.entries(OptionalModules).forEach(([key, value]) => {
+        console.log(`    - ${key}: ${value}`);
+    });
+}
+/**
+ * 创建延迟加载器
+ *
+ * @example
+ * ```typescript
+ * import { createLazyLoader } from 'expo-gaode-map';
+ *
+ * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));
+ *
+ * // 使用时
+ * const SearchModule = loadSearch();
+ * if (SearchModule) {
+ *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });
+ * }
+ * ```
+ */
+export function createLazyLoader(loader) {
+    let cached = null;
+    let attempted = false;
+    return () => {
+        if (!attempted) {
+            attempted = true;
+            try {
+                cached = loader();
+            }
+            catch (error) {
+                console.warn('[expo-gaode-map] 模块加载失败:', error);
+                cached = null;
+            }
+        }
+        return cached;
+    };
+}
+//# sourceMappingURL=ModuleLoader.js.map

package/build/utils/ModuleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleLoader.js","sourceRoot":"","sources":["../../src/utils/ModuleLoader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,wBAAwB;IAChC,UAAU,EAAE,4BAA4B;IACxC,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,0BAA0B;CAC5B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,WAAmB;IACnE,OAAO,CAAC,IAAI,CACV,uBAAuB,WAAW,SAAS,UAAU,KAAK;QAC1D,oBAAoB,UAAU,IAAI;QAClC,8BAA8B,UAAU,QAAQ,CACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,IAAI,CACV,oDAAoD;QACpD,6BAA6B,CAC9B,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACvD,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAI,MAAe;IACjD,IAAI,MAAM,GAAa,IAAI,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;gBAChD,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * 模块检测器 - 用于检测可选模块是否已安装\n */\n\n/**\n * 可选模块名称常量\n */\nexport const OptionalModules = {\n  SEARCH: '@expo-gaode-map/search',\n  NAVIGATION: '@expo-gaode-map/navigation',\n  ROUTE: '@expo-gaode-map/route',\n  GEOCODER: '@expo-gaode-map/geocoder',\n} as const;\n\n/**\n * 延迟加载可选模块\n * 使用示例:\n * \n * @example\n * ```typescript\n * import { OptionalModules, lazyLoad } from 'expo-gaode-map';\n * \n * let SearchModule = null;\n * \n * function loadSearch() {\n *   if (SearchModule == null) {\n *     try {\n *       SearchModule = require('expo-gaode-map-search');\n *     } catch (error) {\n *       console.warn('搜索模块未安装');\n *       return null;\n *     }\n *   }\n *   return SearchModule;\n * }\n * \n * // 使用\n * const search = loadSearch();\n * if (search) {\n *   const results = await search.searchPOI({ keyword: '餐厅' });\n * }\n * ```\n */\n\n/**\n * 检查必需模块,如果未安装则抛出错误\n * @param moduleName 模块名称\n * @param featureName 功能名称(用于错误提示)\n */\nexport function requireModule(moduleName: string, featureName: string): void {\n  console.warn(\n    `[expo-gaode-map] 使用 ${featureName} 需要安装 ${moduleName}。\\n` +\n    `请运行: npm install ${moduleName}\\n` +\n    `然后使用 try-catch 包裹 require('${moduleName}') 来加载`\n  );\n}\n\n/**\n * 获取已安装的可选模块列表\n * 注意: 此函数无法在运行时准确检测,仅作为文档说明\n */\nexport function getInstalledModules(): string[] {\n  console.warn(\n    '[expo-gaode-map] getInstalledModules() 无法在运行时检测。\\n' +\n    '请在编译时检查 package.json 中安装的模块'\n  );\n  return [];\n}\n\n/**\n * 打印已安装模块信息(用于调试)\n */\nexport function printModuleInfo(): void {\n  console.log('[expo-gaode-map] 核心模块: 已加载');\n  console.log('[expo-gaode-map] 可选模块检测:');\n  console.log('  - 使用 try-catch 包裹 require() 来检测可选模块');\n  console.log('  - 可用的可选模块:');\n  Object.entries(OptionalModules).forEach(([key, value]) => {\n    console.log(`    - ${key}: ${value}`);\n  });\n}\n\n/**\n * 创建延迟加载器\n * \n * @example\n * ```typescript\n * import { createLazyLoader } from 'expo-gaode-map';\n * \n * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));\n * \n * // 使用时\n * const SearchModule = loadSearch();\n * if (SearchModule) {\n *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });\n * }\n * ```\n */\nexport function createLazyLoader<T>(loader: () => T): () => T | null {\n  let cached: T | null = null;\n  let attempted = false;\n\n  return () => {\n    if (!attempted) {\n      attempted = true;\n      try {\n        cached = loader();\n      } catch (error) {\n        console.warn('[expo-gaode-map] 模块加载失败:', error);\n        cached = null;\n      }\n    }\n    return cached;\n  };\n}"]}

package/ios/ExpoGaodeMap.podspec

@@ -19,8 +19,12 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
+  
+  # 核心依赖 - 3D地图和定位
   s.dependency 'AMap3DMap', '10.0.600'
-  s.dependency "AMapLocation"
+  s.dependency 'AMapLocation'
+
+  
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {
     'DEFINES_MODULE' => 'YES',

package/ios/ExpoGaodeMapModule.swift

@@ -24,6 +24,8 @@ public class ExpoGaodeMapModule: Module {
         OnCreate {
             MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
             MAMapView.updatePrivacyShow(AMapPrivacyShowStatus.didShow, privacyInfo: AMapPrivacyInfoStatus.didContain)
+
+      
         }
         
         // ==================== SDK 初始化 ====================

package/package.json

@@ -1,23 +1,9 @@
 {
   "name": "expo-gaode-map",
-  "version": "2.0.0",
+  "version": "2.1.0-beta.0",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",
-  "scripts": {
-    "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 && npm run build:plugin",
-    "prepublishOnly": "expo-module prepublishOnly",
-    "expo-module": "expo-module",
-    "open:ios": "xed example/ios",
-    "open:android": "open -a \"Android Studio\" example/android",
-    "publish:next": "npm publish --tag next",
-    "publish:latest": "npm publish --tag latest"
-  },
   "keywords": [
     "react-native",
     "expo",
@@ -47,5 +33,17 @@
     "expo": "*",
     "react": "*",
     "react-native": "*"
+  },
+  "scripts": {
+    "build": "expo-module build && pnpm 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",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android",
+    "publish:next": "pnpm publish --tag next",
+    "publish:latest": "pnpm publish --tag latest"
   }
-}
+}

package/plugin/build/withGaodeMap.d.ts

@@ -11,6 +11,8 @@ export type GaodeMapPluginProps = {
     enableLocation?: boolean;
     /** iOS 定位权限描述 */
     locationDescription?: string;
+    /** 是否启用后台定位（Android & iOS） */
+    enableBackgroundLocation?: boolean;
 };
 /**
  * 导出为可运行一次的插件