expo-gaode-map 1.0.0 → 1.0.2

package/docs/RELEASE_GUIDE.md

@@ -0,0 +1,178 @@
+# GitHub Release 创建指南
+
+本指南将帮助您在 GitHub 上为 expo-gaode-map 项目创建新的 release。
+
+## 当前版本信息
+
+- **当前版本**: 1.0.1
+- **GitHub 仓库**: https://github.com/TomWq/expo-gaode-map
+
+## 创建 Release 的步骤
+
+### 1. 访问 GitHub 仓库
+
+1. 打开您的 GitHub 仓库：https://github.com/TomWq/expo-gaode-map
+2. 在仓库主页，点击右侧的 **"Releases"** 链接
+3. 或者直接访问：https://github.com/TomWq/expo-gaode-map/releases
+
+### 2. 创建新 Release
+
+1. 点击 **"Create a new release"** 按钮
+2. 填写以下信息：
+
+#### 标签版本 (Tag version)
+- 格式：`v1.0.1` (遵循语义化版本规范)
+- 建议使用：`v1.0.1` (对应 package.json 中的版本)
+
+#### 发布标题 (Release title)
+- 格式：`v1.0.1 - 功能描述`
+- 示例：`v1.0.1 - 初始稳定版本发布`
+
+#### 描述信息 (Describe this release)
+建议包含以下内容：
+
+```markdown
+## 🎉 expo-gaode-map v1.0.1 发布
+
+### ✨ 新特性
+- 完整的高德地图 React Native 组件库
+- 基于 Expo Modules 开发
+- 支持 Android 和 iOS 平台
+- 提供地图显示、定位、覆盖物等功能
+
+### 🗺️ 主要功能
+- ✅ 完整的地图功能（多种地图类型、手势控制、相机操作）
+- ✅ 精准定位（连续定位、单次定位、坐标转换）
+- ✅ 丰富的覆盖物（Circle、Marker、Polyline、Polygon）
+- ✅ 完整的 TypeScript 类型定义（零 any 类型）
+- ✅ 模块化架构设计
+- ✅ 同时支持声明式组件和命令式 API
+- ✅ 跨平台支持（Android、iOS）
+- ✅ 支持自定义样式和事件监听
+- ✅ 同时支持 React Native 新旧架构（Paper & Fabric）
+
+### 📦 安装方式
+```bash
+npm install expo-gaode-map
+```
+
+### 📚 文档
+- [快速开始](https://github.com/TomWq/expo-gaode-map#快速开始)
+- [API 文档](docs/API.md)
+- [使用示例](docs/EXAMPLES.md)
+
+### 🔗 相关链接
+- [高德地图开放平台](https://lbs.amap.com/)
+- [Expo Modules API](https://docs.expo.dev/modules/overview/)
+
+---
+
+**注意**: 使用前请确保已获取高德地图 API Key 并完成原生配置。
+```
+
+### 3. 附加文件 (可选)
+
+您可以选择附加以下文件：
+- 源代码 zip 文件 (GitHub 会自动生成)
+- 构建产物 (如果有的话)
+
+### 4. 发布设置
+
+- **预发布 (Pre-release)**: 如果这是测试版本，勾选此项
+- **最新版本 (Set as latest release)**: 保持勾选
+- **讨论 (Create a discussion for this release)**: 可选
+
+### 5. 发布
+
+点击 **"Publish release"** 按钮完成发布。
+
+## 版本号规范建议
+
+遵循语义化版本规范 (SemVer)：
+
+- **主版本号 (MAJOR)**: 不兼容的 API 修改
+- **次版本号 (MINOR)**: 向下兼容的功能性新增
+- **修订号 (PATCH)**: 向下兼容的问题修正
+
+示例：
+- `v1.0.0` - 初始稳定版本
+- `v1.0.1` - Bug 修复
+- `v1.1.0` - 新功能添加
+- `v2.0.0` - 重大更新，不兼容旧版本
+
+## 最佳实践
+
+### 1. 发布前检查
+- 确保所有测试通过
+- 更新 CHANGELOG.md (如果存在)
+- 验证文档准确性
+
+### 2. 发布内容
+- 提供清晰的发布说明
+- 包含安装和使用指南
+- 列出已知问题和限制
+
+### 3. 发布后
+- 在 README.md 中更新版本信息
+- 考虑发布到 npm 注册表
+- 通知社区用户
+
+## 自动化发布 (可选)
+
+对于未来的发布，您可以考虑设置 GitHub Actions 来自动化发布流程：
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+      - uses: actions/upload-artifact@v3
+        with:
+          name: dist
+          path: build/
+```
+
+## 常见问题
+
+### Q: 如何更新版本号？
+A: 在 package.json 中更新版本号，然后提交并推送：
+```bash
+# 更新 package.json 中的版本号
+npm version patch  # 修订号 +1
+npm version minor  # 次版本号 +1
+npm version major  # 主版本号 +1
+
+# 提交并推送
+git push origin main --tags
+```
+
+### Q: 发布后如何撤销？
+A: GitHub 不允许直接删除 release，但可以：
+1. 编辑 release 标记为预发布
+2. 创建新的修复版本
+3. 在描述中说明问题
+
+### Q: 如何管理多个版本？
+A: 使用 Git 标签和分支：
+- `main` 分支：最新稳定版本
+- 功能分支：新功能开发
+- Git 标签：每个发布版本
+
+---
+
+**提示**: 首次发布建议先创建预发布版本进行测试，确认无误后再发布正式版本。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "一个功能完整的高德地图 React Native 组件库，基于 Expo Modules 开发，提供地图显示、定位、覆盖物等功能。",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/ExpoGaodeMap.types.ts

@@ -1,13 +1,4 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:03:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:30:00
- * @FilePath     : /expo-gaode-map/src/ExpoGaodeMap.types.ts
- * @Description  : 高德地图 Expo Module 主类型定义文件
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
+
 
 // 导出所有类型定义
 export * from './types';

package/src/ExpoGaodeMapModule.ts

@@ -1,13 +1,4 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:03:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:58:00
- * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapModule.ts
- * @Description  : 
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
+
 import { NativeModule, requireNativeModule } from 'expo';
 import type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';
 

package/src/ExpoGaodeMapView.tsx

@@ -1,24 +1,13 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:03:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 01:50:18
- * @FilePath     : /expo-gaode-map/src/ExpoGaodeMapView.tsx
- * @Description  : 高德地图视图组件
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 
-import type { 
-  MapViewProps, 
+import type {
+  MapViewProps,
   MapViewRef,
   NativeMapViewRef,
-  CameraPosition, 
-  LatLng, 
-  Point, 
+  CameraPosition,
+  LatLng,
+  Point,
   CircleProps,
   MarkerProps,
   PolylineProps,
@@ -34,109 +23,222 @@ const NativeView: React.ComponentType<MapViewProps & { ref?: React.Ref<NativeMap
 export const MapContext = React.createContext<React.RefObject<MapViewRef | null> | null>(null);
 
 /**
- * 高德地图视图组件
+ * 高德地图视图组件，提供地图操作API和覆盖物管理功能
+ * 
+ * @param props - 组件属性
+ * @param ref - 外部ref引用，用于访问地图API方法
+ * @returns 返回包含地图视图和上下文提供者的React组件
+ * 
+ * @remarks
+ * 该组件内部维护两个ref：
+ * - nativeRef: 指向原生地图视图的引用
+ * - internalRef: 内部使用的API引用，通过MapContext共享
  * 
- * @example
- * ```tsx
- * import { MapView } from 'expo-gaode-map';
+ * 提供的主要API功能包括：
+ * - 相机控制（移动、缩放、获取当前位置）
+ * - 覆盖物管理（添加/删除/更新标记、折线、多边形、圆形等）
  * 
