expo-gaode-map-navigation 1.1.5 → 1.1.6

package/android/src/main/java/expo/modules/gaodemap/map/utils/PermissionHelper.kt

@@ -0,0 +1,248 @@
+package expo.modules.gaodemap.map.utils
+
+import android.Manifest
+import android.app.Activity
+import android.content.Context
+import android.content.Intent
+import android.content.pm.PackageManager
+import android.net.Uri
+import android.os.Build
+import android.provider.Settings
+import androidx.core.app.ActivityCompat
+import androidx.core.content.ContextCompat
+
+/**
+ * Android 14+ 权限适配助手
+ * 
+ * 主要变化：
+ * 1. Android 14 (API 34) 引入了更精细的位置权限
+ * 2. 需要同时请求前台和后台位置权限
+ * 3. 权限请求流程更加严格
+ */
+object PermissionHelper {
+    
+    /**
+     * 位置权限类型
+     */
+    enum class LocationPermissionType {
+        FOREGROUND,      // 仅前台位置
+        BACKGROUND,      // 后台位置
+        FOREGROUND_AND_BACKGROUND  // 前台+后台
+    }
+    
+    /**
+     * 权限状态
+     */
+    data class PermissionStatus(
+        val granted: Boolean,
+        val shouldShowRationale: Boolean,
+        val isPermanentlyDenied: Boolean,
+        val fineLocation: Boolean = false,
+        val coarseLocation: Boolean = false,
+        val backgroundLocation: Boolean = false
+
+    )
+    
+    /**
+     * 检查是否为 Android 14+
+     */
+    fun isAndroid14Plus(): Boolean {
+        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE // API 34
+    }
+    
+    /**
+     * 检查是否为 Android 10+（引入后台位置权限）
+     */
+    fun isAndroid10Plus(): Boolean {
+        return Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q // API 29
+    }
+    
+    /**
+     * 获取需要请求的前台位置权限列表
+     */
+    fun getForegroundLocationPermissions(): Array<String> {
+        return arrayOf(
+            Manifest.permission.ACCESS_FINE_LOCATION,
+            Manifest.permission.ACCESS_COARSE_LOCATION
+        )
+    }
+    
+    /**
+     * 获取后台位置权限
+     */
+    fun getBackgroundLocationPermission(): String? {
+        return if (isAndroid10Plus()) {
+            Manifest.permission.ACCESS_BACKGROUND_LOCATION
+        } else {
+            null
+        }
+    }
+    
+    /**
+     * 检查前台位置权限状态
+     */
+    fun checkForegroundLocationPermission(context: Context): PermissionStatus {
+        val fineGranted = ContextCompat.checkSelfPermission(
+            context,
+            Manifest.permission.ACCESS_FINE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED
+        
+        val coarseGranted = ContextCompat.checkSelfPermission(
+            context,
+            Manifest.permission.ACCESS_COARSE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED
+        
+        val granted = fineGranted && coarseGranted
+        
+        val activity = context as? Activity
+        val shouldShowRationale = if (activity != null && !granted) {
+            ActivityCompat.shouldShowRequestPermissionRationale(
+                activity,
+                Manifest.permission.ACCESS_FINE_LOCATION
+            )
+        } else {
+            false
+        }
+        
+        return PermissionStatus(
+            granted = granted,
+            shouldShowRationale = shouldShowRationale,
+            isPermanentlyDenied = !granted && !shouldShowRationale && activity != null,
+            fineLocation = fineGranted,
+            coarseLocation = coarseGranted
+        )
+    }
+    
+    /**
+     * 检查后台位置权限状态
+     */
+    fun checkBackgroundLocationPermission(context: Context): PermissionStatus {
+        val permission = getBackgroundLocationPermission()
+        if (permission == null) {
+            // Android 10 以下不支持后台位置权限
+            return PermissionStatus(
+                granted = true,
+                shouldShowRationale = false,
+                isPermanentlyDenied = false,
+                backgroundLocation = true
+            )
+        }
+        
+        val granted = ContextCompat.checkSelfPermission(
+            context,
+            permission
+        ) == PackageManager.PERMISSION_GRANTED
+        
+        val activity = context as? Activity
+        val shouldShowRationale = if (activity != null && !granted) {
+            ActivityCompat.shouldShowRequestPermissionRationale(activity, permission)
+        } else {
+            false
+        }
+        
+        return PermissionStatus(
+            granted = granted,
+            shouldShowRationale = shouldShowRationale,
+            isPermanentlyDenied = !granted && !shouldShowRationale && activity != null,
+            backgroundLocation = granted
+        )
+    }
+    
+    /**
+     * 检查完整位置权限状态（前台+后台）
+     */
+    fun checkFullLocationPermission(context: Context): PermissionStatus {
+        val foreground = checkForegroundLocationPermission(context)
+        val background = checkBackgroundLocationPermission(context)
+        
+        return PermissionStatus(
+            granted = foreground.granted && background.granted,
+            shouldShowRationale = foreground.shouldShowRationale || background.shouldShowRationale,
+            isPermanentlyDenied = foreground.isPermanentlyDenied || background.isPermanentlyDenied,
+            fineLocation = foreground.fineLocation,
+            coarseLocation = foreground.coarseLocation,
+            backgroundLocation = background.backgroundLocation
+        )
+    }
+    
+    /**
+     * 请求前台位置权限
+     * Android 14+ 推荐的请求流程
+     */
+    fun requestForegroundLocationPermission(activity: Activity, requestCode: Int) {
+        val permissions = getForegroundLocationPermissions()
+        ActivityCompat.requestPermissions(activity, permissions, requestCode)
+    }
+    
+    /**
+     * 请求后台位置权限
+     * 注意：必须在前台权限已授予后才能请求
+     */
+    fun requestBackgroundLocationPermission(activity: Activity, requestCode: Int): Boolean {
+        val permission = getBackgroundLocationPermission()
+        if (permission == null) {
+            return false
+        }
+        
+        // 检查前台权限是否已授予
+        val foregroundStatus = checkForegroundLocationPermission(activity)
+        if (!foregroundStatus.granted) {
+            return false
+        }
+        
+        ActivityCompat.requestPermissions(activity, arrayOf(permission), requestCode)
+        return true
+    }
+    
+    /**
+     * 打开应用设置页面
+     * 用于引导用户手动授予权限
+     */
+    fun openAppSettings(context: Context) {
+        val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
+            data = Uri.fromParts("package", context.packageName, null)
+            flags = Intent.FLAG_ACTIVITY_NEW_TASK
+        }
+        context.startActivity(intent)
+    }
+    
+    /**
+     * 获取权限请求的推荐提示文案（Android 14+ 优化）
+     */
+    fun getPermissionRationale(
+        type: LocationPermissionType,
+        isAndroid14: Boolean = isAndroid14Plus()
+    ): String {
+        return when (type) {
+            LocationPermissionType.FOREGROUND -> {
+                if (isAndroid14) {
+                    "为了在地图上显示您的位置，应用需要访问您的位置信息。\n\n" +
+                    "您可以选择：\n" +
+                    "• 仅在使用应用时允许\n" +
+                    "• 每次询问\n\n" +
+                    "我们不会在后台收集您的位置数据。"
+                } else {
+                    "为了在地图上显示您的位置，应用需要访问您的位置信息。"
+                }
+            }
+            LocationPermissionType.BACKGROUND -> {
+                if (isAndroid14) {
+                    "为了在后台更新您的位置（如导航、轨迹记录），应用需要始终访问位置权限。\n\n" +
+                    "您可以随时在设置中更改此权限。"
+                } else {
+                    "为了在后台更新您的位置，应用需要始终访问位置权限。"
+                }
+            }
+            LocationPermissionType.FOREGROUND_AND_BACKGROUND -> {
+                if (isAndroid14) {
+                    "应用需要位置权限来提供以下功能：\n" +
+                    "• 在地图上显示您的位置（前台）\n" +
+                    "• 后台导航和轨迹记录（后台）\n\n" +
+                    "我们会先请求前台权限，然后再请求后台权限。"
+                } else {
+                    "应用需要位置权限来显示地图位置和后台导航功能。"
+                }
+            }
+        }
+    }
+}

package/build/ExpoGaodeMapNaviView.d.ts

@@ -1,9 +1,9 @@
 import * as React from 'react';
-import type { Coordinates, NaviViewProps } from './types';
+import type { Coordinates, ExpoGaodeMapNaviViewProps } from './types';
 /**
- * NaviView Ref 类型
+ * ExpoGaodeMapNaviView Ref 类型
  */
-export interface NaviViewRef {
+export interface ExpoGaodeMapNaviViewRef {
     /**
      * 开始导航
      */
@@ -26,11 +26,11 @@ export interface NaviViewRef {
  *
  * @example
  * ```tsx
- * import { NaviView } from 'expo-gaode-map-navigation';
+ * import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';
  *
  * function NavigationScreen() {
  *   return (
- *     <NaviView
+ *     <ExpoGaodeMapNaviView
  *       style={{ flex: 1 }}
  *       naviType={0} // GPS 导航
  *       showCamera={true}
@@ -46,5 +46,5 @@ export interface NaviViewRef {
  * }
  * ```
  */
-export declare const NaviView: React.ForwardRefExoticComponent<NaviViewProps & React.RefAttributes<NaviViewRef>>;
-export default NaviView;
+export declare const ExpoGaodeMapNaviView: React.ForwardRefExoticComponent<ExpoGaodeMapNaviViewProps & React.RefAttributes<ExpoGaodeMapNaviViewRef>>;
+export default ExpoGaodeMapNaviView;

package/build/ExpoGaodeMapNaviView.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NaviView = void 0;
+exports.ExpoGaodeMapNaviView = void 0;
 const expo_modules_core_1 = require("expo-modules-core");
 const React = __importStar(require("react"));
 const NativeView = (0, expo_modules_core_1.requireNativeViewManager)('ExpoGaodeMapNaviView');
@@ -50,11 +50,11 @@ const NativeView = (0, expo_modules_core_1.requireNativeViewManager)('ExpoGaodeM
  *
  * @example
  * ```tsx
- * import { NaviView } from 'expo-gaode-map-navigation';
+ * import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';
  *
  * function NavigationScreen() {
  *   return (
- *     <NaviView
+ *     <ExpoGaodeMapNaviView
  *       style={{ flex: 1 }}
  *       naviType={0} // GPS 导航
  *       showCamera={true}
@@ -70,24 +70,23 @@ const NativeView = (0, expo_modules_core_1.requireNativeViewManager)('ExpoGaodeM
  * }
  * ```
  */
-exports.NaviView = React.forwardRef((props, ref) => {
+exports.ExpoGaodeMapNaviView = React.forwardRef((props, ref) => {
     const nativeRef = React.useRef(null);
     // 创建 API 引用
     const apiRef = React.useMemo(() => ({
         startNavigation: async (start, end, type) => {
-            var _a, _b;
             if (!nativeRef.current)
-                throw new Error('NaviView not initialized');
+                throw new Error('ExpoGaodeMapNaviView not initialized');
             // 将对象解构为单独的参数传递给原生层
-            const startLat = (_a = start === null || start === void 0 ? void 0 : start.latitude) !== null && _a !== void 0 ? _a : 0;
-            const startLng = (_b = start === null || start === void 0 ? void 0 : start.longitude) !== null && _b !== void 0 ? _b : 0;
+            const startLat = start?.latitude ?? 0;
+            const startLng = start?.longitude ?? 0;
             const endLat = end.latitude;
             const endLng = end.longitude;
             return nativeRef.current.startNavigation(startLat, startLng, endLat, endLng);
         },
         stopNavigation: async () => {
             if (!nativeRef.current)
-                throw new Error('NaviView not initialized');
+                throw new Error('ExpoGaodeMapNaviView not initialized');
             return nativeRef.current.stopNavigation();
         },
     }), []);
@@ -95,5 +94,5 @@ exports.NaviView = React.forwardRef((props, ref) => {
     React.useImperativeHandle(ref, () => apiRef, [apiRef]);
     return <NativeView ref={nativeRef} {...props}/>;
 });
-exports.NaviView.displayName = 'NaviView';
-exports.default = exports.NaviView;
+exports.ExpoGaodeMapNaviView.displayName = 'ExpoGaodeMapNaviView';
+exports.default = exports.ExpoGaodeMapNaviView;

package/build/ExpoGaodeMapNavigationModule.d.ts

@@ -1,7 +1,8 @@
+import { ExpoGaodeMapNavigationModule as ExpoGaodeMapNavigationModuleType } from './types/native-module.types';
 /**
  * 高德地图导航模块
  *
  * 提供路径规划功能，包括驾车、步行、骑行、公交、货车等多种出行方式
  */
-declare const ExpoGaodeMapNavigationModule: any;
+declare const ExpoGaodeMapNavigationModule: ExpoGaodeMapNavigationModuleType;
 export default ExpoGaodeMapNavigationModule;

package/build/index.d.ts

@@ -1,16 +1,17 @@
+import ExpoGaodeMapNavigationModule from './ExpoGaodeMapNavigationModule';
 export * from './map';
 import { RouteType, DriveStrategy, WalkStrategy, RideStrategy, TruckSize, TravelStrategy } from './types';
 import type { NaviPoint, RouteOptions, DriveRouteOptions, WalkRouteOptions, RideRouteOptions, EBikeRouteOptions, TruckRouteOptions, RouteResult, DriveRouteResult, IndependentRouteResult, IndependentDriveRouteOptions, IndependentTruckRouteOptions, IndependentWalkRouteOptions, IndependentRideRouteOptions, SelectIndependentRouteOptions, StartNaviWithIndependentPathOptions, ClearIndependentRouteOptions, MotorcycleRouteOptions, IndependentMotorcycleRouteOptions } from './types';
-export { NaviView, type NaviViewRef } from './ExpoGaodeMapNaviView';
+export { ExpoGaodeMapNaviView, type ExpoGaodeMapNaviViewRef, ExpoGaodeMapNaviView as NaviView, type ExpoGaodeMapNaviViewRef as NaviViewRef } from './ExpoGaodeMapNaviView';
 /**
  * 初始化导航模块（可选）
  */
-export declare function initNavigation(): void;
+export declare const initNavigation: () => void;
 /**
  * 销毁所有路径计算器实例
  * 用于页面切换时释放资源，避免"Another route calculation is in progress"错误
  */
-export declare function destroyAllCalculators(): void;
+export declare const destroyAllCalculators: () => void;
 /**
  * 路径规划（通用方法）
  * 注意：公交路径规划暂未实现
@@ -19,69 +20,70 @@ export declare function calculateRoute(options: RouteOptions): Promise<RouteResu
 /**
  * 驾车路径规划
  */
-export declare function calculateDriveRoute(options: DriveRouteOptions): Promise<DriveRouteResult>;
+export declare const calculateDriveRoute: (options: DriveRouteOptions) => Promise<DriveRouteResult>;
 /**
  * 步行路径规划
  */
-export declare function calculateWalkRoute(options: WalkRouteOptions): Promise<RouteResult>;
+export declare const calculateWalkRoute: (options: WalkRouteOptions) => Promise<RouteResult>;
 /**
  * 骑行路径规划
  */
-export declare function calculateRideRoute(options: RideRouteOptions): Promise<RouteResult>;
+export declare const calculateRideRoute: (options: RideRouteOptions) => Promise<RouteResult>;
 /**
  * 骑行电动车路径规划
  */
-export declare function calculateEBikeRoute(options: EBikeRouteOptions): Promise<RouteResult>;
+export declare const calculateEBikeRoute: (options: EBikeRouteOptions) => Promise<RouteResult>;
 /**
  * 货车路径规划
  */
-export declare function calculateTruckRoute(options: TruckRouteOptions): Promise<DriveRouteResult>;
+export declare const calculateTruckRoute: (options: TruckRouteOptions) => Promise<DriveRouteResult>;
 /**
  * 摩托车路径规划（车类型为 11，支持传入排量）
  */
-export declare function calculateMotorcycleRoute(options: MotorcycleRouteOptions): Promise<DriveRouteResult>;
+export declare const calculateMotorcycleRoute: (options: MotorcycleRouteOptions) => Promise<DriveRouteResult>;
 /**
 * 独立路径规划（不会影响当前导航；适合路线预览/行前选路）
 */
-export declare function independentDriveRoute(options: IndependentDriveRouteOptions): Promise<IndependentRouteResult>;
-export declare function independentTruckRoute(options: IndependentTruckRouteOptions): Promise<IndependentRouteResult>;
-export declare function independentWalkRoute(options: IndependentWalkRouteOptions): Promise<IndependentRouteResult>;
-export declare function independentRideRoute(options: IndependentRideRouteOptions): Promise<IndependentRouteResult>;
+export declare const independentDriveRoute: (options: IndependentDriveRouteOptions) => Promise<IndependentRouteResult>;
+export declare const independentTruckRoute: (options: IndependentTruckRouteOptions) => Promise<IndependentRouteResult>;
+export declare const independentWalkRoute: (options: IndependentWalkRouteOptions) => Promise<IndependentRouteResult>;
+export declare const independentRideRoute: (options: IndependentRideRouteOptions) => Promise<IndependentRouteResult>;
 /**
  * 独立摩托车路径规划（不干扰当前导航）
  */
-export declare function independentMotorcycleRoute(options: IndependentMotorcycleRouteOptions): Promise<IndependentRouteResult>;
+export declare const independentMotorcycleRoute: (options: IndependentMotorcycleRouteOptions) => Promise<IndependentRouteResult>;
 /**
  * 独立路径组：选主路线
  */
-export declare function selectIndependentRoute(options: SelectIndependentRouteOptions): Promise<boolean>;
+export declare const selectIndependentRoute: (options: SelectIndependentRouteOptions) => Promise<boolean>;
 /**
  * 独立路径组：使用指定路线启动导航
  */
-export declare function startNaviWithIndependentPath(options: StartNaviWithIndependentPathOptions): Promise<boolean>;
+export declare const startNaviWithIndependentPath: (options: StartNaviWithIndependentPathOptions) => Promise<boolean>;
 /**
  * 独立路径组：清理
  */
-export declare function clearIndependentRoute(options: ClearIndependentRouteOptions): Promise<boolean>;
+export declare const clearIndependentRoute: (options: ClearIndependentRouteOptions) => Promise<boolean>;
 export type { NaviPoint, RouteOptions, DriveRouteOptions, WalkRouteOptions, RideRouteOptions, EBikeRouteOptions, TruckRouteOptions, RouteResult, DriveRouteResult, IndependentRouteResult, IndependentDriveRouteOptions, IndependentTruckRouteOptions, IndependentWalkRouteOptions, IndependentRideRouteOptions, SelectIndependentRouteOptions, StartNaviWithIndependentPathOptions, ClearIndependentRouteOptions, MotorcycleRouteOptions, IndependentMotorcycleRouteOptions, };
 export { RouteType, DriveStrategy, WalkStrategy, RideStrategy, TruckSize, TravelStrategy, };
 declare const _default: {
-    initNavigation: typeof initNavigation;
-    destroyAllCalculators: typeof destroyAllCalculators;
+    initNavigation: () => void;
+    destroyAllCalculators: () => void;
     calculateRoute: typeof calculateRoute;
-    calculateDriveRoute: typeof calculateDriveRoute;
-    calculateWalkRoute: typeof calculateWalkRoute;
-    calculateRideRoute: typeof calculateRideRoute;
-    calculateEBikeRoute: typeof calculateEBikeRoute;
-    calculateTruckRoute: typeof calculateTruckRoute;
-    calculateMotorcycleRoute: typeof calculateMotorcycleRoute;
-    independentDriveRoute: typeof independentDriveRoute;
-    independentTruckRoute: typeof independentTruckRoute;
-    independentWalkRoute: typeof independentWalkRoute;
-    independentRideRoute: typeof independentRideRoute;
-    independentMotorcycleRoute: typeof independentMotorcycleRoute;
-    selectIndependentRoute: typeof selectIndependentRoute;
-    startNaviWithIndependentPath: typeof startNaviWithIndependentPath;
-    clearIndependentRoute: typeof clearIndependentRoute;
+    calculateDriveRoute: (options: DriveRouteOptions) => Promise<DriveRouteResult>;
+    calculateWalkRoute: (options: WalkRouteOptions) => Promise<RouteResult>;
+    calculateRideRoute: (options: RideRouteOptions) => Promise<RouteResult>;
+    calculateEBikeRoute: (options: EBikeRouteOptions) => Promise<RouteResult>;
+    calculateTruckRoute: (options: TruckRouteOptions) => Promise<DriveRouteResult>;
+    calculateMotorcycleRoute: (options: MotorcycleRouteOptions) => Promise<DriveRouteResult>;
+    independentDriveRoute: (options: IndependentDriveRouteOptions) => Promise<IndependentRouteResult>;
+    independentTruckRoute: (options: IndependentTruckRouteOptions) => Promise<IndependentRouteResult>;
+    independentWalkRoute: (options: IndependentWalkRouteOptions) => Promise<IndependentRouteResult>;
+    independentRideRoute: (options: IndependentRideRouteOptions) => Promise<IndependentRouteResult>;
+    independentMotorcycleRoute: (options: IndependentMotorcycleRouteOptions) => Promise<IndependentRouteResult>;
+    selectIndependentRoute: (options: SelectIndependentRouteOptions) => Promise<boolean>;
+    startNaviWithIndependentPath: (options: StartNaviWithIndependentPathOptions) => Promise<boolean>;
+    clearIndependentRoute: (options: ClearIndependentRouteOptions) => Promise<boolean>;
 };
 export default _default;
+export { ExpoGaodeMapNavigationModule, };