miaoda-expo-devkit 0.1.1-beta.63 → 0.1.1-beta.65

package/dist/metro.d.mts

@@ -111,7 +111,7 @@ declare function withRouteEndpoint(config: MetroConfig, options: RouteEndpointOp
  * withDevkit — 一站式 Metro 配置入口
  *
  * 按固定顺序依次应用：
- *   withPersistentCache         — 将 Metro transform cache 固定到项目目录（.metro-cache/），重启不丢失
+ *   withPersistentCache         — 将 Metro transform cache 固定到持久目录（优先读取 METRO_CACHE_DIR 环境变量），重启不丢失
  *   withWorkspaceNodeModules    — 修复沙箱中 node_modules 位于祖先目录时的模块解析问题
  *   withWasmSupport             — 将 .wasm 加入 assetExts，修复 expo-sqlite web worker 打包失败
  *   withCssInterop              — 为 expo-image / expo-camera 等注入 NativeWind cssInterop
@@ -435,10 +435,16 @@ declare function withWasmSupport(config: MetroConfig): MetroConfig;
 declare function withTransformLogger(config: MetroConfig): MetroConfig;
 
 /**
- * withPersistentCache — 将 Metro transform cache 固定到项目目录
+ * withPersistentCache — 将 Metro transform cache 固定到可持久化目录
  *
- * 默认 Metro cache 位于系统临时目录，重启后丢失，每次都是冷启动。
- * 此 wrapper 将 cacheStores 替换为项目根目录下的 .metro-cache/，持久保留。
+ * Metro 默认将 transform cache 写入系统临时目录（os.tmpdir()/metro-cache），
+ * 系统随时可以清理，导致每次重启都是冷启动。
+ * 此 wrapper 将 cacheStores 替换为指定目录，持久保留。
+ *
+ * 缓存路径解析优先级（高到低）：
+ *   1. 环境变量 METRO_CACHE_DIR（绝对路径，适用于容器/CI 挂载外部持久目录）
+ *   2. options.cacheDir（绝对路径直接使用；相对路径拼接到 projectRoot）
+ *   3. 默认值：projectRoot/.metro-cache
  *
  * cache key 由文件内容 sha1 + 相对路径 + Babel/Metro 版本共同决定，
  * 与项目绝对路径无关，换目录 clone 后缓存同样有效。
@@ -446,7 +452,10 @@ declare function withTransformLogger(config: MetroConfig): MetroConfig;
 
 interface PersistentCacheOptions {
     /**
-     * cache 目录，相对于 projectRoot。默认：'.metro-cache'
+     * cache 目录。
+     * - 绝对路径：直接使用（适合挂载外部持久目录）
+     * - 相对路径：拼接到 projectRoot
+     * - 省略：使用环境变量 METRO_CACHE_DIR，否则默认 '.metro-cache'（相对 projectRoot）
      */
     cacheDir?: string;
 }

package/dist/metro.d.ts