- * function MyMap() {
- *   const mapRef = React.useRef(null);
- *   
- *   return (
- *     <MapView
- *       ref={mapRef}
- *       style={{ flex: 1 }}
- *       initialCameraPosition={{
- *         target: { latitude: 39.9, longitude: 116.4 },
- *         zoom: 10,
- *       }}
- *       onLoad={() => console.log('地图加载完成')}
- *     />
- *   );
- * }
- * ```
+ * 所有API方法都会检查地图是否已初始化，未初始化时抛出错误
  */
 const ExpoGaodeMapView = React.forwardRef<MapViewRef, MapViewProps>((props, ref) => {
   const nativeRef = React.useRef<NativeMapViewRef>(null);
   const internalRef = React.useRef<MapViewRef | null>(null);
 
   const apiRef: MapViewRef = React.useMemo(() => ({
+    /**
+     * 移动地图相机到指定位置
+     * @param position 相机位置参数对象，包含目标经纬度、缩放级别等信息
+     * @param duration 动画持续时间（毫秒），默认300毫秒
+     * @throws 如果地图视图未初始化则抛出错误
+     * @returns Promise<void> 异步操作完成后的Promise
+     */
     moveCamera: async (position: CameraPosition, duration: number = 300) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.moveCamera(position, duration);
     },
+    /**
+     * 将屏幕坐标点转换为地理坐标（经纬度）
+     * @param point 屏幕坐标点 {x: number, y: number}
+     * @returns 返回Promise，解析为对应的地理坐标 {latitude: number, longitude: number}
+     * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'
+     */
     getLatLng: async (point: Point) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.getLatLng(point);
     },
+    /**
+     * 设置地图中心点坐标
+     * @param center 要设置的中心点坐标(LatLng格式)
+     * @param animated 是否使用动画效果移动地图(默认为false)
+     * @throws 如果地图视图未初始化则抛出错误
+     */
     setCenter: async (center: LatLng, animated: boolean = false) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.setCenter(center, animated);
     },
+    /**
+     * 设置地图的缩放级别
+     * @param zoom 目标缩放级别
+     * @param animated 是否使用动画过渡效果，默认为false
+     * @throws 如果地图视图未初始化，抛出错误
+     */
     setZoom: async (zoom: number, animated: boolean = false) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.setZoom(zoom, animated);
     },
+    /**
+     * 获取当前地图的相机位置（视角中心点、缩放级别、倾斜角度等）
+     * @returns 返回一个Promise，解析为当前相机位置的对象
+     * @throws 如果地图视图未初始化，则抛出错误
+     */
     getCameraPosition: async () => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.getCameraPosition();
     },
+    /**
+     * 在地图上添加圆形覆盖物
+     * @param id - 圆形覆盖物的唯一标识符
+     * @param props - 圆形覆盖物的属性配置
+     * @returns Promise<void> 添加操作的异步结果
+     * @throws 如果地图视图未初始化，抛出错误'MapView not initialized'
+     */
     addCircle: async (id: string, props: CircleProps) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.addCircle(id, props);
     },
+    /**
+     * 从地图上移除指定的圆形覆盖物
+     * @param id - 要移除的圆形覆盖物的唯一标识符
+     * @throws 如果地图视图未初始化，抛出错误
+     * @returns Promise<void> 异步操作完成
+     */
     removeCircle: async (id: string) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.removeCircle(id);
     },
+    /**
+     * 更新地图上的圆形覆盖物
+     * @param id 要更新的圆形覆盖物的唯一标识符
+     * @param props 要更新的圆形属性（部分属性）
+     * @throws 如果地图视图未初始化，抛出错误
+     * @returns Promise<void> 表示更新操作完成
+     */
     updateCircle: async (id: string, props: Partial<CircleProps>) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.updateCircle(id, props);
     },
+    /**
+     * 添加一个标记点到地图上
+     * @param id 标记点的唯一标识符
+     * @param props 标记点的配置属性
+     * @returns Promise<void> 添加操作完成后的Promise
+     * @throws 如果地图视图未初始化则抛出错误
+     */
     addMarker: async (id: string, props: MarkerProps) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.addMarker(id, props);
     },
+    /**
+     * 从地图上移除指定ID的标记点
+     * @param id 要移除的标记点ID
+     * @throws 如果地图视图未初始化则抛出错误
+     * @returns Promise<void> 异步操作完成
+     */
     removeMarker: async (id: string) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.removeMarker(id);
     },
+    /**
+     * 更新地图上指定ID的标记点属性
+     * @param id - 要更新的标记点唯一标识符
+     * @param props - 需要更新的标记点属性对象（部分属性）
+     * @throws 如果地图视图未初始化则抛出错误
+     * @returns Promise对象，表示异步更新操作
+     */
     updateMarker: async (id: string, props: Partial<MarkerProps>) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.updateMarker(id, props);
     },
+    /**
+     * 添加折线覆盖物到地图
+     * @param id - 折线的唯一标识符
+     * @param props - 折线的配置属性
+     * @returns Promise<void> 添加操作的异步结果
+     * @throws 如果地图视图未初始化则抛出错误
+     */
     addPolyline: async (id: string, props: PolylineProps) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.addPolyline(id, props);
     },
+    /**
+     * 移除地图上的指定折线
+     * @param id - 要移除的折线的唯一标识符
+     * @throws 如果地图视图未初始化，抛出错误
+     * @returns Promise<void>
+     */
     removePolyline: async (id: string) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.removePolyline(id);
     },
+    /**
+     * 更新地图上的折线覆盖物
+     * 
+     * @param id 要更新的折线覆盖物的唯一标识符
+     * @param props 要更新的折线属性，包含部分PolylineProps属性
+     * @returns Promise<void> 异步操作结果
+     * @throws 如果地图视图未初始化，抛出错误
+     */
     updatePolyline: async (id: string, props: Partial<PolylineProps>) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.updatePolyline(id, props);
     },
+    /**
+     * 向地图添加多边形覆盖物
+     * @param id - 多边形的唯一标识符
+     * @param props - 多边形的配置属性
+     * @returns Promise<void> 添加操作的异步结果
+     * @throws 如果地图视图未初始化则抛出错误
+     */
     addPolygon: async (id: string, props: PolygonProps) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.addPolygon(id, props);
     },
+    /**
+     * 移除地图上的多边形覆盖物
+     * @param id - 要移除的多边形覆盖物的唯一标识符
+     * @throws 如果地图视图未初始化，抛出错误 'MapView not initialized'
+     * @returns Promise<void> 异步操作完成
+     */
     removePolygon: async (id: string) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.removePolygon(id);
     },
+    /**
+     * 更新多边形覆盖物的属性
+     * 
+     * @param id - 要更新的多边形覆盖物的唯一标识符
+     * @param props - 要更新的多边形属性对象，包含需要更新的部分属性
+     * @throws {Error} 当地图视图未初始化时抛出错误
+     * @returns Promise<void> 异步操作完成后的Promise
+     */
     updatePolygon: async (id: string, props: Partial<PolygonProps>) => {
       if (!nativeRef.current) throw new Error('MapView not initialized');
       return nativeRef.current.updatePolygon(id, props);
     },
   }), []);
 
-  // 设置 internalRef 和外部 ref
+  /**
+   * 将传入的apiRef赋值给internalRef.current
+   * 用于在组件内部保存对地图API实例的引用
+   */
   React.useEffect(() => {
     internalRef.current = apiRef;
   }, [apiRef]);
 
+  /**
+   * 获取当前地图实例的API引用
+   * @returns 返回地图API的引用对象，可用于调用地图相关方法
+   */
   React.useImperativeHandle(ref, () => apiRef, [apiRef]);
 
   return (

package/src/components/overlays/Circle.tsx

@@ -1,32 +1,26 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:02:00
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:43:00
- * @FilePath     : /expo-gaode-map/src/components/overlays/Circle.tsx
- * @Description  : 地图圆形组件 - 使用命令式 API
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import * as React from 'react';
 import type { CircleProps } from '../../types';
 import { MapContext } from '../../ExpoGaodeMapView';
 
 /**
- * 地图圆形组件
+ * Circle 组件 - 高德地图圆形覆盖物
+ * 
+ * 该组件用于在高德地图上绘制圆形覆盖物，支持动态更新圆形属性。
+ * 
+ * @param {CircleProps} props - 圆形属性配置
+ * @param {LatLng} props.center - 圆形中心点坐标
+ * @param {number} props.radius - 圆形半径（米）
+ * @param {string} props.fillColor - 填充颜色（十六进制或RGBA）
+ * @param {string} props.strokeColor - 边框颜色（十六进制或RGBA）
+ * @param {number} props.strokeWidth - 边框宽度（像素）
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <Circle
- *     center={{ latitude: 39.9, longitude: 116.4 }}
- *     radius={1000}
- *     fillColor={0x440000FF}
- *     strokeColor={0xFFFF0000}
- *   />
- * </MapView>
- * ```
+ * @returns {null} 该组件不渲染任何UI元素
+ * 
+ * @remarks
+ * 1. 组件挂载时自动添加圆形到地图
+ * 2. 组件卸载时自动移除圆形
+ * 3. 当中心点、半径、颜色等属性变化时自动更新圆形
+ * 4. 使用 React Context 获取地图实例引用
  */
 export default function Circle(props: CircleProps) {
   const mapRef = React.useContext(MapContext);
@@ -58,8 +52,13 @@ export default function Circle(props: CircleProps) {
       }
     };
   }, []);
