expo-gaode-map 2.0.1 → 2.2.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,13 +43,7 @@ android {
 }
 
 dependencies {
-    // 核心依赖 - 3D地图SDK（已包含定位功能）需要移除搜索单独引入
-    implementation ('com.amap.api:3dmap:10.0.600'){
-       exclude group: 'com.amap.api', module: 'search' 
-    }
-    
-    // 可选依赖 - 只在编译时需要,运行时由可选包提供
-    // 如果用户安装了对应的可选包,这些依赖会被可选包提供
-    compileOnly 'com.amap.api:search:9.7.1'        // 搜索服务 (expo-gaode-map-search)
+
+    implementation 'com.amap.api:3dmap:10.0.600'
 
 }

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

@@ -396,7 +396,7 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
     /** 销毁地图 */
     @Suppress("unused")
     fun onDestroy() {
-        try {
+               try {
             // 清理 Handler 回调,防止内存泄露
             mainHandler.removeCallbacksAndMessages(null)
 
@@ -417,6 +417,7 @@ class ExpoGaodeMapView(context: Context, appContext: AppContext) : ExpoView(cont
             // 静默处理异常,确保销毁流程不会中断
             android.util.Log.e("ExpoGaodeMapView", "Error destroying map", e)
         }
+
     }
 
     /** 保存实例状态 */

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

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

package/ios/ExpoGaodeMap.podspec

@@ -23,10 +23,7 @@ Pod::Spec.new do |s|
   # 核心依赖 - 3D地图和定位
   s.dependency 'AMap3DMap', '10.0.600'
   s.dependency 'AMapLocation'
-  
-  # 注意: 可选功能的依赖不在核心包中声明
-  # 搜索功能: AMapSearch (由 expo-gaode-map-search 提供)
-  # 导航功能: AMapNavi (由 expo-gaode-map-navigation 提供)
+
   
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {

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.1",
+  "version": "2.2.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.js

@@ -132,12 +132,12 @@ const withGaodeMapAndroidManifest = (config, props) => {
     });
 };
 /**
- * Android: 修改 app/build.gradle 添加依赖
+ * Android: 修改 app/build.gradle（预留扩展）
  */
 const withGaodeMapAppBuildGradle = (config, props) => {
     return (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
-        // 这里可以添加额外的 Gradle 配置，如果需要的话
-        // 例如添加 maven 仓库或其他依赖
+        // Android 3D 地图 SDK 10.0+ 已内置搜索功能
+        // 不需要额外的 Gradle 配置
         return config;
     });
 };

package/DEPLOY_DOCS.md