@@ -111,7 +111,7 @@ declare function withRouteEndpoint(config: MetroConfig, options: RouteEndpointOp
  * withDevkit — 一站式 Metro 配置入口
  *
  * 按固定顺序依次应用：
- *   withPersistentCache         — 将 Metro transform cache 固定到项目目录（.metro-cache/），重启不丢失
+ *   withPersistentCache         — 将 Metro transform cache 固定到持久目录（优先读取 METRO_CACHE_DIR 环境变量），重启不丢失
  *   withWorkspaceNodeModules    — 修复沙箱中 node_modules 位于祖先目录时的模块解析问题
  *   withWasmSupport             — 将 .wasm 加入 assetExts，修复 expo-sqlite web worker 打包失败
  *   withCssInterop              — 为 expo-image / expo-camera 等注入 NativeWind cssInterop
@@ -435,10 +435,16 @@ declare function withWasmSupport(config: MetroConfig): MetroConfig;
 declare function withTransformLogger(config: MetroConfig): MetroConfig;
 
 /**
- * withPersistentCache — 将 Metro transform cache 固定到项目目录
+ * withPersistentCache — 将 Metro transform cache 固定到可持久化目录
  *
- * 默认 Metro cache 位于系统临时目录，重启后丢失，每次都是冷启动。
- * 此 wrapper 将 cacheStores 替换为项目根目录下的 .metro-cache/，持久保留。
+ * Metro 默认将 transform cache 写入系统临时目录（os.tmpdir()/metro-cache），
+ * 系统随时可以清理，导致每次重启都是冷启动。
+ * 此 wrapper 将 cacheStores 替换为指定目录，持久保留。
+ *
+ * 缓存路径解析优先级（高到低）：
+ *   1. 环境变量 METRO_CACHE_DIR（绝对路径，适用于容器/CI 挂载外部持久目录）
+ *   2. options.cacheDir（绝对路径直接使用；相对路径拼接到 projectRoot）
+ *   3. 默认值：projectRoot/.metro-cache
  *
  * cache key 由文件内容 sha1 + 相对路径 + Babel/Metro 版本共同决定，
  * 与项目绝对路径无关，换目录 clone 后缓存同样有效。
@@ -446,7 +452,10 @@ declare function withTransformLogger(config: MetroConfig): MetroConfig;
 
 interface PersistentCacheOptions {
     /**
-     * cache 目录，相对于 projectRoot。默认：'.metro-cache'
+     * cache 目录。
+     * - 绝对路径：直接使用（适合挂载外部持久目录）
+     * - 相对路径：拼接到 projectRoot
+     * - 省略：使用环境变量 METRO_CACHE_DIR，否则默认 '.metro-cache'（相对 projectRoot）
      */
     cacheDir?: string;
 }

package/dist/metro.js

@@ -561,11 +561,22 @@ var import_path13 = __toESM(require("path"));
 var import_metro_cache = require("metro-cache");
 function withPersistentCache(config, options = {}) {
   const projectRoot = config.projectRoot ?? process.cwd();
-  const { cacheDir = ".metro-cache" } = options;
-  const cacheRoot = import_path13.default.join(projectRoot, cacheDir);
+  const { cacheDir } = options;
+  const envCacheDir = process.env["METRO_CACHE_DIR"];
+  let cacheRoot;
+  if (envCacheDir) {
+    cacheRoot = envCacheDir;
+  } else if (cacheDir) {
+    cacheRoot = import_path13.default.isAbsolute(cacheDir) ? cacheDir : import_path13.default.join(projectRoot, cacheDir);
+  } else {
+    cacheRoot = import_path13.default.join(projectRoot, ".metro-cache");
+  }
+  const existingStores = config.cacheStores;
+  const firstStore = Array.isArray(existingStores) ? existingStores[0] : void 0;
+  const StoreClass = firstStore ? Object.getPrototypeOf(firstStore).constructor : import_metro_cache.FileStore;
   return {
     ...config,
-    cacheStores: [new import_metro_cache.FileStore({ root: cacheRoot })]
+    cacheStores: [new StoreClass({ root: cacheRoot })]
   };
 }
 

package/dist/metro.mjs

@@ -513,11 +513,22 @@ import path14 from "path";
 import { FileStore } from "metro-cache";
 function withPersistentCache(config, options = {}) {
   const projectRoot = config.projectRoot ?? process.cwd();
-  const { cacheDir = ".metro-cache" } = options;
-  const cacheRoot = path14.join(projectRoot, cacheDir);
+  const { cacheDir } = options;
+  const envCacheDir = process.env["METRO_CACHE_DIR"];
+  let cacheRoot;
+  if (envCacheDir) {
+    cacheRoot = envCacheDir;
+  } else if (cacheDir) {
+    cacheRoot = path14.isAbsolute(cacheDir) ? cacheDir : path14.join(projectRoot, cacheDir);
+  } else {
+    cacheRoot = path14.join(projectRoot, ".metro-cache");
+  }
+  const existingStores = config.cacheStores;
+  const firstStore = Array.isArray(existingStores) ? existingStores[0] : void 0;
+  const StoreClass = firstStore ? Object.getPrototypeOf(firstStore).constructor : FileStore;
   return {
     ...config,
-    cacheStores: [new FileStore({ root: cacheRoot })]
+    cacheStores: [new StoreClass({ root: cacheRoot })]
   };
 }
 

package/package.json

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