expo-gaode-map 2.2.2 → 2.2.3-next.1

package/build/components/MapPreloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapPreloader.d.ts","sourceRoot":"","sources":["../../src/components/MapPreloader.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAC;AAGjD,OAAO,EAAgB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACjC,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,cAAc;IACd,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6E7D,CAAC;AAwBF,eAAe,qBAAqB,CAAC"}

package/build/components/MapPreloader.js

@@ -0,0 +1,105 @@
+/**
+ * 地图预加载组件
+ * 在后台渲染隐藏的地图视图以实现预加载
+ */
+import React, { useEffect, useRef } from 'react';
+import { View, StyleSheet } from 'react-native';
+import ExpoGaodeMapView from '../ExpoGaodeMapView';
+import { MapPreloader } from '../utils/MapPreloader';
+/**
+ * 地图预加载组件
+ *
+ * 在应用启动时渲染隐藏的地图视图，提前初始化地图引擎，
+ * 当用户真正需要显示地图时可以获得更快的加载速度
+ *
+ * @example
+ * ```tsx
+ * // 在 App 根组件中使用
+ * function App() {
+ *   return (
+ *     <>
+ *       <MapPreloader
+ *         config={{ poolSize: 1, delay: 2000 }}
+ *         onPreloadComplete={() => console.log('地图预加载完成')}
+ *       />
+ *       <YourAppContent />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export const MapPreloaderComponent = ({ config, mapProps = {}, enabled = true, onPreloadComplete, onPreloadError, }) => {
+    const hasInitialized = useRef(false);
+    useEffect(() => {
+        if (!enabled || hasInitialized.current) {
+            return;
+        }
+        hasInitialized.current = true;
+        // 配置预加载
+        if (config) {
+            MapPreloader.configure(config);
+        }
+        // 启动预加载，并处理可能的错误
+        const startPreloadAsync = async () => {
+            try {
+                MapPreloader.startPreload();
+            }
+            catch (error) {
+                console.error("地图预加载失败", error);
+                onPreloadError?.(error);
+            }
+        };
+        startPreloadAsync();
+        // 监听预加载状态
+        // 监听预加载状态
+        const unsubscribe = MapPreloader.addListener((status) => {
+            if (status === 'ready') {
+                onPreloadComplete?.();
+            }
+            else if (status === 'error') {
+                onPreloadError?.(new Error('地图预加载失败'));
+            }
+        });
+        // 启动预加载
+        // MapPreloader.startPreload();
+        return () => {
+            unsubscribe();
+            // 组件卸载时不清理预加载实例，因为它们可能被其他地方使用
+        };
+    }, [config, enabled, onPreloadComplete, onPreloadError]);
+    // 如果未启用，不渲染任何内容
+    if (!enabled) {
+        return null;
+    }
+    const poolSize = config?.poolSize || 1;
+    return (<View style={styles.container} pointerEvents="none">
+      {Array.from({ length: poolSize }).map((_, index) => (<View key={`preload-${index}`} style={styles.hiddenMap}>
+          <ExpoGaodeMapView style={styles.mapView} initialCameraPosition={{
+                target: { latitude: 39.9042, longitude: 116.4074 },
+                zoom: 10,
+            }} {...mapProps}/>
+        </View>))}
+    </View>);
+};
+const styles = StyleSheet.create({
+    container: {
+        position: 'absolute',
+        left: -10000,
+        top: -10000,
+        width: 1,
+        height: 1,
+        overflow: 'hidden',
+        opacity: 0,
+    },
+    hiddenMap: {
+        width: 1,
+        height: 1,
+    },
+    mapView: {
+        width: 1,
+        height: 1,
+    },
+});
+MapPreloaderComponent.displayName = 'MapPreloader';
+export default MapPreloaderComponent;
+//# sourceMappingURL=MapPreloader.js.map

package/build/components/MapPreloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapPreloader.js","sourceRoot":"","sources":["../../src/components/MapPreloader.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * 地图预加载组件\n * 在后台渲染隐藏的地图视图以实现预加载\n */\n\nimport React, { useEffect, useRef } from 'react';\nimport { View, StyleSheet } from 'react-native';\nimport ExpoGaodeMapView from '../ExpoGaodeMapView';\nimport { MapPreloader, PreloadConfig } from '../utils/MapPreloader';\nimport type { MapViewProps } from '../types';\n\n/**\n * 预加载组件属性\n */\nexport interface MapPreloaderProps {\n  /** 预加载配置 */\n  config?: PreloadConfig;\n  /** 预加载的地图视图属性 */\n  mapProps?: Partial<MapViewProps>;\n  /** 是否启用预加载，默认为 true */\n  enabled?: boolean;\n  /** 预加载完成回调 */\n  onPreloadComplete?: () => void;\n  /** 预加载失败回调 */\n  onPreloadError?: (error: Error) => void;\n}\n\n/**\n * 地图预加载组件\n * \n * 在应用启动时渲染隐藏的地图视图，提前初始化地图引擎，\n * 当用户真正需要显示地图时可以获得更快的加载速度\n * \n * @example\n * ```tsx\n * // 在 App 根组件中使用\n * function App() {\n *   return (\n *     <>\n *       <MapPreloader\n *         config={{ poolSize: 1, delay: 2000 }}\n *         onPreloadComplete={() => console.log('地图预加载完成')}\n *       />\n *       <YourAppContent />\n *     </>\n *   );\n * }\n * ```\n */\nexport const MapPreloaderComponent: React.FC<MapPreloaderProps> = ({\n  config,\n  mapProps = {},\n  enabled = true,\n  onPreloadComplete,\n  onPreloadError,\n}) => {\n  const hasInitialized = useRef(false);\n\n\n  useEffect(() => {\n    if (!enabled || hasInitialized.current) {\n      return;\n    }\n\n    hasInitialized.current = true;\n\n    // 配置预加载\n    if (config) {\n      MapPreloader.configure(config);\n    }\n\n    // 启动预加载，并处理可能的错误\n    const startPreloadAsync = async () => {\n      try {\n        MapPreloader.startPreload();\n      } catch (error) {\n        console.error(\"地图预加载失败\", error);\n        onPreloadError?.(error as Error);\n      }\n    };\n\n    startPreloadAsync();\n\n    // 监听预加载状态\n    // 监听预加载状态\n    const unsubscribe = MapPreloader.addListener((status) => {\n      if (status === 'ready') {\n        onPreloadComplete?.();\n      } else if (status === 'error') {\n        onPreloadError?.(new Error('地图预加载失败'));\n      }\n    });\n\n\n    // 启动预加载\n    // MapPreloader.startPreload();\n\n    return () => {\n      unsubscribe();\n      // 组件卸载时不清理预加载实例，因为它们可能被其他地方使用\n    };\n  }, [config, enabled, onPreloadComplete, onPreloadError]);\n\n  // 如果未启用，不渲染任何内容\n  if (!enabled) {\n    return null;\n  }\n\n  const poolSize = config?.poolSize || 1;\n\n  return (\n    <View style={styles.container} pointerEvents=\"none\">\n      {Array.from({ length: poolSize }).map((_, index) => (\n        <View key={`preload-${index}`} style={styles.hiddenMap}>\n          <ExpoGaodeMapView\n            style={styles.mapView}\n            initialCameraPosition={{\n              target: { latitude: 39.9042, longitude: 116.4074 },\n              zoom: 10,\n            }}\n            {...mapProps}\n          />\n        </View>\n      ))}\n    </View>\n  );\n};\n\nconst styles = StyleSheet.create({\n  container: {\n    position: 'absolute',\n    left: -10000,\n    top: -10000,\n    width: 1,\n    height: 1,\n    overflow: 'hidden',\n    opacity: 0,\n  },\n  hiddenMap: {\n    width: 1,\n    height: 1,\n  },\n  mapView: {\n    width: 1,\n    height: 1,\n  },\n});\n\nMapPreloaderComponent.displayName = 'MapPreloader';\n\nexport default MapPreloaderComponent;"]}

package/build/hooks/useMapPreload.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 地图预加载 Hook
+ * 提供便捷的 React Hook 来管理地图预加载
+ */
+import { PreloadConfig, PreloadStatus } from '../utils/MapPreloader';
+/**
+ * Hook 返回值
+ */
+export interface UseMapPreloadReturn {
+    /** 当前预加载状态 */
+    status: PreloadStatus;
+    /** 是否正在预加载 */
+    isLoading: boolean;
+    /** 是否已准备就绪 */
+    isReady: boolean;
+    /** 是否发生错误 */
+    hasError: boolean;
+    /** 预加载统计信息 */
+    stats: {
+        total: number;
+        ready: number;
+        loading: number;
+        error: number;
+    };
+    /** 手动开始预加载 */
+    startPreload: () => void;
+    /** 停止预加载 */
+    stopPreload: () => void;
+    /** 清理预加载实例 */
+    clearInstances: () => void;
+    /** 获取一个预加载实例 */
+    getPreloadedInstance: () => string | null;
+}
+/**
+ * 地图预加载 Hook
+ *
+ * @param config 预加载配置
+ * @param autoStart 是否自动开始预加载，默认为 true
+ * @returns 预加载状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { status, isReady, startPreload } = useMapPreload({
+ *     poolSize: 2,
+ *     delay: 1000,
+ *   });
+ *
+ *   return (
+ *     <View>
+ *       <Text>预加载状态: {status}</Text>
+ *       {isReady && <MapView />}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMapPreload(config?: PreloadConfig, autoStart?: boolean): UseMapPreloadReturn;
+/**
+ * 简化版 Hook - 只返回预加载状态
+ *
+ * @param config 预加载配置
+ * @returns 预加载状态
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const isReady = useMapPreloadStatus({ poolSize: 1 });
+ *
+ *   if (!isReady) {
+ *     return <LoadingScreen />;
+ *   }
+ *
+ *   return <MapView />;
+ * }
+ * ```
+ */
+export declare function useMapPreloadStatus(config?: PreloadConfig): boolean;
+//# sourceMappingURL=useMapPreload.d.ts.map

package/build/hooks/useMapPreload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapPreload.d.ts","sourceRoot":"","sources":["../../src/hooks/useMapPreload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAgB,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc;IACd,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY;IACZ,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc;IACd,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB;IAChB,oBAAoB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,CAAC,EAAE,aAAa,EACtB,SAAS,GAAE,OAAc,GACxB,mBAAmB,CAwFrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAGnE"}

package/build/hooks/useMapPreload.js

@@ -0,0 +1,130 @@
+/**
+ * 地图预加载 Hook
+ * 提供便捷的 React Hook 来管理地图预加载
+ */
+import { useEffect, useState, useCallback, useRef } from 'react';
+import { MapPreloader } from '../utils/MapPreloader';
+/**
+ * 地图预加载 Hook
+ *
+ * @param config 预加载配置
+ * @param autoStart 是否自动开始预加载，默认为 true
+ * @returns 预加载状态和控制方法
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { status, isReady, startPreload } = useMapPreload({
+ *     poolSize: 2,
+ *     delay: 1000,
+ *   });
+ *
+ *   return (
+ *     <View>
+ *       <Text>预加载状态: {status}</Text>
+ *       {isReady && <MapView />}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function useMapPreload(config, autoStart = true) {
+    const [status, setStatus] = useState(() => MapPreloader.getStatus());
+    const [stats, setStats] = useState(() => MapPreloader.getStats());
+    const configRef = useRef(config);
+    const autoStartRef = useRef(autoStart);
+    // 更新配置引用
+    useEffect(() => {
+        configRef.current = config;
+    }, [config]);
+    // 更新自动启动引用
+    useEffect(() => {
+        autoStartRef.current = autoStart;
+    }, [autoStart]);
+    // 更新统计信息
+    const updateStats = useCallback(() => {
+        setStats(MapPreloader.getStats());
+    }, []);
+    // 监听状态变化
+    useEffect(() => {
+        const unsubscribe = MapPreloader.addListener((newStatus) => {
+            setStatus(newStatus);
+            updateStats();
+        });
+        return () => {
+            unsubscribe();
+        };
+    }, [updateStats]);
+    // 配置并自动启动预加载
+    useEffect(() => {
+        if (configRef.current) {
+            MapPreloader.configure(configRef.current);
+        }
+        if (autoStartRef.current) {
+            MapPreloader.startPreload();
+        }
+        // 组件卸载时清理
+        return () => {
+            if (autoStartRef.current) {
+                MapPreloader.stopPreload();
+            }
+        };
+    }, []); // 只在挂载时执行一次
+    // 手动开始预加载
+    const startPreload = useCallback(() => {
+        if (configRef.current) {
+            MapPreloader.configure(configRef.current);
+        }
+        MapPreloader.startPreload();
+    }, []);
+    // 停止预加载
+    const stopPreload = useCallback(() => {
+        MapPreloader.stopPreload();
+    }, []);
+    // 清理预加载实例
+    const clearInstances = useCallback(() => {
+        MapPreloader.clearPreloadedInstances();
+        updateStats();
+    }, [updateStats]);
+    // 获取预加载实例
+    const getPreloadedInstance = useCallback(() => {
+        const instance = MapPreloader.getPreloadedInstance();
+        updateStats();
+        return instance;
+    }, [updateStats]);
+    return {
+        status,
+        isLoading: status === 'loading',
+        isReady: status === 'ready',
+        hasError: status === 'error',
+        stats,
+        startPreload,
+        stopPreload,
+        clearInstances,
+        getPreloadedInstance,
+    };
+}
+/**
+ * 简化版 Hook - 只返回预加载状态
+ *
+ * @param config 预加载配置
+ * @returns 预加载状态
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const isReady = useMapPreloadStatus({ poolSize: 1 });
+ *
+ *   if (!isReady) {
+ *     return <LoadingScreen />;
+ *   }
+ *
+ *   return <MapView />;
+ * }
+ * ```
+ */
+export function useMapPreloadStatus(config) {
+    const { isReady } = useMapPreload(config, true);
+    return isReady;
+}
+//# sourceMappingURL=useMapPreload.js.map

package/build/hooks/useMapPreload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapPreload.js","sourceRoot":"","sources":["../../src/hooks/useMapPreload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,YAAY,EAAgC,MAAM,uBAAuB,CAAC;AA+BnF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,YAAqB,IAAI;IAEzB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACpF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAEvC,SAAS;IACT,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC7B,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,WAAW;IACX,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,OAAO,GAAG,SAAS,CAAC;IACnC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,SAAS;IACT,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS;IACT,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,EAAE;YACzD,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,aAAa;IACb,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,YAAY,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;QAED,UAAU;QACV,OAAO,GAAG,EAAE;YACV,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBACzB,YAAY,CAAC,WAAW,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY;IAEpB,UAAU;IACV,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,YAAY,CAAC,YAAY,EAAE,CAAC;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,QAAQ;IACR,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,UAAU;IACV,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,YAAY,CAAC,uBAAuB,EAAE,CAAC;QACvC,WAAW,EAAE,CAAC;IAChB,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,UAAU;IACV,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACrD,WAAW,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,OAAO;QACL,MAAM;QACN,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,OAAO,EAAE,MAAM,KAAK,OAAO;QAC3B,QAAQ,EAAE,MAAM,KAAK,OAAO;QAC5B,KAAK;QACL,YAAY;QACZ,WAAW;QACX,cAAc;QACd,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * 地图预加载 Hook\n * 提供便捷的 React Hook 来管理地图预加载\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport { MapPreloader, PreloadConfig, PreloadStatus } from '../utils/MapPreloader';\n\n/**\n * Hook 返回值\n */\nexport interface UseMapPreloadReturn {\n  /** 当前预加载状态 */\n  status: PreloadStatus;\n  /** 是否正在预加载 */\n  isLoading: boolean;\n  /** 是否已准备就绪 */\n  isReady: boolean;\n  /** 是否发生错误 */\n  hasError: boolean;\n  /** 预加载统计信息 */\n  stats: {\n    total: number;\n    ready: number;\n    loading: number;\n    error: number;\n  };\n  /** 手动开始预加载 */\n  startPreload: () => void;\n  /** 停止预加载 */\n  stopPreload: () => void;\n  /** 清理预加载实例 */\n  clearInstances: () => void;\n  /** 获取一个预加载实例 */\n  getPreloadedInstance: () => string | null;\n}\n\n/**\n * 地图预加载 Hook\n * \n * @param config 预加载配置\n * @param autoStart 是否自动开始预加载，默认为 true\n * @returns 预加载状态和控制方法\n * \n * @example\n * ```tsx\n * function App() {\n *   const { status, isReady, startPreload } = useMapPreload({\n *     poolSize: 2,\n *     delay: 1000,\n *   });\n * \n *   return (\n *     <View>\n *       <Text>预加载状态: {status}</Text>\n *       {isReady && <MapView />}\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useMapPreload(\n  config?: PreloadConfig,\n  autoStart: boolean = true\n): UseMapPreloadReturn {\n  const [status, setStatus] = useState<PreloadStatus>(() => MapPreloader.getStatus());\n  const [stats, setStats] = useState(() => MapPreloader.getStats());\n  const configRef = useRef(config);\n  const autoStartRef = useRef(autoStart);\n\n  // 更新配置引用\n  useEffect(() => {\n    configRef.current = config;\n  }, [config]);\n\n  // 更新自动启动引用\n  useEffect(() => {\n    autoStartRef.current = autoStart;\n  }, [autoStart]);\n\n  // 更新统计信息\n  const updateStats = useCallback(() => {\n    setStats(MapPreloader.getStats());\n  }, []);\n\n  // 监听状态变化\n  useEffect(() => {\n    const unsubscribe = MapPreloader.addListener((newStatus) => {\n      setStatus(newStatus);\n      updateStats();\n    });\n\n    return () => {\n      unsubscribe();\n    };\n  }, [updateStats]);\n\n  // 配置并自动启动预加载\n  useEffect(() => {\n    if (configRef.current) {\n      MapPreloader.configure(configRef.current);\n    }\n\n    if (autoStartRef.current) {\n      MapPreloader.startPreload();\n    }\n\n    // 组件卸载时清理\n    return () => {\n      if (autoStartRef.current) {\n        MapPreloader.stopPreload();\n      }\n    };\n  }, []); // 只在挂载时执行一次\n\n  // 手动开始预加载\n  const startPreload = useCallback(() => {\n    if (configRef.current) {\n      MapPreloader.configure(configRef.current);\n    }\n    MapPreloader.startPreload();\n  }, []);\n\n  // 停止预加载\n  const stopPreload = useCallback(() => {\n    MapPreloader.stopPreload();\n  }, []);\n\n  // 清理预加载实例\n  const clearInstances = useCallback(() => {\n    MapPreloader.clearPreloadedInstances();\n    updateStats();\n  }, [updateStats]);\n\n  // 获取预加载实例\n  const getPreloadedInstance = useCallback(() => {\n    const instance = MapPreloader.getPreloadedInstance();\n    updateStats();\n    return instance;\n  }, [updateStats]);\n\n  return {\n    status,\n    isLoading: status === 'loading',\n    isReady: status === 'ready',\n    hasError: status === 'error',\n    stats,\n    startPreload,\n    stopPreload,\n    clearInstances,\n    getPreloadedInstance,\n  };\n}\n\n/**\n * 简化版 Hook - 只返回预加载状态\n * \n * @param config 预加载配置\n * @returns 预加载状态\n * \n * @example\n * ```tsx\n * function App() {\n *   const isReady = useMapPreloadStatus({ poolSize: 1 });\n * \n *   if (!isReady) {\n *     return <LoadingScreen />;\n *   }\n * \n *   return <MapView />;\n * }\n * ```\n */\nexport function useMapPreloadStatus(config?: PreloadConfig): boolean {\n  const { isReady } = useMapPreload(config, true);\n  return isReady;\n}"]}

package/build/index.d.ts

@@ -6,6 +6,12 @@ export { default as MapView } from './ExpoGaodeMapView';
 export type { MapViewRef } from './ExpoGaodeMapView';
 export { Marker, Polyline, Polygon, Circle, HeatMap, MultiPoint, Cluster, } from './components/overlays';
 export { requireModule, OptionalModules, getInstalledModules, printModuleInfo, createLazyLoader, } from './utils/ModuleLoader';
+export { MapPreloader, preloadMap, getPreloadStatus, clearPreloadedMaps, } from './utils/MapPreloader';
+export type { PreloadConfig, PreloadStatus } from './utils/MapPreloader';
+export { useMapPreload, useMapPreloadStatus } from './hooks/useMapPreload';
+export type { UseMapPreloadReturn } from './hooks/useMapPreload';
+export { default as MapPreloaderComponent } from './components/MapPreloader';
+export type { MapPreloaderProps } from './components/MapPreloader';
 export { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';
 export { default } from './ExpoGaodeMapModule';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/build/index.js

@@ -9,6 +9,12 @@ export { default as MapView } from './ExpoGaodeMapView';
 export { Marker, Polyline, Polygon, Circle, HeatMap, MultiPoint, Cluster, } from './components/overlays';
 // 导出模块检测工具
 export { requireModule, OptionalModules, getInstalledModules, printModuleInfo, createLazyLoader, } from './utils/ModuleLoader';
+// 导出地图预加载功能
+export { MapPreloader, preloadMap, getPreloadStatus, clearPreloadedMaps, } from './utils/MapPreloader';
+// 导出预加载 Hook
+export { useMapPreload, useMapPreloadStatus } from './hooks/useMapPreload';
+// 导出预加载组件
+export { default as MapPreloaderComponent } from './components/MapPreloader';
 // 导出便捷读取的 SDK 配置与 webKey
 export { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';
 // 默认导出原生模块

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKrE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\n\n// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块 - 直接使用，无需封装\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 从 ExpoGaodeMapModule 重新导出类型，方便使用\nexport type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 导出便捷读取的 SDK 配置与 webKey\nexport { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,qBAAqB;AACrB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAKrE,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,UAAU;AACV,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG7E,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["\n// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块 - 直接使用，无需封装\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 从 ExpoGaodeMapModule 重新导出类型，方便使用\nexport type { SDKConfig, PermissionStatus } from './ExpoGaodeMapModule';\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 导出模块检测工具\nexport {\n  requireModule,\n  OptionalModules,\n  getInstalledModules,\n  printModuleInfo,\n  createLazyLoader,\n} from './utils/ModuleLoader';\n\n// 导出地图预加载功能\nexport {\n  MapPreloader,\n  preloadMap,\n  getPreloadStatus,\n  clearPreloadedMaps,\n} from './utils/MapPreloader';\nexport type { PreloadConfig, PreloadStatus } from './utils/MapPreloader';\n\n// 导出预加载 Hook\nexport { useMapPreload, useMapPreloadStatus } from './hooks/useMapPreload';\nexport type { UseMapPreloadReturn } from './hooks/useMapPreload';\n\n// 导出预加载组件\nexport { default as MapPreloaderComponent } from './components/MapPreloader';\nexport type { MapPreloaderProps } from './components/MapPreloader';\n\n// 导出便捷读取的 SDK 配置与 webKey\nexport { getSDKConfig, getWebKey } from './ExpoGaodeMapModule';\n\n// 默认导出原生模块\nexport { default } from './ExpoGaodeMapModule';\n"]}

package/build/utils/MapPreloader.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 地图预加载管理器
+ * 统一的预加载 API，自动选择原生或 JS 层预加载
+ * - 如果原生预加载可用，优先使用原生方案（性能提升 60-80%）
+ * - 否则回退到 JS 层预加载（性能提升 5-25%）
+ */
+/**
+ * 预加载配置
+ */
+export interface PreloadConfig {
+    /** 预加载的地图数量，默认为 1 */
+    poolSize?: number;
+    /** 预加载延迟时间（毫秒），默认为 0（立即预加载） */
+    delay?: number;
+    /** 是否启用预加载，默认为 true */
+    enabled?: boolean;
+    /** 预加载超时时间（毫秒），默认为 15000（15秒） */
+    timeout?: number;
+    /** 预加载策略：'native' | 'js' | 'auto' | 'hybrid'，默认为 'auto' */
+    strategy?: PreloadStrategy;
+    /** 超时后是否自动回退到 JS 预加载，默认为 true */
+    fallbackOnTimeout?: boolean;
+}
+/**
+ * 预加载状态
+ */
+export type PreloadStatus = 'idle' | 'loading' | 'ready' | 'error';
+/**
+ * 预加载策略
+ * - 'native': 仅使用原生预加载
+ * - 'js': 仅使用 JS 层预加载
+ * - 'auto': 自动选择（优先原生，不可用时用 JS）
+ * - 'hybrid': 同时启动原生和 JS，谁先完成用谁（最快最可靠）
+ */
+export type PreloadStrategy = 'native' | 'js' | 'auto' | 'hybrid';
+/**
+ * 地图预加载管理器类
+ * 单例模式，管理地图实例的预加载
+ */
+declare class MapPreloaderManager {
+    private static instance;
+    private preloadInstances;
+    private config;
+    private currentStrategy;
+    private hybridNativeReady;
+    private hybridJSReady;
+    private nativePreloadAvailable;
+    private preloadTimer;
+    private listeners;
+    private isPreloading;
+    private activeCheckInterval;
+    private activeTimeoutTimer;
+    private constructor();
+    /**
+     * 检测并处理热重载
+     */
+    private detectAndHandleHotReload;
+    /**
+     * 获取管理器单例实例
+     */
+    static getInstance(): MapPreloaderManager;
+    /**
+     * 配置预加载参数
+     * @param config 预加载配置
+     */
+    configure(config: PreloadConfig): void;
+    /**
+     * 检测并选择最优预加载策略
+     */
+    private detectStrategy;
+    /**
+     * 检查原生预加载是否可用
+     */
+    private checkNativePreloadAvailable;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): Required<PreloadConfig>;
+    /**
+     * 开始预加载
+     * 根据配置和策略选择最优的预加载方式
+     */
+    startPreload(): void;
+    /**
+     * 执行混合预加载（同时启动原生和 JS）
+     */
+    private executeHybridPreload;
+    /**
+     * 混合模式下的原生预加载
+     */
+    private executeHybridNativePreload;
+    /**
+     * 混合模式下的 JS 预加载
+     */
+    private executeHybridJSPreload;
+    /**
+     * 清理活动的定时器
+     */
+    private cleanupActiveTimers;
+    /**
+     * 执行原生预加载
+     */
+    private executeNativePreload;
+    /**
+     * 执行 JS 层预加载逻辑
+     */
+    private executeJSPreload;
+    /**
+     * 停止预加载
+     */
+    stopPreload(): void;
+    /**
+     * 清理所有预加载实例
+     */
+    clearPreloadedInstances(): void;
+    /**
+     * 获取一个可用的预加载实例
+     * @returns 预加载实例 ID，如果没有可用实例则返回 null
+     */
+    getPreloadedInstance(): string | null;
+    /**
+     * 获取预加载状态
+     */
+    getStatus(): PreloadStatus;
+    /**
+     * 获取当前使用的预加载策略
+     */
+    getCurrentStrategy(): 'native' | 'js' | 'hybrid';
+    /**
+     * 检查原生预加载是否可用
+     */
+    isNativePreloadAvailable(): boolean;
+    /**
+     * 获取预加载实例数量统计
+     */
+    getStats(): {
+        total: number;
+        ready: number;
+        loading: number;
+        error: number;
+        strategy: 'native' | 'js' | 'hybrid';
+    };
+    /**
+     * 添加状态监听器
+     * @param listener 状态变化回调函数
+     * @returns 取消监听的函数
+     */
+    addListener(listener: (status: PreloadStatus) => void): () => void;
+    /**
+     * 通知所有监听器状态变化
+     */
+    private notifyListeners;
+    /**
+     * 重置管理器状态
+     */
+    reset(): void;
+}
+/**
+ * 导出单例实例
+ */
+export declare const MapPreloader: MapPreloaderManager;
+/**
+ * 便捷函数：配置并启动预加载
+ * @param config 预加载配置
+ */
+export declare function preloadMap(config?: PreloadConfig): void;
+/**
+ * 便捷函数：获取预加载状态
+ */
+export declare function getPreloadStatus(): PreloadStatus;
+/**
+ * 便捷函数：清理预加载实例
+ */
+export declare function clearPreloadedMaps(): void;
+export {};
+//# sourceMappingURL=MapPreloader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MapPreloader.d.ts","sourceRoot":"","sources":["../../src/utils/MapPreloader.ts"],"names":[],"mappings":"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"}