expo-gaode-map 2.0.0 → 2.1.0-beta.0

package/plugin/build/withGaodeMap.js

@@ -13,17 +13,19 @@ const withGaodeMapInfoPlist = (config, props) => {
         // 添加定位相关权限
         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');
+            // 后台定位权限（可选）
+            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;
@@ -59,23 +61,20 @@ const withGaodeMapAppDelegate = (config, props) => {
 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',
+        // 基础权限（库中已包含，这里不重复添加）
+        // INTERNET, ACCESS_NETWORK_STATE, ACCESS_WIFI_STATE
+        // ACCESS_COARSE_LOCATION, ACCESS_FINE_LOCATION
+        // 后台定位权限（可选）
+        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'] = [];
             }
-            permissions.forEach((permission) => {
+            backgroundPermissions.forEach((permission) => {
                 const hasPermission = androidManifest['uses-permission']?.some((item) => item.$?.['android:name'] === permission);
                 if (!hasPermission) {
                     androidManifest['uses-permission']?.push({
@@ -84,8 +83,26 @@ const withGaodeMapAndroidManifest = (config, props) => {
                 }
             });
         }
-        // 添加 API Key 到 application 标签
+        // 添加前台服务（如果启用后台定位）
         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'] = [];
@@ -115,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/src/index.ts

@@ -1,3 +1,4 @@
+
 // 导出类型定义
 export * from './ExpoGaodeMap.types';
 export * from './types';
@@ -23,5 +24,14 @@ export {
   Cluster,
 } from './components/overlays';
 
+// 导出模块检测工具
+export {
+  requireModule,
+  OptionalModules,
+  getInstalledModules,
+  printModuleInfo,
+  createLazyLoader,
+} from './utils/ModuleLoader';
+
 // 默认导出原生模块
 export { default } from './ExpoGaodeMapModule';

package/src/utils/ModuleLoader.ts

@@ -0,0 +1,115 @@
+/**
+ * 模块检测器 - 用于检测可选模块是否已安装
+ */
+
+/**
+ * 可选模块名称常量
+ */
+export const OptionalModules = {
+  SEARCH: '@expo-gaode-map/search',
+  NAVIGATION: '@expo-gaode-map/navigation',
+  ROUTE: '@expo-gaode-map/route',
+  GEOCODER: '@expo-gaode-map/geocoder',
+} as const;
+
+/**
+ * 延迟加载可选模块
+ * 使用示例:
+ * 
+ * @example
+ * ```typescript
+ * import { OptionalModules, lazyLoad } from 'expo-gaode-map';
+ * 
+ * let SearchModule = null;
+ * 
+ * function loadSearch() {
+ *   if (SearchModule == null) {
+ *     try {
+ *       SearchModule = require('expo-gaode-map-search');
+ *     } catch (error) {
+ *       console.warn('搜索模块未安装');
+ *       return null;
+ *     }
+ *   }
+ *   return SearchModule;
+ * }
+ * 
+ * // 使用
+ * const search = loadSearch();
+ * if (search) {
+ *   const results = await search.searchPOI({ keyword: '餐厅' });
+ * }
+ * ```
+ */
+
+/**
+ * 检查必需模块,如果未安装则抛出错误
+ * @param moduleName 模块名称
+ * @param featureName 功能名称(用于错误提示)
+ */
+export function requireModule(moduleName: string, featureName: string): void {
+  console.warn(
+    `[expo-gaode-map] 使用 ${featureName} 需要安装 ${moduleName}。\n` +
+    `请运行: npm install ${moduleName}\n` +
+    `然后使用 try-catch 包裹 require('${moduleName}') 来加载`
+  );
+}
+
+/**
+ * 获取已安装的可选模块列表
+ * 注意: 此函数无法在运行时准确检测,仅作为文档说明
+ */
+export function getInstalledModules(): string[] {
+  console.warn(
+    '[expo-gaode-map] getInstalledModules() 无法在运行时检测。\n' +
+    '请在编译时检查 package.json 中安装的模块'
+  );
+  return [];
+}
+
+/**
+ * 打印已安装模块信息(用于调试)
+ */
+export function printModuleInfo(): void {
+  console.log('[expo-gaode-map] 核心模块: 已加载');
+  console.log('[expo-gaode-map] 可选模块检测:');
+  console.log('  - 使用 try-catch 包裹 require() 来检测可选模块');
+  console.log('  - 可用的可选模块:');
+  Object.entries(OptionalModules).forEach(([key, value]) => {
+    console.log(`    - ${key}: ${value}`);
+  });
+}
+
+/**
+ * 创建延迟加载器
+ * 
+ * @example
+ * ```typescript
+ * import { createLazyLoader } from 'expo-gaode-map';
+ * 
+ * const loadSearch = createLazyLoader(() => require('expo-gaode-map-search'));
+ * 
+ * // 使用时
+ * const SearchModule = loadSearch();
+ * if (SearchModule) {
+ *   const results = await SearchModule.searchPOI({ keyword: '餐厅' });
+ * }
+ * ```
+ */
+export function createLazyLoader<T>(loader: () => T): () => T | null {
+  let cached: T | null = null;
+  let attempted = false;
+
+  return () => {
+    if (!attempted) {
+      attempted = true;
+      try {
+        cached = loader();
+      } catch (error) {
+        console.warn('[expo-gaode-map] 模块加载失败:', error);
+        cached = null;
+      }
+    }
+    return cached;
+  };
+}

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

package/ExpoSmartrefreshlayoutModule.swift

@@ -1,119 +0,0 @@
-import ExpoModulesCore
-
-public class ExpoSmartrefreshlayoutModule: Module {
-    public func definition() -> ModuleDefinition {
-        // 模块名称
-        Name("ExpoSmartrefreshlayout")
-        
-        // 定义事件
-        Events(
-            "onRefresh",
-            "onLoadMore",
-            "onStateChanged",
-            "onHeaderMoving",
-            "onFooterMoving"
-        )
-        
-        // 注册 View 组件
-        View(ExpoSmartrefreshlayoutView.self) {
-            
-            // ------------------- Events -------------------
-            Events(
-                "onRefresh",
-                "onLoadMore",
-                "onStateChanged",
-                "onHeaderMoving",
-                "onFooterMoving"
-            )
-            
-            // ------------------- Props -------------------
-            
-            // 基础配置
-            Prop("enableRefresh") { (view: ExpoSmartrefreshlayoutView, value: Bool) in
-                view.setEnableRefresh(value)
-            }
-            
-            Prop("enableLoadMore") { (view: ExpoSmartrefreshlayoutView, value: Bool) in
-                view.setEnableLoadMore(value)
-            }
-            
-            Prop("enableAutoLoadMore") { (view: ExpoSmartrefreshlayoutView, value: Bool) in
-                view.setEnableAutoLoadMore(value)
-            }
-            
-            // Header 类型
-            Prop("headerType") { (view: ExpoSmartrefreshlayoutView, value: String) in
-                view.setHeaderType(value)
-            }
-            
-            // 经典样式配置
-            Prop("classicRefreshHeaderProps") { (view: ExpoSmartrefreshlayoutView, value: [String: Any]) in
-                view.setClassicRefreshHeaderProps(value)
-            }
-            
-            Prop("classicLoadMoreFooterProps") { (view: ExpoSmartrefreshlayoutView, value: [String: Any]) in
-                view.setClassicLoadMoreFooterProps(value)
-            }
-            
-            // 自定义 Header 标志
-            Prop("hasCustomHeader") { (view: ExpoSmartrefreshlayoutView, value: Bool) in
-                view.setHasCustomHeader(value)
-            }
-            
-            // 触觉反馈
-            Prop("enableHapticFeedback") { (view: ExpoSmartrefreshlayoutView, value: Bool) in
-                view.setEnableHapticFeedback(value)
-            }
-        }
-        
-        // ------------------- Commands/Functions -------------------
-        
-        /**
-         * 完成刷新操作
-         * @param view 视图实例
-         * @param success 是否刷新成功
-         * @param delay 延迟时间（毫秒）
-         */
-        Function("finishRefresh") { (view: ExpoSmartrefreshlayoutView, success: Bool, delay: Int) in
-            view.finishRefresh(success: success, delay: delay)
-        }
-        
-        /**
-         * 完成加载更多操作
-         * @param view 视图实例
-         * @param success 是否加载成功
-         * @param delay 延迟时间（毫秒）
-         * @param noMoreData 是否没有更多数据
-         */
-        Function("finishLoadMore") { (view: ExpoSmartrefreshlayoutView, success: Bool, delay: Int, noMoreData: Bool) in
-            view.finishLoadMore(success: success, delay: delay, noMoreData: noMoreData)
-        }
-        
-        /**
-         * 自动刷新
-         * @param view 视图实例
-         * @param delay 延迟时间（毫秒）
-         */
-        Function("autoRefresh") { (view: ExpoSmartrefreshlayoutView, delay: Int) in
-            view.autoRefresh(delay: delay)
-        }
-        
-        /**
-         * 自动加载更多
-         * @param view 视图实例
-         * @param delay 延迟时间（毫秒）
-         */
-        Function("autoLoadMore") { (view: ExpoSmartrefreshlayoutView, delay: Int) in
-            view.autoLoadMore(delay: delay)
-        }
-        
-        /**
-         * 设置是否没有更多数据
-         * @param view 视图实例
-         * @param noMore 是否没有更多数据
-         */
-        Function("setNoMoreData") { (view: ExpoSmartrefreshlayoutView, noMore: Bool) in
-            view.setNoMoreData(noMore: noMore)
-        }
-    }
-}