npm - expo-gaode-map - Versions diffs - 2.0.1 → 2.2.0-beta.0 - Mend

expo-gaode-map 2.0.1 → 2.2.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1101) hide show

package/PUBLISHING.md DELETED Viewed

@@ -1,262 +0,0 @@
-# 发布流程
-本文档说明如何发布 `expo-gaode-map` 的新版本。
-## 发布前准备
-### 1. 确保所有测试通过
-```bash
-# 运行测试
-npm test
-# 运行 lint 检查
-npm run lint
-```
-### 2. 更新版本号
-编辑 `package.json` 中的版本号,遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规则:
-- **主版本号(Major)**: 不兼容的 API 修改
-- **次版本号(Minor)**: 向下兼容的功能性新增
-- **修订号(Patch)**: 向下兼容的问题修正
-或者使用 npm 命令自动更新版本号:
-```bash
-# 修订版本 (1.0.0 -> 1.0.1)
-npm version patch
-# 次版本 (1.0.0 -> 1.1.0)
-npm version minor
-# 主版本 (1.0.0 -> 2.0.0)
-npm version major
-```
-### 3. 更新 CHANGELOG
-在 `CHANGELOG.md` 中记录本次更新的内容:
-```markdown
-## [版本号] - YYYY-MM-DD
-### Added (新增)
-- 新功能描述
-### Changed (变更)
-- 变更内容描述
-### Fixed (修复)
-- Bug 修复描述
-### Breaking Changes (破坏性变更)
-- 不兼容的变更说明
-```
-## 发布步骤
-### 1. 清理构建产物
-```bash
-npm run clean
-```
-### 2. 构建项目
-```bash
-# 构建主模块和 Config Plugin
-npm run build
-```
-这个命令会:
-- 编译 TypeScript 源代码到 `build/` 目录
-- 编译 Config Plugin 到 `plugin/build/` 目录
-### 3. 验证构建产物
-确认以下文件已生成:
-```bash
-# 主模块构建产物
-ls -la build/
-# Config Plugin 构建产物
-ls -la plugin/build/
-```
-### 4. 本地测试(可选但推荐)
-在发布前,可以在本地测试包:
-```bash
-# 打包到本地
-npm pack
-# 会生成 expo-gaode-map-x.x.x.tgz 文件
-# 在测试项目中安装:
-# npm install /path/to/expo-gaode-map-x.x.x.tgz
-```
-### 5. 发布到 npm
-#### 发布稳定版本
-```bash
-# 发布到 latest 标签(默认)
-npm publish --tag latest
-# 或使用快捷脚本
-npm run publish:latest
-```
-#### 发布预发布版本
-如果是 alpha、beta 等预发布版本:
-```bash
-# 发布到 next 标签
-npm publish --tag next
-# 或使用快捷脚本
-npm run publish:next
-```
-用户安装时:
-```bash
-# 安装稳定版
-npm install expo-gaode-map
-# 安装预发布版
-npm install expo-gaode-map@next
-```
-### 6. 创建 Git 标签
-```bash
-# 创建标签
-git tag -a v版本号 -m "Release v版本号"
-# 推送标签到远程
-git push origin v版本号
-# 或推送所有标签
-git push --tags
-```
-### 7. 创建 GitHub Release
-1. 访问 GitHub 仓库的 Releases 页面
-2. 点击 "Create a new release"
-3. 选择刚创建的标签
-4. 填写 Release 标题和说明(可以从 CHANGELOG 复制)
-5. 点击 "Publish release"
-## 完整发布命令(推荐)
-```bash
-# 1. 清理
-npm run clean
-# 2. 构建(包含主模块和插件)
-npm run build
-# 3. 测试
-npm test
-npm run lint
-# 4. 发布到 npm
-npm run publish:latest  # 稳定版
-# 或
-npm run publish:next    # 预发布版
-# 5. 提交代码和标签
-git add .
-git commit -m "chore: release v版本号"
-git tag -a v版本号 -m "Release v版本号"
-git push origin main
-git push origin v版本号
-```
-## 发布文档网站(可选)
-如果更新了文档,也需要部署文档网站:
-```bash
-cd website
-npm run build
-# 然后根据你的部署方式部署 docs/.vitepress/dist 目录
-```
-## 回滚版本
-如果发布后发现问题,可以废弃某个版本:
-```bash
-# 废弃特定版本
-npm deprecate expo-gaode-map@版本号 "这个版本有问题,请使用 x.x.x 版本"
-# 取消发布(发布后24小时内)
-npm unpublish expo-gaode-map@版本号
-```
-## 发布检查清单
-- [ ] 更新版本号
-- [ ] 更新 CHANGELOG.md
-- [ ] 运行 `npm run clean`
-- [ ] 运行 `npm run build`
-- [ ] 运行 `npm test`
-- [ ] 运行 `npm run lint`
-- [ ] 确认 `build/` 目录有构建产物
-- [ ] 确认 `plugin/build/` 目录有构建产物
-- [ ] 本地测试 npm pack
-- [ ] 发布到 npm
-- [ ] 创建 Git 标签
-- [ ] 推送标签到 GitHub
-- [ ] 创建 GitHub Release
-- [ ] 在测试项目中验证新版本
-## 注意事项
-1. **Config Plugin 构建**: 确保 `plugin/build/` 目录包含在发布包中
-2. **`.npmignore` 配置**: 确认不需要的文件被排除
-3. **发布权限**: 确保你有 npm 包的发布权限
-4. **npm 登录**: 发布前确保已登录 `npm login`
-5. **双因素认证**: 如果启用了 2FA,准备好认证码
-## 常见问题
-### 发布失败: 权限不足
-```bash
-# 检查登录状态
-npm whoami
-# 重新登录
-npm login
-```
-### 构建产物不存在
-```bash
-# 确保构建成功
-npm run build
-# 检查 .npmignore 是否错误排除了构建产物
-cat .npmignore
-```
-### 版本已存在
-```bash
-# 无法覆盖已发布的版本,需要更新版本号
-npm version patch
-```
-## 相关链接
-- [npm 发布文档](https://docs.npmjs.com/cli/v10/commands/npm-publish)
-- [语义化版本规范](https://semver.org/lang/zh-CN/)
-- [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)

package/README.en.md DELETED Viewed

@@ -1,282 +0,0 @@
-# expo-gaode-map
-English | [简体中文](./README.md)
-A full-featured AMap (Gaode Map) React Native component library, **built with Expo Modules**, providing map display, location, overlays, and more:
-- Android: [AMap Android SDK](https://lbs.amap.com/api/android-sdk/summary)
-- iOS: [AMap iOS SDK](https://lbs.amap.com/api/ios-sdk/summary)
-> 💡 This component is built with [Expo Modules API](https://docs.expo.dev/modules/overview/), providing type-safe native module interfaces and excellent developer experience.
-## ✨ Features
-- ✅ Complete map functionality (multiple map types, gesture control, camera operations)
-- ✅ Accurate location (continuous location, single location, coordinate conversion)
-- ✅ Rich overlays (Circle, Marker, Polyline, Polygon)
-- ✅ Complete TypeScript type definitions (zero any types)
-- ✅ Modular architecture design
-- ✅ Support both declarative components and imperative API
-- ✅ Cross-platform support (Android, iOS)
-- ✅ Support custom styles and event listeners
-- ✅ Support both React Native architectures (Paper & Fabric)
-## 📦 Installation
-### Stable Version (Recommended)
-```bash
-npm install expo-gaode-map
-# or
-yarn add expo-gaode-map
-# or
-pnpm add expo-gaode-map
-```
-### Expo Projects
-If you're using an Expo managed project (using `expo prebuild` or development builds), you need to rebuild native code after installation:
-```bash
-# Using EAS Build
-eas build --platform android
-# Or using local build
-npx expo prebuild
-npx expo run:android
-```
-### Pure React Native Projects
-For pure React Native projects (created with `react-native init`), ensure `expo` package is installed as a dependency:
-```bash
-npm install expo
-# Then rebuild the app
-npx react-native run-android
-```
-## 🚀 Quick Start
-### 1. Get AMap API Key
-Visit [AMap Open Platform](https://lbs.amap.com/) to register and create an application to get API Key.
-> ⚠️ **Important: Native Configuration and Permissions**
->
-> AMap SDK requires configuration in native projects:
->
-> **Android Required Configuration:**
-> 1. Configure API Key in `AndroidManifest.xml`
-> 2. Add required permissions (network, location, etc.)
-> 3. Configure privacy compliance (required)
->
-> **iOS Required Configuration:**
-> 1. Configure API Key in `Info.plist`
-> 2. Add location permission descriptions (NSLocationWhenInUseUsageDescription, etc.)
-> 3. Configure privacy compliance (required)
->
-> **Detailed Configuration Guides:**
-> - **Android**: [AMap Android SDK Configuration Guide](https://lbs.amap.com/api/android-sdk/guide/create-project/android-studio-create-project)
-> - **iOS**: [AMap iOS SDK Configuration Guide](https://lbs.amap.com/api/ios-sdk/guide/create-project/cocoapods)
->
-> For Expo projects, use `npx expo prebuild` to generate native code before configuration.
-### 2. Initialization and Permission Management
-**Recommended initialization process**:
-```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. Initialize SDK
-      ExpoGaodeMapModule.initSDK({
-        androidKey: 'your-android-api-key',
-        iosKey: 'your-ios-api-key',
-      });
-      // 2. Check and request permission
-      const status = await ExpoGaodeMapModule.checkLocationPermission();
-      if (!status.granted) {
-        await ExpoGaodeMapModule.requestLocationPermission();
-      }
-      // 3. Get location and set map
-      try {
-        const location = await ExpoGaodeMapModule.getCurrentLocation();
-        setInitialPosition({
-          target: { latitude: location.latitude, longitude: location.longitude },
-          zoom: 15
-        });
-      } catch (error) {
-        // Use default location
-        setInitialPosition({
-          target: { latitude: 39.9, longitude: 116.4 },
-          zoom: 10
-        });
-      }
-    };
-    initialize();
-  }, []);
-  if (!initialPosition) return null;
-  return (
-    <MapView
-      style={{ flex: 1 }}
-      initialCameraPosition={initialPosition}
-      myLocationEnabled={true}
-    />
-  );
-}
-```
-> 📖 **Detailed Initialization Guide**: [INITIALIZATION.en.md](docs/INITIALIZATION.en.md)
->
-> Includes complete permission handling, error handling, and best practices.
-### 3. Basic Map Usage
-```tsx
-import { MapView } from 'expo-gaode-map';
-export default function MapScreen() {
-  return (
-    <MapView
-      style={{ flex: 1 }}
-      initialCameraPosition={{
-        target: { latitude: 39.9, longitude: 116.4 },
-        zoom: 10,
-      }}
-      myLocationEnabled={true}
-      onLoad={() => console.log('Map loaded')}
-    />
-  );
-}
-```
-## 📚 Feature Overview
-### 🗺️ Map Display
-- Multiple map types (normal, satellite, night, etc.)
-- Camera control (move, zoom, rotate, tilt)
-- Gesture control and UI control configuration
-- Zoom level limits
-### 📍 Location Features
-- Continuous and single location
-- Reverse geocoding (address resolution)
-- Location configuration (accuracy, interval, mode, etc.)
-- Custom location blue dot style
-### 🎨 Overlays
-- Circle
-- Marker
-- Polyline
-- Polygon
-- Support both declarative and imperative usage
-### 📝 More Examples
-For detailed usage examples, see: [EXAMPLES.en.md](docs/EXAMPLES.en.md)
-Includes:
-- Basic map application
-- Location tracking application
-- Overlay operation examples
-- Advanced usage and best practices
-## 📝 Documentation
-- [API Documentation](docs/API.en.md) - Complete API reference
-- [Usage Examples](docs/EXAMPLES.en.md) - Detailed code examples
-- [Initialization Guide](docs/INITIALIZATION.en.md) - SDK initialization and permission management
-- [Architecture Documentation](docs/ARCHITECTURE.en.md) - Project structure and file
-## 🎨 Advanced Usage
-### followUserLocation Explained
-`followUserLocation` controls whether the map automatically follows user location:
-**Browse Mode (default - `false`):**
-```tsx
-<MapView
-  myLocationEnabled={true}
-  followUserLocation={false}  // or omit
-/>
-```
-- ✅ Show location dot
-- ✅ User can freely scroll map
-- ✅ Map won't auto-move
-**Navigation Mode (`true`):**
-```tsx
-<MapView
-  myLocationEnabled={true}
-  followUserLocation={true}
-/>
-```
-- ✅ Show location dot
-- ✅ Map auto-follows user movement
-- ⚠️ Suitable for navigation scenarios
-### Color Format
-Overlay colors support two formats:
-1. **String format** (ARGB): `"#AARRGGBB"`
-   ```tsx
-   <Circle fillColor="#8800FF00" />  // 50% transparent green
-   ```
-   ```
-### Performance Optimization
-- ✅ Use imperative API for large numbers of overlays
-- ✅ Remove unnecessary overlays promptly
-- ✅ Avoid complex operations in high-frequency events like `onPress`
-- ✅ Don't set location interval too small (recommend >= 1000ms)
-## 🤝 Contributing
-Issues and Pull Requests are welcome!
-## 📄 License
-MIT
-## 🔗 Related Links
-- [AMap Open Platform](https://lbs.amap.com/)
-- [AMap Android SDK](https://lbs.amap.com/api/android-sdk/summary)
-- [Expo Modules API](https://docs.expo.dev/modules/overview/)
-- [GitHub Repository](https://github.com/TomWq/expo-gaode-map)
-## 🙏 Acknowledgments
-This project referenced the following excellent projects during development:
-- **[react-native-amap3d](https://github.com/qiuxiang/react-native-amap3d)** - An excellent React Native AMap component that provided important references for this project's design and implementation
-Thanks to the contributors of these open-source projects for bringing valuable experience and code to the community.
-## 📮 Feedback and Support
-If you encounter problems or have suggestions:
-- 📝 Submit [GitHub Issue](https://github.com/TomWq/expo-gaode-map/issues)
-- 💬 Join [Discussions](https://github.com/TomWq/expo-gaode-map/discussions)
-- ⭐ Star the project to show support
-- 💬 Join QQ Group: 952241387

package/RELEASE_CHECKLIST.md DELETED Viewed

@@ -1,146 +0,0 @@
-# 🚀 发布检查清单
-快速参考 - 发布新版本时需要执行的命令
-## 📋 发布前检查
-```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/packages/core/android/build/.transforms/79e5f1504f216bdae2079192244b6add/results.bin DELETED Viewed

	@@ -1 +0,0 @@
1	- o/bundleLibRuntimeToDirDebug

package/packages/core/android/build/.transforms/79e5f1504f216bdae2079192244b6add/transformed/bundleLibRuntimeToDirDebug/bundleLibRuntimeToDirDebug_dex/expo/modules/gaodemap/BuildConfig.dex DELETED Viewed

Binary file