expo-gaode-map 2.0.0-alpha.6 → 2.0.0

package/RELEASE_v2.0.0.md

@@ -0,0 +1,59 @@
+## 🎉 v2.0.0 正式版发布
+
+一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发。
+
+## ✨ 核心特性
+
+- 🗺️ **完整的地图功能** - 多种地图类型、相机控制、手势配置
+- 📍 **精准定位服务** - 连续定位、单次定位、逆地理编码
+- 🎨 **丰富的覆盖物** - Marker、Circle、Polyline、Polygon、HeatMap、Cluster
+- 💎 **完整 TypeScript 支持** - 零 any 类型，完美的类型推导
+- 🚀 **基于 Expo Modules** - 现代化的原生模块开发体验
+- 📱 **跨平台支持** - 同时支持 Android 和 iOS
+- 🔄 **新旧架构兼容** - 支持 React Native Paper & Fabric
+
+## 📦 安装
+
+```bash
+npm install expo-gaode-map
+```
+
+## 🚀 快速开始
+
+```tsx
+import { MapView, ExpoGaodeMapModule } from 'expo-gaode-map';
+
+// 初始化
+ExpoGaodeMapModule.initSDK({
+  androidKey: 'your-android-key',
+  iosKey: 'your-ios-key',
+});
+
+// 使用地图
+<MapView
+  style={{ flex: 1 }}
+  myLocationEnabled={true}
+/>
+```
+
+## 📖 完整文档
+
+**👉 [在线文档](https://TomWq.github.io/expo-gaode-map/)**
+
+- [快速开始](https://TomWq.github.io/expo-gaode-map/guide/getting-started.html)
+- [API 文档](https://TomWq.github.io/expo-gaode-map/api/)
+- [使用示例](https://TomWq.github.io/expo-gaode-map/examples/)
+
+## 🔄 从 v1.x 升级
+
+查看 [迁移指南](https://github.com/TomWq/expo-gaode-map/blob/main/docs/MIGRATION.md)
+
+## 📮 反馈与支持
+
+- 📝 [提交 Issue](https://github.com/TomWq/expo-gaode-map/issues)
+- 💬 [参与讨论](https://github.com/TomWq/expo-gaode-map/discussions)
+- 💬 QQ 群：952241387
+
+## 📄 许可证
+
+MIT License

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/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.6",
+  "version": "2.0.0",
   "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"}