-  
-  // 当 props 变化时更新圆形
+
+
+  /**
+   * 当Circle组件的props发生变化时，更新地图上的圆形覆盖物
+   * 如果圆形ID和地图引用都存在，则调用地图实例的updateCircle方法更新圆形
+   * 更新成功后会打印日志确认
+   */
   React.useEffect(() => {
     console.log('Circle props 变化，更新圆形');
     if (circleIdRef.current && mapRef?.current) {

package/src/components/overlays/Cluster.tsx

@@ -1,37 +1,15 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:02:50
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:19:20
- * @FilePath     : /expo-gaode-map/src/components/overlays/Cluster.tsx
- * @Description  : 地图点聚合组件
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 import type { ClusterProps } from '../../types';
 
 const NativeCluster = requireNativeViewManager('ExpoGaodeMap_ClusterView');
 
+
 /**
- * 地图点聚合组件
- * 将相近的标记点聚合显示，提高大量标记的展示性能
+ * 高德地图点聚合组件
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <Cluster
- *     points={[
- *       { latitude: 39.9, longitude: 116.4, id: '1' },
- *       { latitude: 39.91, longitude: 116.41, id: '2' },
- *     ]}
- *     radius={60}
- *     minClusterSize={2}
- *   />
- * </MapView>
- * ```
+ * @param props 点聚合组件的属性配置
+ * @returns 渲染原生点聚合组件
  */
 export default function Cluster(props: ClusterProps) {
   return <NativeCluster {...props} />;

package/src/components/overlays/HeatMap.tsx

@@ -1,36 +1,15 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:02:15
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:12:07
- * @FilePath     : /expo-gaode-map/src/components/overlays/HeatMap.tsx
- * @Description  : 地图热力图组件
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import { requireNativeViewManager } from 'expo-modules-core';
 import * as React from 'react';
 import type { HeatMapProps } from '../../types';
 
 const NativeHeatMap = requireNativeViewManager('ExpoGaodeMap_HeatMapView');
 
+
 /**
- * 地图热力图组件
+ * 高德地图热力图组件
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <HeatMap
- *     data={[
- *       { latitude: 39.9, longitude: 116.4, intensity: 100 },
- *       { latitude: 39.91, longitude: 116.41, intensity: 80 },
- *     ]}
- *     radius={50}
- *     opacity={0.6}
- *   />
- * </MapView>
- * ```
+ * @param props - 热力图配置属性，继承自NativeHeatMap组件的属性
+ * @returns 渲染高德地图原生热力图组件
  */
 export default function HeatMap(props: HeatMapProps) {
   return <NativeHeatMap {...props} />;

package/src/components/overlays/Marker.tsx

@@ -1,31 +1,21 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:01:10
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 18:55:00
- * @FilePath     : /expo-gaode-map/src/components/overlays/Marker.tsx
- * @Description  : 地图标记组件 - 使用命令式 API
- * 
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. 
- */
-
 import * as React from 'react';
 import { MapContext } from '../../ExpoGaodeMapView';
 import type { MarkerProps } from '../../types';
 
 /**
- * 地图标记组件
+ * Marker 组件 - 用于在地图上显示标记点
+ * 
+ * @param props - 标记点属性配置
+ * @param props.position - 标记点坐标 [经度, 纬度]
+ * @param props.title - 标记点标题
+ * @param props.draggable - 标记点是否可拖动
+ * 
+ * @remarks
+ * 组件内部会自动处理标记点的添加、更新和移除
+ * 当组件卸载时会自动移除对应的地图标记
  * 
- * @example
- * ```tsx
- * <MapView>
- *   <Marker
- *     position={{ latitude: 39.9, longitude: 116.4 }}
- *     title="标记点"
- *     onPress={() => console.log('Marker pressed')}
- *   />
- * </MapView>
- * ```
+ * @note
+ * 组件本身不渲染任何DOM元素，仅作为地图标记的逻辑容器
  */
 export default function Marker(props: MarkerProps) {
   const mapRef = React.useContext(MapContext);