expo-gaode-map-navigation 1.0.1-next.2 → 1.0.1-next.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map-navigation",
-  "version": "1.0.1-next.2",
+  "version": "1.0.1-next.3",
   "description": "高德地图导航功能模块 - 路径规划、导航引导，独立版本包含完整地图功能",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -9,7 +9,8 @@
     "android",
     "ios",
     "app.plugin.js",
-    "expo-module.config.json"
+    "expo-module.config.json",
+    "plugin/build"
   ],
   "keywords": [
     "react-native",
@@ -32,6 +33,7 @@
     "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",

package/plugin/build/withGaodeMap.d.ts

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

package/plugin/build/withGaodeMap.js

@@ -0,0 +1,169 @@
+"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;
+            // 后台定位权限（可选）
+            if (props.enableBackgroundLocation) {
+                config.modResults.NSLocationAlwaysUsageDescription = description;
+                config.modResults.NSLocationAlwaysAndWhenInUseUsageDescription = description;
+                // 添加后台定位模式
+                if (!config.modResults.UIBackgroundModes) {
+                    config.modResults.UIBackgroundModes = [];
+                }
+                if (!config.modResults.UIBackgroundModes.includes('location')) {
+                    config.modResults.UIBackgroundModes.push('location');
+                }
+            }
+        }
+        return config;
+    });
+};
+/**
+ * iOS: 注意 - 不再需要修改 AppDelegate
+ *
+ * 高德地图 SDK 已经支持从 Info.plist 自动读取 API Key
+ * 并且我们在 ExpoGaodeMapModule.swift 中提供了 initSDK 方法
+ * 用户可以选择以下任一方式初始化：
+ * 1. 通过 Info.plist 中的 AMapApiKey 字段（自动读取）
+ * 2. 通过 JavaScript 调用 ExpoGaodeMap.initSDK({ iosKey: 'your-key' })
+ */
+/**
+ * Android: 修改 AndroidManifest.xml 添加 API Key 和权限
+ */
+const withGaodeMapAndroidManifest = (config, props) => {
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const androidManifest = config.modResults.manifest;
+        // 添加基础权限（高德地图 SDK 必需）
+        const basePermissions = [
+            'android.permission.ACCESS_COARSE_LOCATION',
+            'android.permission.ACCESS_FINE_LOCATION',
+            'android.permission.ACCESS_NETWORK_STATE',
+            'android.permission.ACCESS_WIFI_STATE',
+            'android.permission.READ_PHONE_STATE',
+            'android.permission.BLUETOOTH',
+            'android.permission.BLUETOOTH_ADMIN',
+        ];
+        if (!androidManifest['uses-permission']) {
+            androidManifest['uses-permission'] = [];
+        }
+        basePermissions.forEach((permission) => {
+            const hasPermission = androidManifest['uses-permission']?.some((item) => item.$?.['android:name'] === permission);
+            if (!hasPermission) {
+                androidManifest['uses-permission']?.push({
+                    $: { 'android:name': permission },
+                });
+            }
+        });
+        // 后台定位权限（可选，仅在 enableBackgroundLocation 为 true 时添加）
+        if (props.enableBackgroundLocation) {
+            const backgroundPermissions = [
+                'android.permission.ACCESS_BACKGROUND_LOCATION',
+                'android.permission.FOREGROUND_SERVICE',
+                'android.permission.FOREGROUND_SERVICE_LOCATION',
+            ];
+            if (!androidManifest['uses-permission']) {
+                androidManifest['uses-permission'] = [];
+            }
+            backgroundPermissions.forEach((permission) => {
+                const hasPermission = androidManifest['uses-permission']?.some((item) => item.$?.['android:name'] === permission);
+                if (!hasPermission) {
+                    androidManifest['uses-permission']?.push({
+                        $: { 'android:name': permission },
+                    });
+                }
+            });
+        }
+        // 添加前台服务（如果启用后台定位）
+        const mainApplication = androidManifest.application?.[0];
+        if (mainApplication && props.enableBackgroundLocation) {
+            if (!mainApplication['service']) {
+                mainApplication['service'] = [];
+            }
+            // 检查是否已存在 LocationForegroundService
+            const hasService = mainApplication['service'].some((item) => item.$?.['android:name'] === 'expo.modules.gaodemap.services.LocationForegroundService');
+            if (!hasService) {
+                mainApplication['service'].push({
+                    $: {
+                        'android:name': 'expo.modules.gaodemap.services.LocationForegroundService',
+                        'android:enabled': 'true',
+                        'android:exported': 'false',
+                        'android:foregroundServiceType': 'location',
+                    },
+                });
+            }
+        }
+        // 添加 API Key 到 application 标签
+        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) => {
+        // Android 3D 地图 SDK 10.0+ 已内置搜索功能
+        // 不需要额外的 Gradle 配置
+        return config;
+    });
+};
+/**
+ * 主插件函数 - 组合所有修改器
+ */
+const withGaodeMap = (config, props = {}) => {
+    // 验证配置
+    if (!props.iosApiKey && !props.androidApiKey) {
+        config_plugins_1.WarningAggregator.addWarningIOS('expo-gaode-map-navigation', '未配置 API Key。请在 app.json 的 plugins 中配置 iosApiKey 和 androidApiKey');
+    }
+    // 应用 iOS 配置
+    config = withGaodeMapInfoPlist(config, props);
+    // 注意：不再需要修改 AppDelegate，因为：
+    // 1. SDK 会自动从 Info.plist 读取 AMapApiKey
+    // 2. 可以通过 ExpoGaodeMapModule.initSDK() 方法初始化
+    // 应用 Android 配置
+    config = withGaodeMapAndroidManifest(config, props);
+    config = withGaodeMapAppBuildGradle(config, props);
+    return config;
+};
+/**
+ * 导出为可运行一次的插件
+ * 这确保插件只会运行一次，即使在配置中被多次引用
+ */
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withGaodeMap, 'expo-gaode-map-navigation', '1.0.0');