miaoda-expo-devkit 0.1.1-beta.70 → 0.1.1-beta.72

package/dist/metro.d.mts

@@ -448,11 +448,23 @@ declare function withWasmSupport(config: MetroConfig): MetroConfig;
 declare function withTransformLogger(config: MetroConfig): MetroConfig;
 
 /**
- * withPersistentCache — 将 Metro transform cache 固定到可持久化目录
+ * withPersistentCache — 将 Metro transform cache 和 FileMap cache 固定到可持久化目录
  *
- * Metro 默认将 transform cache 写入系统临时目录（os.tmpdir()/metro-cache），
- * 系统随时可以清理，导致每次重启都是冷启动。
- * 此 wrapper 将 cacheStores 替换为指定目录，持久保留。
+ * Metro 默认将两套缓存写入系统临时目录（os.tmpdir()），系统随时可以清理，
+ * 导致每次重启都是冷启动。此 wrapper 将它们统一固定到同一个持久化目录。
+ *
+ * 【两套缓存的作用】
+ *   transform cache（cacheStores）
+ *     — JS/TS 编译结果，命中后跳过 Babel transform，节省 bundling 时间。
+ *   FileMap cache（fileMapCacheDirectory）
+ *     — 文件系统索引快照 + Watchman clock。命中后：
+ *       · 有 Watchman：Metro 发 since=<clock> 增量查询，只拿变化文件，O(changes)。
+ *       · 无 Watchman：跳过 mtime 未变文件的重新处理，减少 hash/resolve 工作量。
+ *     两种情况都能显著加快 Metro 冷启动速度。
+ *
+ * 【autoSaveCache】
+ *   运行时每隔 debounceMs（默认 5s）将 FileMap cache 写回磁盘，保证进程意外退出
+ *   后下次启动仍能命中缓存（默认只在正常关闭时写入）。
  *
  * 缓存路径解析优先级（高到低）：
  *   1. 环境变量 METRO_CACHE_DIR（绝对路径，适用于容器/CI 挂载外部持久目录）
@@ -466,7 +478,7 @@ declare function withTransformLogger(config: MetroConfig): MetroConfig;
  *   {
  *     "type": "CACHE_CONFIG",
  *     "cache_root": "/workspace/.metro-cache",
- *     "store_class": "ExpoFileStore",    // 生效的 store 类名
+ *     "store_class": "ExpoFileStore",
  *     "source": "env" | "option" | "default",
  *     "t": 1234567890
  *   }

package/dist/metro.d.ts

@@ -448,11 +448,23 @@ declare function withWasmSupport(config: MetroConfig): MetroConfig;
 declare function withTransformLogger(config: MetroConfig): MetroConfig;
 
 /**
- * withPersistentCache — 将 Metro transform cache 固定到可持久化目录
+ * withPersistentCache — 将 Metro transform cache 和 FileMap cache 固定到可持久化目录
  *
- * Metro 默认将 transform cache 写入系统临时目录（os.tmpdir()/metro-cache），
- * 系统随时可以清理，导致每次重启都是冷启动。
- * 此 wrapper 将 cacheStores 替换为指定目录，持久保留。
+ * Metro 默认将两套缓存写入系统临时目录（os.tmpdir()），系统随时可以清理，
+ * 导致每次重启都是冷启动。此 wrapper 将它们统一固定到同一个持久化目录。
+ *
+ * 【两套缓存的作用】
+ *   transform cache（cacheStores）
+ *     — JS/TS 编译结果，命中后跳过 Babel transform，节省 bundling 时间。
+ *   FileMap cache（fileMapCacheDirectory）
+ *     — 文件系统索引快照 + Watchman clock。命中后：
+ *       · 有 Watchman：Metro 发 since=<clock> 增量查询，只拿变化文件，O(changes)。
+ *       · 无 Watchman：跳过 mtime 未变文件的重新处理，减少 hash/resolve 工作量。
+ *     两种情况都能显著加快 Metro 冷启动速度。
+ *
+ * 【autoSaveCache】
+ *   运行时每隔 debounceMs（默认 5s）将 FileMap cache 写回磁盘，保证进程意外退出
+ *   后下次启动仍能命中缓存（默认只在正常关闭时写入）。
  *
  * 缓存路径解析优先级（高到低）：
  *   1. 环境变量 METRO_CACHE_DIR（绝对路径，适用于容器/CI 挂载外部持久目录）
@@ -466,7 +478,7 @@ declare function withTransformLogger(config: MetroConfig): MetroConfig;
  *   {
  *     "type": "CACHE_CONFIG",
  *     "cache_root": "/workspace/.metro-cache",
- *     "store_class": "ExpoFileStore",    // 生效的 store 类名
+ *     "store_class": "ExpoFileStore",
  *     "source": "env" | "option" | "default",
  *     "t": 1234567890
  *   }

package/dist/metro.js

@@ -615,7 +615,17 @@ function withPersistentCache(config, options = {}) {
   }
   return {
     ...config,
-    cacheStores: [new StoreClass({ root: cacheRoot })]
+    // transform cache：JS/TS 编译结果
+    cacheStores: [new StoreClass({ root: cacheRoot })],
+    // FileMap cache：文件系统索引快照 + Watchman clock
+    // 与 transform cache 放同一目录，文件名由 Metro 按 projectRoot+config hash 自动区分
+    fileMapCacheDirectory: cacheRoot,
+    watcher: {
+      ...config.watcher,
+      // 运行时文件变化后自动将 FileMap cache 写回磁盘（debounce 5s）
+      // 保证进程意外退出后下次启动仍能命中缓存
+      unstable_autoSaveCache: { enabled: true }
+    }
   };
 }
 

package/dist/metro.mjs

@@ -566,7 +566,17 @@ function withPersistentCache(config, options = {}) {
   }
   return {
     ...config,
-    cacheStores: [new StoreClass({ root: cacheRoot })]
+    // transform cache：JS/TS 编译结果
+    cacheStores: [new StoreClass({ root: cacheRoot })],
+    // FileMap cache：文件系统索引快照 + Watchman clock
+    // 与 transform cache 放同一目录，文件名由 Metro 按 projectRoot+config hash 自动区分
+    fileMapCacheDirectory: cacheRoot,
+    watcher: {
+      ...config.watcher,
+      // 运行时文件变化后自动将 FileMap cache 写回磁盘（debounce 5s）
+      // 保证进程意外退出后下次启动仍能命中缓存
+      unstable_autoSaveCache: { enabled: true }
+    }
   };
 }
 

package/dist/rules/no-unused-expo-plugin.js

@@ -126,7 +126,8 @@ var PACKAGES_WITHOUT_CONFIG_PLUGIN = /* @__PURE__ */ new Set([
   "expo-store-review",
   "expo-symbols",
   "expo-ui",
-  "expo-video-thumbnails"
+  "expo-video-thumbnails",
+  "react-native-webview"
 ]);
 var pluginsCache = /* @__PURE__ */ new Map();
 var depsCache = /* @__PURE__ */ new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-expo-devkit",
-  "version": "0.1.1-beta.70",
+  "version": "0.1.1-beta.72",
   "description": "Expo 应用开发工具集：Sentry DSN 替换 stub、错误/网络捕获、Metro 符号化",
   "license": "MIT",
   "main": "./dist/index.js",