expo-gaode-map 2.0.0-alpha.6 → 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/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-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"}