@@ -1,209 +0,0 @@
-# 📚 文档网站部署指南
-
-本文档说明如何部署 expo-gaode-map 的文档网站到 GitHub Pages。
-
-## 🌟 项目结构
-
-```
-expo-gaode-map/
-├── website/                      # 文档网站目录
-│   ├── docs/                    # 文档源文件
-│   │   ├── .vitepress/         # VitePress 配置
-│   │   │   └── config.mts      # 网站配置文件
-│   │   ├── guide/              # 指南文档
-│   │   ├── api/                # API 文档
-│   │   ├── examples/           # 示例文档
-│   │   └── index.md            # 首页
-│   ├── package.json            # 依赖配置
-│   └── README.md               # 网站说明
-└── .github/
-    └── workflows/
-        └── deploy-docs.yml     # 自动部署配置
-```
-
-## 🚀 快速部署
-
-### 方式一：GitHub Actions 自动部署（推荐）
-
-1. **启用 GitHub Pages**
-   
-   进入你的 GitHub 仓库设置：
-   - 点击 `Settings` > `Pages`
-   - 在 **Source** 下选择 `GitHub Actions`
-
-2. **推送代码**
-   
-   ```bash
-   git add .
-   git commit -m "Add documentation website"
-   git push origin main
-   ```
-
-3. **等待部署完成**
-   
-   - 进入仓库的 `Actions` 标签页
-   - 查看 "Deploy Docs" 工作流的运行状态
-   - 部署成功后，访问: `https://<your-username>.github.io/expo-gaode-map/`
-
-### 方式二：本地构建后手动部署
-
-1. **安装依赖**
-   
-   ```bash
-   cd website
-   npm install
-   ```
-
-2. **构建网站**
-   
-   ```bash
-   npm run docs:build
-   ```
-
-3. **部署到 GitHub Pages**
-   
-   ```bash
-   # 进入构建产物目录
-   cd docs/.vitepress/dist
-   
-   # 初始化 git 仓库
-   git init
-   git add -A
-   git commit -m 'Deploy documentation'
-   
-   # 推送到 gh-pages 分支
-   git push -f git@github.com:<your-username>/expo-gaode-map.git main:gh-pages
-   
-   cd ../../../..
-   ```
-
-4. **配置 GitHub Pages**
-   
-   - 进入 `Settings` > `Pages`
-   - Source 选择 `Deploy from a branch`
-   - Branch 选择 `gh-pages` 和 `/ (root)`
-
-## 🔧 配置说明
-
-### 修改 Base URL
-
-如果你的 GitHub 仓库名不是 `expo-gaode-map`，需要修改配置：
-
-**文件:** `website/docs/.vitepress/config.mts`
-
-```ts
-export default defineConfig({
-  base: '/your-repo-name/',  // 修改为你的仓库名
-  // ...
-})
-```
-
-**文件:** `.github/workflows/deploy-docs.yml`
-
-确保工作流配置正确（当前配置已经是通用的，通常不需要修改）。
-
-### 自定义域名（可选）
-
-如果要使用自定义域名：
-
-1. 在 `website/docs/public/` 目录下创建 `CNAME` 文件
-2. 文件内容为你的域名，例如: `docs.yoursite.com`
-3. 在你的域名 DNS 设置中添加 CNAME 记录指向 `<username>.github.io`
-
-## 📝 本地开发
-
-### 启动开发服务器
-
-```bash
-cd website
-npm install
-npm run docs:dev
-```
-
-访问 http://localhost:5173 查看文档。
-
-### 预览生产版本
-
-```bash
-npm run docs:build
-npm run docs:preview
-```
-
-## 🎨 自定义文档
-
-### 添加新页面
-
-1. 在相应目录下创建 `.md` 文件
-2. 在 `config.mts` 中添加导航和侧边栏配置
-3. 编写文档内容
-
-### 修改主题
-
-VitePress 支持主题自定义，详见 [VitePress 文档](https://vitepress.dev/guide/custom-theme)。
-
-## ✅ 验证部署
-
-部署完成后，访问以下 URL 验证：
-
-- **首页:** `https://<username>.github.io/expo-gaode-map/`
-- **快速开始:** `https://<username>.github.io/expo-gaode-map/guide/getting-started`
-- **API 文档:** `https://<username>.github.io/expo-gaode-map/api/`
-
-## 🐛 常见问题
-
-### 1. 页面样式丢失或 404
-
-**问题:** 部署后页面样式丢失或资源 404
-
-**解决方案:** 检查 `base` 配置是否正确设置为 `/your-repo-name/`
-
-### 2. GitHub Actions 部署失败
-
-**问题:** Actions 工作流运行失败
-
-**解决方案:**
-- 检查 GitHub Pages 是否已启用
-- 确保选择了 "GitHub Actions" 作为 Source
-- 查看 Actions 日志获取详细错误信息
-
-### 3. 本地可以访问，部署后无法访问
-
-**问题:** 本地开发正常，部署后无法访问
-
-**解决方案:**
-- 确认 GitHub Pages 设置正确
-- 等待几分钟让 DNS 传播
-- 清除浏览器缓存
-
-### 4. 中文路径问题
-
-**问题:** 包含中文的文件名导致 URL 编码问题
-
-**解决方案:** 使用英文文件名，在文档内容中使用中文标题
-
-## 📚 参考资源
-
-- [VitePress 官方文档](https://vitepress.dev/)
-- [GitHub Pages 文档](https://docs.github.com/en/pages)
-- [GitHub Actions 文档](https://docs.github.com/en/actions)
-
-## 🤝 贡献文档
-
-欢迎改进文档！
-
-1. Fork 本仓库
-2. 创建特性分支
-3. 修改文档内容
-4. 提交 Pull Request
-
-## 📄 许可证
-
-MIT
-
----
-
-**需要帮助？**
-
-- 📝 [提交 Issue](https://github.com/TomWq/expo-gaode-map/issues)
-- 💬 [参与讨论](https://github.com/TomWq/expo-gaode-map/discussions)
-- 💬 加入 QQ 群: 952241387