expo-gaode-map-navigation 1.1.5-next.1 → 1.1.5-next.2

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,13 +70,13 @@ 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) => {
             if (!nativeRef.current)
-                throw new Error('NaviView not initialized');
+                throw new Error('ExpoGaodeMapNaviView not initialized');
             // 将对象解构为单独的参数传递给原生层
             const startLat = start?.latitude ?? 0;
             const startLng = start?.longitude ?? 0;
@@ -86,7 +86,7 @@ exports.NaviView = React.forwardRef((props, ref) => {
         },
         stopNavigation: async () => {
             if (!nativeRef.current)
-                throw new Error('NaviView not initialized');
+                throw new Error('ExpoGaodeMapNaviView not initialized');
             return nativeRef.current.stopNavigation();
         },
     }), []);
@@ -94,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/index.d.ts

@@ -1,7 +1,7 @@
 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 } from './ExpoGaodeMapNaviView';
 /**
  * 初始化导航模块（可选）
  */

package/build/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TravelStrategy = exports.TruckSize = exports.RideStrategy = exports.WalkStrategy = exports.DriveStrategy = exports.RouteType = exports.NaviView = void 0;
+exports.TravelStrategy = exports.TruckSize = exports.RideStrategy = exports.WalkStrategy = exports.DriveStrategy = exports.RouteType = exports.ExpoGaodeMapNaviView = void 0;
 exports.initNavigation = initNavigation;
 exports.destroyAllCalculators = destroyAllCalculators;
 exports.calculateRoute = calculateRoute;
