expo-gaode-map 2.2.6-next.0 → 2.2.6-next.2

package/build/utils/PermissionUtils.js

@@ -0,0 +1,252 @@
+import { Platform } from 'react-native';
+import { PlatformDetector } from './PlatformDetector';
+/**
+ * 位置权限类型
+ */
+export var LocationPermissionType;
+(function (LocationPermissionType) {
+    /** 仅前台（使用时） */
+    LocationPermissionType["FOREGROUND"] = "foreground";
+    /** 后台位置 */
+    LocationPermissionType["BACKGROUND"] = "background";
+    /** 前台+后台 */
+    LocationPermissionType["FOREGROUND_AND_BACKGROUND"] = "foreground_and_background";
+})(LocationPermissionType || (LocationPermissionType = {}));
+/**
+ * 权限工具类
+ *
+ * 🔔 **重要说明**：
+ *
+ * 本工具类**不执行实际的权限请求**，仅提供：
+ * - 平台检测（Android 14+、iOS 17+）
+ * - 权限说明文案（适配新系统特性）
+ * - 最佳实践建议
+ * - 诊断信息
+ *
+ * **实际权限请求请使用**：
+ * ```typescript
+ * import ExpoGaodeMapModule from 'expo-gaode-map';
+ *
+ * // 检查权限
+ * const status = await ExpoGaodeMapModule.checkLocationPermission();
+ *
+ * // 请求权限
+ * const result = await ExpoGaodeMapModule.requestLocationPermission();
+ * ```
+ *
+ * 本工具类主要用于在请求权限**之前**向用户展示说明文案。
+ */
+export class PermissionUtils {
+    /**
+     * 检查当前平台的系统版本
+     */
+    static getSystemInfo() {
+        const platform = Platform.OS;
+        const systemVersion = PlatformDetector.getSystemVersion();
+        return {
+            platform,
+            version: systemVersion.version,
+            isAndroid14Plus: PlatformDetector.needsAndroid14Permissions(),
+            isiOS17Plus: PlatformDetector.supportsiOS17Features(),
+        };
+    }
+    /**
+     * 获取权限说明文案
+     */
+    static getPermissionRationale(type) {
+        const { platform, isAndroid14Plus, isiOS17Plus } = this.getSystemInfo();
+        if (platform === 'android') {
+            return this.getAndroidRationale(type, isAndroid14Plus);
+        }
+        else {
+            return this.getiOSRationale(type, isiOS17Plus);
+        }
+    }
+    /**
+     * Android 权限说明文案
+     */
+    static getAndroidRationale(type, isAndroid14) {
+        switch (type) {
+            case LocationPermissionType.FOREGROUND:
+                if (isAndroid14) {
+                    return `为了在地图上显示您的位置，应用需要访问您的位置信息。
+
+您可以选择：
+• 仅在使用应用时允许
+• 每次询问
+
+我们不会在后台收集您的位置数据。`;
+                }
+                return '为了在地图上显示您的位置，应用需要访问您的位置信息。';
+            case LocationPermissionType.BACKGROUND:
+                if (isAndroid14) {
+                    return `为了在后台更新您的位置（如导航、轨迹记录），应用需要始终访问位置权限。
+
+您可以随时在设置中更改此权限。`;
+                }
+                return '为了在后台更新您的位置，应用需要始终访问位置权限。';
+            case LocationPermissionType.FOREGROUND_AND_BACKGROUND:
+                if (isAndroid14) {
+                    return `应用需要位置权限来提供以下功能：
+• 在地图上显示您的位置（前台）
+• 后台导航和轨迹记录（后台）
+
+我们会先请求前台权限，然后再请求后台权限。`;
+                }
+                return '应用需要位置权限来显示地图位置和后台导航功能。';
+        }
+    }
+    /**
+     * iOS 权限说明文案
+     */
+    static getiOSRationale(type, isiOS17) {
+        switch (type) {
+            case LocationPermissionType.FOREGROUND:
+                if (isiOS17) {
+                    return `为了在地图上显示您的位置，应用需要访问您的位置信息。
+
+您可以选择：
+• 使用 App 期间：仅在使用应用时访问位置
+• 一次：仅本次使用时访问位置
+
+我们不会在后台收集您的位置数据。`;
+                }
+                return '为了在地图上显示您的位置，应用需要访问您的位置信息。';
+            case LocationPermissionType.BACKGROUND:
+            case LocationPermissionType.FOREGROUND_AND_BACKGROUND:
+                if (isiOS17) {
+                    return `为了提供以下功能，应用需要始终访问位置权限：
+• 后台导航和路径规划
+• 轨迹记录
+• 位置提醒
+
+您可以随时在设置中更改此权限。`;
+                }
+                return '为了在后台更新您的位置，应用需要始终访问位置权限。';
+        }
+    }
+    /**
+     * 获取精确位置权限说明（iOS 14+）
+     */
+    static getAccuracyRationale() {
+        const { isiOS17Plus } = this.getSystemInfo();
+        if (isiOS17Plus) {
+            return `为了提供准确的导航和定位服务，应用需要访问精确位置。
+
+选择"模糊位置"可能会导致：
+• 地图定位不准确
+• 导航路线偏差
+• 搜索结果不精确`;
+        }
+        return '为了提供准确的导航和定位服务，应用需要访问精确位置。';
+    }
+    /**
+     * 获取权限请求的最佳实践建议
+     */
+    static getBestPractices() {
+        return {
+            android14: [
+                '先解释为什么需要权限，再发起请求',
+                '前台和后台权限分两步请求',
+                '永久拒绝后引导用户到设置页面',
+                '提供"仅本次"选项的说明',
+            ],
+            ios17: [
+                '在 Info.plist 中提供清晰的权限说明',
+                '使用 Privacy Manifest 声明位置访问原因',
+                '先请求"使用期间"，再请求"始终允许"',
+                '支持"仅一次"权限模式',
+            ],
+            general: [
+                '在用户需要使用功能时再请求权限',
+                '清晰解释权限用途和好处',
+                '提供拒绝后的替代方案',
+                '尊重用户的权限选择',
+            ],
+        };
+    }
+    /**
+     * 验证 Info.plist 配置（仅 iOS）
+     */
+    static validateiOSConfiguration() {
+        if (Platform.OS !== 'ios') {
+            return {
+                valid: true,
+                missingKeys: [],
+                recommendations: [],
+            };
+        }
+        const recommendations = [];
+        const { isiOS17Plus } = this.getSystemInfo();
+        if (isiOS17Plus) {
+            recommendations.push('建议在 Privacy Manifest (PrivacyInfo.xcprivacy) 中声明位置访问原因', '确保 NSLocationWhenInUseUsageDescription 文案清晰、具体', '如需后台位置，配置 NSLocationAlwaysAndWhenInUseUsageDescription');
+        }
+        return {
+            valid: true,
+            missingKeys: [],
+            recommendations,
+        };
+    }
+    /**
+     * 检查是否支持后台位置权限
+     */
+    static supportsBackgroundLocation() {
+        const { platform, version } = this.getSystemInfo();
+        if (platform === 'android') {
+            // Android 10 (API 29) 引入后台位置权限
+            return version >= 29;
+        }
+        else {
+            // iOS 8+ 支持
+            return version >= 8;
+        }
+    }
+    /**
+     * 打印权限诊断信息
+     */
+    static printDiagnostics() {
+        const info = this.getSystemInfo();
+        console.log('=== 权限管理诊断信息 ===');
+        console.log(`平台: ${info.platform}`);
+        console.log(`系统版本: ${info.version}`);
+        console.log(`Android 14+: ${info.isAndroid14Plus ? '是' : '否'}`);
+        console.log(`iOS 17+: ${info.isiOS17Plus ? '是' : '否'}`);
+        console.log(`支持后台位置: ${this.supportsBackgroundLocation() ? '是' : '否'}`);
+        const practices = this.getBestPractices();
+        console.log('\n💡 最佳实践建议:');
+        if (info.isAndroid14Plus) {
+            console.log('\nAndroid 14+ 特别注意:');
+            practices.android14.forEach((tip, index) => {
+                console.log(`  ${index + 1}. ${tip}`);
+            });
+        }
+        if (info.isiOS17Plus) {
+            console.log('\niOS 17+ 特别注意:');
+            practices.ios17.forEach((tip, index) => {
+                console.log(`  ${index + 1}. ${tip}`);
+            });
+        }
+        console.log('\n通用建议:');
+        practices.general.forEach((tip, index) => {
+            console.log(`  ${index + 1}. ${tip}`);
+        });
+        if (info.platform === 'ios') {
+            const validation = this.validateiOSConfiguration();
+            if (validation.recommendations.length > 0) {
+                console.log('\niOS 配置建议:');
+                validation.recommendations.forEach((rec, index) => {
+                    console.log(`  ${index + 1}. ${rec}`);
+                });
+            }
+        }
+        console.log('\n📌 实际权限请求：');
+        console.log('  使用 ExpoGaodeMapModule.checkLocationPermission()');
+        console.log('  使用 ExpoGaodeMapModule.requestLocationPermission()');
+    }
+}
+/**
+ * 向后兼容的别名
+ * @deprecated 请使用 PermissionUtils
+ */
+export const PermissionManager = PermissionUtils;
+//# sourceMappingURL=PermissionUtils.js.map

