miaoda-expo-devkit 0.1.1-beta.71 → 0.1.1-beta.73

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,15 @@ function withPersistentCache(config, options = {}) {
   }
   return {
     ...config,
+    // transform cache：JS/TS 编译结果
     cacheStores: [new StoreClass({ root: cacheRoot })]
+    // FileMap cache 暂时禁用：pnpm install 每次重建 symlink 导致 30839 fake changes，
+    // 加载旧缓存反而比冷启动更慢，触发 120s 超时。
+    // fileMapCacheDirectory: cacheRoot,
+    // watcher: {
+    //   ...config.watcher,
+    //   unstable_autoSaveCache: { enabled: true },
+    // },
   };
 }
 

package/dist/metro.mjs

@@ -566,7 +566,15 @@ function withPersistentCache(config, options = {}) {
   }
   return {
     ...config,
+    // transform cache：JS/TS 编译结果
     cacheStores: [new StoreClass({ root: cacheRoot })]
+    // FileMap cache 暂时禁用：pnpm install 每次重建 symlink 导致 30839 fake changes，
+    // 加载旧缓存反而比冷启动更慢，触发 120s 超时。
+    // fileMapCacheDirectory: cacheRoot,
+    // watcher: {
+    //   ...config.watcher,
+    //   unstable_autoSaveCache: { enabled: true },
+    // },
   };
 }
 

package/package.json

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