@@ -47,7 +47,7 @@ Object.defineProperty(exports, "TruckSize", { enumerable: true, get: function ()
 Object.defineProperty(exports, "TravelStrategy", { enumerable: true, get: function () { return types_1.TravelStrategy; } });
 // 导出官方导航界面组件
 var ExpoGaodeMapNaviView_1 = require("./ExpoGaodeMapNaviView");
-Object.defineProperty(exports, "NaviView", { enumerable: true, get: function () { return ExpoGaodeMapNaviView_1.NaviView; } });
+Object.defineProperty(exports, "ExpoGaodeMapNaviView", { enumerable: true, get: function () { return ExpoGaodeMapNaviView_1.ExpoGaodeMapNaviView; } });
 /**
  * 初始化导航模块（可选）
  */

package/build/map/ExpoGaodeMapModule.d.ts

@@ -1,204 +1,5 @@
-/**
- * 高德地图原生模块
- * 提供 SDK 初始化、定位、权限管理等功能
- */
-import { NativeModule } from 'expo';
-import type { ExpoGaodeMapModuleEvents } from './ExpoGaodeMap.types';
-import type { LatLng, CoordinateType, Coordinates, ReGeocode, LocationMode, LocationAccuracy, LocationListener } from './types';
-/**
- * SDK 配置参数
- */
-export interface SDKConfig {
-    /** Android 平台的高德地图 API Key */
-    androidKey?: string;
-    /** iOS 平台的高德地图 API Key */
-    iosKey?: string;
-    /** web api key：若要使用 web-api 相关功能，建议在初始化时提供 */
-    webKey?: string;
-}
-/**
- * 权限状态
- */
-export interface PermissionStatus {
-    /** 是否已授权 */
-    granted: boolean;
-    /** iOS 权限状态字符串 */
-    status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';
-    /** Android 精确位置权限 */
-    fineLocation?: boolean;
-    /** Android 粗略位置权限 */
-    coarseLocation?: boolean;
-}
-/**
- * 高德地图原生模块类声明
- */
-declare class ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {
-    /**
-     * 更新隐私合规状态
-     * 必须在用户同意隐私协议后调用
-     * @param hasAgreed 用户是否已同意隐私协议
-     */
-    updatePrivacyCompliance(hasAgreed: boolean): void;
-    /**
-     * 初始化高德地图 SDK
-     * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key
-     */
-    initSDK(config: SDKConfig): void;
-    /**
-     * 获取高德地图 SDK 版本号
-     * @returns SDK 版本字符串
-     */
-    getVersion(): string;
-    /**
-     * 开始连续定位
-     * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调
-     */
-    start(): void;
-    /**
-     * 停止定位
-     * 停止接收位置更新
-     */
-    stop(): void;
-    /**
-     * 检查是否正在定位
-     * @returns Promise<boolean> 是否正在定位
-     */
-    isStarted(): Promise<boolean>;
-    /**
-     * 获取当前位置（单次定位）
-     * @returns Promise<Coordinates | ReGeocode> 位置信息，包含坐标和可选的逆地理编码信息
-     */
-    getCurrentLocation(): Promise<Coordinates | ReGeocode>;
-    /**
-     * 坐标转换
-     * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系
-     * @param coordinate 需要转换的坐标
-     * @param type 原坐标系类型
-     * @returns Promise<LatLng> 转换后的 GCJ-02 坐标
-     */
-    coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;
-    /**
-     * 设置是否返回逆地理编码信息
-     * @param isReGeocode true: 返回地址信息; false: 只返回坐标
-     */
-    setLocatingWithReGeocode(isReGeocode: boolean): void;
-    /**
-     * 设置定位模式（Android）
-     * @param mode 定位模式：0-低功耗, 1-仅设备, 2-高精度
-     */
-    setLocationMode(mode: LocationMode): void;
-    /**
-     * 设置定位间隔（毫秒）
-     * @param interval 定位间隔时间，单位毫秒，默认 2000ms
-     */
-    setInterval(interval: number): void;
-    /**
-     * 设置是否单次定位（Android）
-     * @param isOnceLocation true: 单次定位; false: 连续定位
-     */
-    setOnceLocation(isOnceLocation: boolean): void;
-    /**
-     * 设置是否使用设备传感器（Android）
-     * @param sensorEnable true: 使用传感器; false: 不使用
-     */
-    setSensorEnable(sensorEnable: boolean): void;
-    /**
-     * 设置是否允许 WiFi 扫描（Android）
-     * @param wifiScan true: 允许; false: 不允许
-     */
-    setWifiScan(wifiScan: boolean): void;
-    /**
-     * 设置是否 GPS 优先（Android）
-     * @param gpsFirst true: GPS 优先; false: 网络优先
-     */
-    setGpsFirst(gpsFirst: boolean): void;
-    /**
-     * 设置是否等待 WiFi 列表刷新（Android）
-     * @param onceLocationLatest true: 等待; false: 不等待
-     */
-    setOnceLocationLatest(onceLocationLatest: boolean): void;
-    /**
-     * 设置逆地理编码语言
-     * @param language 语言代码，如 "zh-CN", "en"
-     */
-    setGeoLanguage(language: string): void;
-    /**
-     * 设置是否使用缓存策略（Android）
-     * @param locationCacheEnable true: 使用缓存; false: 不使用
-     */
-    setLocationCacheEnable(locationCacheEnable: boolean): void;
-    /**
-     * 设置网络请求超时时间（Android）
-     * @param httpTimeOut 超时时间，单位毫秒
-     */
-    setHttpTimeOut(httpTimeOut: number): void;
-    /**
-     * 设置期望的定位精度（iOS）
-     * @param accuracy 精度级别：0-最佳, 1-10米, 2-100米, 3-1公里, 4-3公里
-     */
-    setDesiredAccuracy(accuracy: LocationAccuracy): void;
-    /**
-     * 设置定位超时时间（秒）
-     * @param timeout 超时时间，单位秒，默认 10 秒
-     */
-    setLocationTimeout(timeout: number): void;
-    /**
-     * 设置逆地理编码超时时间（秒）
-     * @param timeout 超时时间，单位秒，默认 5 秒
-     */
-    setReGeocodeTimeout(timeout: number): void;
-    /**
-     * 设置距离过滤器（米）（iOS）
-     * 只有移动超过指定距离才会更新位置
-     * @param distance 距离阈值，单位米
-     */
-    setDistanceFilter(distance: number): void;
-    /**
-     * 设置是否自动暂停位置更新（iOS）
-     * @param pauses true: 自动暂停; false: 不暂停
-     */
-    setPausesLocationUpdatesAutomatically(pauses: boolean): void;
-    /**
-     * 设置是否允许后台定位（iOS）
-     * @param allows true: 允许; false: 不允许
-     */
-    setAllowsBackgroundLocationUpdates(allows: boolean): void;
-    /**
-     * 设置定位协议
-     * @param protocol 协议类型
-     */
-    setLocationProtocol(protocol: string): void;
-    /**
-     * 开始更新设备方向（罗盘朝向）
-     * 通过 onHeadingUpdate 事件接收方向更新
-     * @platform ios
-     */
-    startUpdatingHeading(): void;
-    /**
-     * 停止更新设备方向
-     * @platform ios
-     */
-    stopUpdatingHeading(): void;
-    /**
-     * 检查位置权限状态
-     * @returns Promise<PermissionStatus> 权限状态
-     */
-    checkLocationPermission(): Promise<PermissionStatus>;
-    /**
-     * 请求位置权限
-     * @returns Promise<PermissionStatus> 请求后的权限状态
-     */
-    requestLocationPermission(): Promise<PermissionStatus>;
-    /**
-     * 添加定位监听器（便捷方法）
-     * 封装了 addListener，提供更简洁的 API
-     * @param listener 定位回调函数
-     * @returns 订阅对象，调用 remove() 取消监听
-     */
-    addLocationListener(listener: LocationListener): {
-        remove: () => void;
-    };
-}
+import type { ExpoGaodeMapModule } from './types/native-module.types';
+import { SDKConfig } from './types/common.types';
 /**
 * 获取最近一次 initSDK 的配置
 */