package/build/utils/PermissionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionUtils.js","sourceRoot":"","sources":["../../src/utils/PermissionUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\nimport { PlatformDetector } from './PlatformDetector';\n\n/**\n * 位置权限类型\n */\nexport enum LocationPermissionType {\n  /** 仅前台（使用时） */\n  FOREGROUND = 'foreground',\n  /** 后台位置 */\n  BACKGROUND = 'background',\n  /** 前台+后台 */\n  FOREGROUND_AND_BACKGROUND = 'foreground_and_background',\n}\n\n/**\n * 权限工具类\n *\n * 🔔 **重要说明**：\n *\n * 本工具类**不执行实际的权限请求**，仅提供：\n * - 平台检测（Android 14+、iOS 17+）\n * - 权限说明文案（适配新系统特性）\n * - 最佳实践建议\n * - 诊断信息\n *\n * **实际权限请求请使用**：\n * ```typescript\n * import ExpoGaodeMapModule from 'expo-gaode-map';\n *\n * // 检查权限\n * const status = await ExpoGaodeMapModule.checkLocationPermission();\n *\n * // 请求权限\n * const result = await ExpoGaodeMapModule.requestLocationPermission();\n * ```\n *\n * 本工具类主要用于在请求权限**之前**向用户展示说明文案。\n */\nexport class PermissionUtils {\n  /**\n   * 检查当前平台的系统版本\n   */\n  static getSystemInfo(): {\n    platform: 'android' | 'ios';\n    version: number;\n    isAndroid14Plus: boolean;\n    isiOS17Plus: boolean;\n  } {\n    const platform = Platform.OS as 'android' | 'ios';\n    const systemVersion = PlatformDetector.getSystemVersion();\n    \n    return {\n      platform,\n      version: systemVersion.version,\n      isAndroid14Plus: PlatformDetector.needsAndroid14Permissions(),\n      isiOS17Plus: PlatformDetector.supportsiOS17Features(),\n    };\n  }\n\n  /**\n   * 获取权限说明文案\n   */\n  static getPermissionRationale(type: LocationPermissionType): string {\n    const { platform, isAndroid14Plus, isiOS17Plus } = this.getSystemInfo();\n    \n    if (platform === 'android') {\n      return this.getAndroidRationale(type, isAndroid14Plus);\n    } else {\n      return this.getiOSRationale(type, isiOS17Plus);\n    }\n  }\n\n  /**\n   * Android 权限说明文案\n   */\n  private static getAndroidRationale(\n    type: LocationPermissionType,\n    isAndroid14: boolean\n  ): string {\n    switch (type) {\n      case LocationPermissionType.FOREGROUND:\n        if (isAndroid14) {\n          return `为了在地图上显示您的位置，应用需要访问您的位置信息。\n\n您可以选择：\n• 仅在使用应用时允许\n• 每次询问\n\n我们不会在后台收集您的位置数据。`;\n        }\n        return '为了在地图上显示您的位置，应用需要访问您的位置信息。';\n\n      case LocationPermissionType.BACKGROUND:\n        if (isAndroid14) {\n          return `为了在后台更新您的位置（如导航、轨迹记录），应用需要始终访问位置权限。\n\n您可以随时在设置中更改此权限。`;\n        }\n        return '为了在后台更新您的位置，应用需要始终访问位置权限。';\n\n      case LocationPermissionType.FOREGROUND_AND_BACKGROUND:\n        if (isAndroid14) {\n          return `应用需要位置权限来提供以下功能：\n• 在地图上显示您的位置（前台）\n• 后台导航和轨迹记录（后台）\n\n我们会先请求前台权限，然后再请求后台权限。`;\n        }\n        return '应用需要位置权限来显示地图位置和后台导航功能。';\n    }\n  }\n\n  /**\n   * iOS 权限说明文案\n   */\n  private static getiOSRationale(\n    type: LocationPermissionType,\n    isiOS17: boolean\n  ): string {\n    switch (type) {\n      case LocationPermissionType.FOREGROUND:\n        if (isiOS17) {\n          return `为了在地图上显示您的位置，应用需要访问您的位置信息。\n\n您可以选择：\n• 使用 App 期间：仅在使用应用时访问位置\n• 一次：仅本次使用时访问位置\n\n我们不会在后台收集您的位置数据。`;\n        }\n        return '为了在地图上显示您的位置，应用需要访问您的位置信息。';\n\n      case LocationPermissionType.BACKGROUND:\n      case LocationPermissionType.FOREGROUND_AND_BACKGROUND:\n        if (isiOS17) {\n          return `为了提供以下功能，应用需要始终访问位置权限：\n• 后台导航和路径规划\n• 轨迹记录\n• 位置提醒\n\n您可以随时在设置中更改此权限。`;\n        }\n        return '为了在后台更新您的位置，应用需要始终访问位置权限。';\n    }\n  }\n\n  /**\n   * 获取精确位置权限说明（iOS 14+）\n   */\n  static getAccuracyRationale(): string {\n    const { isiOS17Plus } = this.getSystemInfo();\n    \n    if (isiOS17Plus) {\n      return `为了提供准确的导航和定位服务，应用需要访问精确位置。\n\n选择\"模糊位置\"可能会导致：\n• 地图定位不准确\n• 导航路线偏差\n• 搜索结果不精确`;\n    }\n    \n    return '为了提供准确的导航和定位服务，应用需要访问精确位置。';\n  }\n\n  /**\n   * 获取权限请求的最佳实践建议\n   */\n  static getBestPractices(): {\n    android14: string[];\n    ios17: string[];\n    general: string[];\n  } {\n    return {\n      android14: [\n        '先解释为什么需要权限，再发起请求',\n        '前台和后台权限分两步请求',\n        '永久拒绝后引导用户到设置页面',\n        '提供\"仅本次\"选项的说明',\n      ],\n      ios17: [\n        '在 Info.plist 中提供清晰的权限说明',\n        '使用 Privacy Manifest 声明位置访问原因',\n        '先请求\"使用期间\"，再请求\"始终允许\"',\n        '支持\"仅一次\"权限模式',\n      ],\n      general: [\n        '在用户需要使用功能时再请求权限',\n        '清晰解释权限用途和好处',\n        '提供拒绝后的替代方案',\n        '尊重用户的权限选择',\n      ],\n    };\n  }\n\n  /**\n   * 验证 Info.plist 配置（仅 iOS）\n   */\n  static validateiOSConfiguration(): {\n    valid: boolean;\n    missingKeys: string[];\n    recommendations: string[];\n  } {\n    if (Platform.OS !== 'ios') {\n      return {\n        valid: true,\n        missingKeys: [],\n        recommendations: [],\n      };\n    }\n\n    const recommendations: string[] = [];\n    const { isiOS17Plus } = this.getSystemInfo();\n\n    if (isiOS17Plus) {\n      recommendations.push(\n        '建议在 Privacy Manifest (PrivacyInfo.xcprivacy) 中声明位置访问原因',\n        '确保 NSLocationWhenInUseUsageDescription 文案清晰、具体',\n        '如需后台位置，配置 NSLocationAlwaysAndWhenInUseUsageDescription'\n      );\n    }\n\n    return {\n      valid: true,\n      missingKeys: [],\n      recommendations,\n    };\n  }\n\n  /**\n   * 检查是否支持后台位置权限\n   */\n  static supportsBackgroundLocation(): boolean {\n    const { platform, version } = this.getSystemInfo();\n    \n    if (platform === 'android') {\n      // Android 10 (API 29) 引入后台位置权限\n      return version >= 29;\n    } else {\n      // iOS 8+ 支持\n      return version >= 8;\n    }\n  }\n\n  /**\n   * 打印权限诊断信息\n   */\n  static printDiagnostics(): void {\n    const info = this.getSystemInfo();\n    console.log('=== 权限管理诊断信息 ===');\n    console.log(`平台: ${info.platform}`);\n    console.log(`系统版本: ${info.version}`);\n    console.log(`Android 14+: ${info.isAndroid14Plus ? '是' : '否'}`);\n    console.log(`iOS 17+: ${info.isiOS17Plus ? '是' : '否'}`);\n    console.log(`支持后台位置: ${this.supportsBackgroundLocation() ? '是' : '否'}`);\n    \n    const practices = this.getBestPractices();\n    console.log('\\n💡 最佳实践建议:');\n    \n    if (info.isAndroid14Plus) {\n      console.log('\\nAndroid 14+ 特别注意:');\n      practices.android14.forEach((tip, index) => {\n        console.log(`  ${index + 1}. ${tip}`);\n      });\n    }\n    \n    if (info.isiOS17Plus) {\n      console.log('\\niOS 17+ 特别注意:');\n      practices.ios17.forEach((tip, index) => {\n        console.log(`  ${index + 1}. ${tip}`);\n      });\n    }\n    \n    console.log('\\n通用建议:');\n    practices.general.forEach((tip, index) => {\n      console.log(`  ${index + 1}. ${tip}`);\n    });\n    \n    if (info.platform === 'ios') {\n      const validation = this.validateiOSConfiguration();\n      if (validation.recommendations.length > 0) {\n        console.log('\\niOS 配置建议:');\n        validation.recommendations.forEach((rec, index) => {\n          console.log(`  ${index + 1}. ${rec}`);\n        });\n      }\n    }\n    \n    console.log('\\n📌 实际权限请求：');\n    console.log('  使用 ExpoGaodeMapModule.checkLocationPermission()');\n    console.log('  使用 ExpoGaodeMapModule.requestLocationPermission()');\n  }\n}\n\n/**\n * 向后兼容的别名\n * @deprecated 请使用 PermissionUtils\n */\nexport const PermissionManager = PermissionUtils;"]}

package/build/utils/PlatformDetector.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 平台检测工具
+ * 用于检测设备特性、系统版本等
+ */
+/**
+ * 设备类型
+ */
+export declare enum DeviceType {
+    PHONE = "phone",
+    TABLET = "tablet",
+    FOLDABLE = "foldable",
+    UNKNOWN = "unknown"
+}
+/**
+ * 折叠状态
+ */
+export declare enum FoldState {
+    FOLDED = "folded",
+    UNFOLDED = "unfolded",
+    HALF_FOLDED = "half_folded",
+    UNKNOWN = "unknown"
+}
+/**
+ * 设备信息
+ */
+export interface DeviceInfo {
+    type: DeviceType;
+    isTablet: boolean;
+    isFoldable: boolean;
+    screenSize: {
+        width: number;
+        height: number;
+        scale: number;
+        fontScale: number;
+    };
+    aspectRatio: number;
+    isLandscape: boolean;
+}
+/**
+ * 系统版本信息
+ */
+export interface SystemVersion {
+    platform: 'ios' | 'android';
+    version: number;
+    isAndroid14Plus: boolean;
+    isIOS17Plus: boolean;
+}
+/**
+ * 平台检测器类
+ */
+export declare class PlatformDetector {
+    private static deviceInfo;
+    private static systemVersion;
+    /**
+     * 获取系统版本信息
+     */
+    static getSystemVersion(): SystemVersion;
+    /**
+     * 获取设备信息
+     */
+    static getDeviceInfo(): DeviceInfo;
+    /**
+     * 检测折叠屏设备
+     */
+    private static detectFoldable;
+    /**
+     * 检测当前折叠状态（需要原生支持）
+     */
+    static getFoldState(): FoldState;
+    /**
+     * 是否为 iPad
+     */
+    static isIPad(): boolean;
+    /**
+     * 是否支持多任务
+     */
+    static supportsMultitasking(): boolean;
+    /**
+     * 是否需要 Android 14+ 新权限流程
+     */
+    static needsAndroid14Permissions(): boolean;
+    /**
+     * 是否支持 iOS 17+ 新特性
+     */
+    static supportsiOS17Features(): boolean;
+    /**
+     * 监听屏幕尺寸变化（折叠屏展开/折叠）
+     */
+    static addDimensionChangeListener(callback: (info: DeviceInfo) => void): () => void;
+    /**
+     * 重置缓存（用于测试或强制刷新）
+     */
+    static resetCache(): void;
+}
+/**
+ * 便捷的导出函数
+ */
+export declare const isAndroid14Plus: () => boolean;
+export declare const isiOS17Plus: () => boolean;
+export declare const isTablet: () => boolean;
+export declare const isFoldable: () => boolean;
+export declare const isIPad: () => boolean;
+//# sourceMappingURL=PlatformDetector.d.ts.map

package/build/utils/PlatformDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformDetector.d.ts","sourceRoot":"","sources":["../../src/utils/PlatformDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,UAAU,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8B;IAE1D;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAiBxC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,UAAU;IAmClC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA6B7B;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,SAAS;IAgBhC;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,OAAO;IAOxB;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,OAAO;IAItC;;OAEG;IACH,MAAM,CAAC,yBAAyB,IAAI,OAAO;IAI3C;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,OAAO;IAIvC;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAWnF;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;CAI1B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAAqD,CAAC;AAClF,eAAO,MAAM,WAAW,eAAiD,CAAC;AAC1E,eAAO,MAAM,QAAQ,eAAkD,CAAC;AACxE,eAAO,MAAM,UAAU,eAAoD,CAAC;AAC5E,eAAO,MAAM,MAAM,eAAkC,CAAC"}

package/build/utils/PlatformDetector.js

@@ -0,0 +1,178 @@
+/**
+ * 平台检测工具
+ * 用于检测设备特性、系统版本等
+ */
+import { Platform, Dimensions } from 'react-native';
+/**
+ * 设备类型
+ */
+export var DeviceType;
+(function (DeviceType) {
+    DeviceType["PHONE"] = "phone";
+    DeviceType["TABLET"] = "tablet";
+    DeviceType["FOLDABLE"] = "foldable";
+    DeviceType["UNKNOWN"] = "unknown";
+})(DeviceType || (DeviceType = {}));
+/**
+ * 折叠状态
+ */
+export var FoldState;
+(function (FoldState) {
+    FoldState["FOLDED"] = "folded";
+    FoldState["UNFOLDED"] = "unfolded";
+    FoldState["HALF_FOLDED"] = "half_folded";
+    FoldState["UNKNOWN"] = "unknown";
+})(FoldState || (FoldState = {}));
+/**
+ * 平台检测器类
+ */
+export class PlatformDetector {
+    static deviceInfo = null;
+    static systemVersion = null;
+    /**
+     * 获取系统版本信息
+     */
+    static getSystemVersion() {
+        if (this.systemVersion) {
+            return this.systemVersion;
+        }
+        const version = parseInt(Platform.Version.toString(), 10);
+        this.systemVersion = {
+            platform: Platform.OS,
+            version,
+            isAndroid14Plus: Platform.OS === 'android' && version >= 34, // Android 14 = API 34
+            isIOS17Plus: Platform.OS === 'ios' && version >= 17,
+        };
+        return this.systemVersion;
+    }
+    /**
+     * 获取设备信息
+     */
+    static getDeviceInfo() {
+        if (this.deviceInfo) {
+            return this.deviceInfo;
+        }
+        const { width, height, scale, fontScale } = Dimensions.get('window');
+        const aspectRatio = Math.max(width, height) / Math.min(width, height);
+        const isLandscape = width > height;
+        // 判断是否为平板（基于屏幕尺寸和宽高比）
+        const smallerDimension = Math.min(width, height);
+        const isTablet = smallerDimension >= 600 || aspectRatio < 1.6;
+        // 检测折叠屏（基于极端宽高比）
+        const isFoldable = this.detectFoldable(width, height, aspectRatio);
+        let type = DeviceType.PHONE;
+        if (isFoldable) {
+            type = DeviceType.FOLDABLE;
+        }
+        else if (isTablet) {
+            type = DeviceType.TABLET;
+        }
+        this.deviceInfo = {
+            type,
+            isTablet,
+            isFoldable,
+            screenSize: { width, height, scale, fontScale },
+            aspectRatio,
+            isLandscape,
+        };
+        return this.deviceInfo;
+    }
+    /**
+     * 检测折叠屏设备
+     */
+    static detectFoldable(width, height, aspectRatio) {
+        // 常见折叠屏特征：
+        // 1. 展开时宽高比接近正方形或较小（1.2-1.6）
+        // 2. 折叠时宽高比很大（>2.1）
+        if (Platform.OS === 'android') {
+            // 检查是否为极端宽高比
+            if (aspectRatio > 2.1 || aspectRatio < 1.3) {
+                return true;
+            }
+            // 检查是否为特定分辨率（已知折叠屏设备）
+            const knownFoldableResolutions = [
+                { w: 2208, h: 1768 }, // Galaxy Z Fold 展开
+                { w: 2176, h: 1812 }, // Galaxy Z Fold 3/4 展开
+                { w: 884, h: 2208 }, // Galaxy Z Fold 折叠
+                { w: 1768, h: 2208 }, // Huawei Mate X
+            ];
+            return knownFoldableResolutions.some((res) => (Math.abs(width - res.w) < 50 && Math.abs(height - res.h) < 50) ||
+                (Math.abs(width - res.h) < 50 && Math.abs(height - res.w) < 50));
+        }
+        return false;
+    }
+    /**
+     * 检测当前折叠状态（需要原生支持）
+     */
+    static getFoldState() {
+        const info = this.getDeviceInfo();
+        if (!info.isFoldable) {
+            return FoldState.UNKNOWN;
+        }
+        // 基于宽高比判断折叠状态
+        if (info.aspectRatio > 2.0) {
+            return FoldState.FOLDED;
+        }
+        else if (info.aspectRatio < 1.5) {
+            return FoldState.UNFOLDED;
+        }
+        else {
+            return FoldState.HALF_FOLDED;
+        }
+    }
+    /**
+     * 是否为 iPad
+     */
+    static isIPad() {
+        if (Platform.OS !== 'ios') {
+            return false;
+        }
+        return this.getDeviceInfo().isTablet;
+    }
+    /**
+     * 是否支持多任务
+     */
+    static supportsMultitasking() {
+        return Platform.OS === 'ios' && this.isIPad();
+    }
+    /**
+     * 是否需要 Android 14+ 新权限流程
+     */
+    static needsAndroid14Permissions() {
+        return this.getSystemVersion().isAndroid14Plus;
+    }
+    /**
+     * 是否支持 iOS 17+ 新特性
+     */
+    static supportsiOS17Features() {
+        return this.getSystemVersion().isIOS17Plus;
+    }
+    /**
+     * 监听屏幕尺寸变化（折叠屏展开/折叠）
+     */
+    static addDimensionChangeListener(callback) {
+        const subscription = Dimensions.addEventListener('change', () => {
+            // 清除缓存，重新计算
+            this.deviceInfo = null;
+            const newInfo = this.getDeviceInfo();
+            callback(newInfo);
+        });
+        return () => subscription.remove();
+    }
+    /**
+     * 重置缓存（用于测试或强制刷新）
+     */
+    static resetCache() {
+        this.deviceInfo = null;
+        this.systemVersion = null;
+    }
+}
+/**
+ * 便捷的导出函数
+ */
+export const isAndroid14Plus = () => PlatformDetector.needsAndroid14Permissions();
+export const isiOS17Plus = () => PlatformDetector.supportsiOS17Features();
+export const isTablet = () => PlatformDetector.getDeviceInfo().isTablet;
+export const isFoldable = () => PlatformDetector.getDeviceInfo().isFoldable;
+export const isIPad = () => PlatformDetector.isIPad();
+//# sourceMappingURL=PlatformDetector.js.map

package/build/utils/PlatformDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformDetector.js","sourceRoot":"","sources":["../../src/utils/PlatformDetector.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 平台检测工具\n * 用于检测设备特性、系统版本等\n */\n\nimport { Platform, Dimensions } from 'react-native';\n\n/**\n * 设备类型\n */\nexport enum DeviceType {\n  PHONE = 'phone',\n  TABLET = 'tablet',\n  FOLDABLE = 'foldable',\n  UNKNOWN = 'unknown',\n}\n\n/**\n * 折叠状态\n */\nexport enum FoldState {\n  FOLDED = 'folded',\n  UNFOLDED = 'unfolded',\n  HALF_FOLDED = 'half_folded',\n  UNKNOWN = 'unknown',\n}\n\n/**\n * 设备信息\n */\nexport interface DeviceInfo {\n  type: DeviceType;\n  isTablet: boolean;\n  isFoldable: boolean;\n  screenSize: {\n    width: number;\n    height: number;\n    scale: number;\n    fontScale: number;\n  };\n  aspectRatio: number;\n  isLandscape: boolean;\n}\n\n/**\n * 系统版本信息\n */\nexport interface SystemVersion {\n  platform: 'ios' | 'android';\n  version: number;\n  isAndroid14Plus: boolean;\n  isIOS17Plus: boolean;\n}\n\n/**\n * 平台检测器类\n */\nexport class PlatformDetector {\n  private static deviceInfo: DeviceInfo | null = null;\n  private static systemVersion: SystemVersion | null = null;\n\n  /**\n   * 获取系统版本信息\n   */\n  static getSystemVersion(): SystemVersion {\n    if (this.systemVersion) {\n      return this.systemVersion;\n    }\n\n    const version = parseInt(Platform.Version.toString(), 10);\n    \n    this.systemVersion = {\n      platform: Platform.OS as 'ios' | 'android',\n      version,\n      isAndroid14Plus: Platform.OS === 'android' && version >= 34, // Android 14 = API 34\n      isIOS17Plus: Platform.OS === 'ios' && version >= 17,\n    };\n\n    return this.systemVersion;\n  }\n\n  /**\n   * 获取设备信息\n   */\n  static getDeviceInfo(): DeviceInfo {\n    if (this.deviceInfo) {\n      return this.deviceInfo;\n    }\n\n    const { width, height, scale, fontScale } = Dimensions.get('window');\n    const aspectRatio = Math.max(width, height) / Math.min(width, height);\n    const isLandscape = width > height;\n\n    // 判断是否为平板（基于屏幕尺寸和宽高比）\n    const smallerDimension = Math.min(width, height);\n    const isTablet = smallerDimension >= 600 || aspectRatio < 1.6;\n\n    // 检测折叠屏（基于极端宽高比）\n    const isFoldable = this.detectFoldable(width, height, aspectRatio);\n\n    let type: DeviceType = DeviceType.PHONE;\n    if (isFoldable) {\n      type = DeviceType.FOLDABLE;\n    } else if (isTablet) {\n      type = DeviceType.TABLET;\n    }\n\n    this.deviceInfo = {\n      type,\n      isTablet,\n      isFoldable,\n      screenSize: { width, height, scale, fontScale },\n      aspectRatio,\n      isLandscape,\n    };\n\n    return this.deviceInfo;\n  }\n\n  /**\n   * 检测折叠屏设备\n   */\n  private static detectFoldable(width: number, height: number, aspectRatio: number): boolean {\n    // 常见折叠屏特征：\n    // 1. 展开时宽高比接近正方形或较小（1.2-1.6）\n    // 2. 折叠时宽高比很大（>2.1）\n    \n    if (Platform.OS === 'android') {\n      // 检查是否为极端宽高比\n      if (aspectRatio > 2.1 || aspectRatio < 1.3) {\n        return true;\n      }\n      \n      // 检查是否为特定分辨率（已知折叠屏设备）\n      const knownFoldableResolutions = [\n        { w: 2208, h: 1768 }, // Galaxy Z Fold 展开\n        { w: 2176, h: 1812 }, // Galaxy Z Fold 3/4 展开\n        { w: 884, h: 2208 },  // Galaxy Z Fold 折叠\n        { w: 1768, h: 2208 }, // Huawei Mate X\n      ];\n\n      return knownFoldableResolutions.some(\n        (res) =>\n          (Math.abs(width - res.w) < 50 && Math.abs(height - res.h) < 50) ||\n          (Math.abs(width - res.h) < 50 && Math.abs(height - res.w) < 50)\n      );\n    }\n\n    return false;\n  }\n\n  /**\n   * 检测当前折叠状态（需要原生支持）\n   */\n  static getFoldState(): FoldState {\n    const info = this.getDeviceInfo();\n    if (!info.isFoldable) {\n      return FoldState.UNKNOWN;\n    }\n\n    // 基于宽高比判断折叠状态\n    if (info.aspectRatio > 2.0) {\n      return FoldState.FOLDED;\n    } else if (info.aspectRatio < 1.5) {\n      return FoldState.UNFOLDED;\n    } else {\n      return FoldState.HALF_FOLDED;\n    }\n  }\n\n  /**\n   * 是否为 iPad\n   */\n  static isIPad(): boolean {\n    if (Platform.OS !== 'ios') {\n      return false;\n    }\n    return this.getDeviceInfo().isTablet;\n  }\n\n  /**\n   * 是否支持多任务\n   */\n  static supportsMultitasking(): boolean {\n    return Platform.OS === 'ios' && this.isIPad();\n  }\n\n  /**\n   * 是否需要 Android 14+ 新权限流程\n   */\n  static needsAndroid14Permissions(): boolean {\n    return this.getSystemVersion().isAndroid14Plus;\n  }\n\n  /**\n   * 是否支持 iOS 17+ 新特性\n   */\n  static supportsiOS17Features(): boolean {\n    return this.getSystemVersion().isIOS17Plus;\n  }\n\n  /**\n   * 监听屏幕尺寸变化（折叠屏展开/折叠）\n   */\n  static addDimensionChangeListener(callback: (info: DeviceInfo) => void): () => void {\n    const subscription = Dimensions.addEventListener('change', () => {\n      // 清除缓存，重新计算\n      this.deviceInfo = null;\n      const newInfo = this.getDeviceInfo();\n      callback(newInfo);\n    });\n\n    return () => subscription.remove();\n  }\n\n  /**\n   * 重置缓存（用于测试或强制刷新）\n   */\n  static resetCache(): void {\n    this.deviceInfo = null;\n    this.systemVersion = null;\n  }\n}\n\n/**\n * 便捷的导出函数\n */\nexport const isAndroid14Plus = () => PlatformDetector.needsAndroid14Permissions();\nexport const isiOS17Plus = () => PlatformDetector.supportsiOS17Features();\nexport const isTablet = () => PlatformDetector.getDeviceInfo().isTablet;\nexport const isFoldable = () => PlatformDetector.getDeviceInfo().isFoldable;\nexport const isIPad = () => PlatformDetector.isIPad();"]}

package/expo-module.config.json

@@ -10,7 +10,8 @@
       "PolylineViewModule",
       "MultiPointViewModule",
       "HeatMapViewModule",
-      "ClusterViewModule"
+      "ClusterViewModule",
+      "ExpoGaodeMapOfflineModule"
     ]
   },
   "android": {
@@ -23,7 +24,8 @@
       "expo.modules.gaodemap.overlays.PolylineViewModule",
       "expo.modules.gaodemap.overlays.MultiPointViewModule",
       "expo.modules.gaodemap.overlays.HeatMapViewModule",
-      "expo.modules.gaodemap.overlays.ClusterViewModule"
+      "expo.modules.gaodemap.overlays.ClusterViewModule",
+      "expo.modules.gaodemap.ExpoGaodeMapOfflineModule"
     ]
   }
 }