ms-vite-plugin 1.0.2 → 1.0.4

package/dist/device.js

@@ -0,0 +1,325 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOnDevice = runOnDevice;
+exports.runUIOnDevice = runUIOnDevice;
+exports.stopOnDevice = stopOnDevice;
+const fsExtra = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const build_js_1 = require("./build.js");
+/**
+ * 读取并校验设备连接参数
+ * @param options 命令选项
+ * @returns 返回标准化后的设备地址信息
+ * @example
+ * parseDeviceOptions({ ip: "192.168.1.10", port: "9800" })
+ */
+function parseDeviceOptions(options) {
+    const ip = options.ip?.trim();
+    const portText = (options.port ?? "9800").trim();
+    const port = Number.parseInt(portText, 10);
+    if (!ip) {
+        throw new Error("请通过 --ip 指定设备 IP 地址");
+    }
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`无效端口: ${portText}`);
+    }
+    return { ip, port };
+}
+/**
+ * 计算 Buffer 的 CRC32 值
+ * @param input 二进制输入数据
+ * @returns CRC32 十六进制字符串（8位）
+ * @example
+ * calculateCrc32FromBuffer(Buffer.from("hello"))
+ */
+function calculateCrc32FromBuffer(input) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < input.length; i += 1) {
+        crc ^= input[i];
+        for (let j = 0; j < 8; j += 1) {
+            if ((crc & 1) === 1) {
+                crc = (crc >>> 1) ^ 0xedb88320;
+            }
+            else {
+                crc >>>= 1;
+            }
+        }
+    }
+    const finalValue = (crc ^ 0xffffffff) >>> 0;
+    return finalValue.toString(16).padStart(8, "0");
+}
+/**
+ * 计算文件的 CRC32 值
+ * @param filePath 文件路径
+ * @returns CRC32 十六进制字符串（8位）
+ * @example
+ * await calculateCrc32("/tmp/a.txt")
+ */
+async function calculateCrc32(filePath) {
+    const fileBuffer = await fsExtra.readFile(filePath);
+    return calculateCrc32FromBuffer(fileBuffer);
+}
+/**
+ * 递归收集目录中的所有文件
+ * @param rootDir 需要遍历的根目录
+ * @param bundlePrefix 输出到设备时的目录前缀
+ * @returns 返回可同步文件列表（含 size 与 crc32）
+ * @example
+ * await collectFilesInDir("/tmp/project/ui", "ui")
+ */
+async function collectFilesInDir(rootDir, bundlePrefix) {
+    const files = [];
+    async function walk(dir) {
+        const entries = await fsExtra.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                const relPath = path.relative(rootDir, fullPath).replace(/\\/g, "/");
+                const stat = await fsExtra.stat(fullPath);
+                files.push({
+                    path: fullPath,
+                    bundlePath: `${bundlePrefix}/${relPath}`,
+                    size: stat.size,
+                    crc32: await calculateCrc32(fullPath),
+                });
+            }
+        }
+    }
+    if (await fsExtra.pathExists(rootDir)) {
+        await walk(rootDir);
+    }
+    return files;
+}
+/**
+ * 读取项目运行所需的元信息
+ * @param workspacePath 项目根目录
+ * @returns 返回 projectName、appVersion 与 packageJsonPath
+ * @example
+ * await getProjectMeta("/Users/demo/project")
+ */
+async function getProjectMeta(workspacePath) {
+    const packageJsonPath = path.join(workspacePath, "package.json");
+    const packageJson = await fsExtra.readJSON(packageJsonPath);
+    const projectName = packageJson.name;
+    const appVersion = packageJson.appVersion;
+    if (!projectName) {
+        throw new Error("请在 package.json 中添加 name 字段");
+    }
+    if (!appVersion) {
+        throw new Error("请在 package.json 中添加 appVersion 字段");
+    }
+    return { projectName, appVersion, packageJsonPath };
+}
+/**
+ * 收集运行前需要同步的文件
+ * @param workspacePath 项目根目录
+ * @returns 返回项目文件清单（含 size 与 crc32）
+ * @example
+ * await collectProjectFiles("/Users/demo/project")
+ */
+async function collectProjectFiles(workspacePath) {
+    const scriptDistPath = path.join(workspacePath, "dist", "scripts");
+    const scriptSrcPath = path.join(workspacePath, "scripts");
+    const uiPath = path.join(workspacePath, "ui");
+    const resPath = path.join(workspacePath, "res");
+    const packageJsonPath = path.join(workspacePath, "package.json");
+    const useDistScripts = await fsExtra.pathExists(scriptDistPath);
+    const scriptPath = useDistScripts ? scriptDistPath : scriptSrcPath;
+    const files = [
+        {
+            path: packageJsonPath,
+            bundlePath: "package.json",
+            size: (await fsExtra.stat(packageJsonPath)).size,
+            crc32: await calculateCrc32(packageJsonPath),
+        },
+    ];
+    const [scriptFiles, uiFiles, resFiles] = await Promise.all([
+        collectFilesInDir(scriptPath, "scripts"),
+        collectFilesInDir(uiPath, "ui"),
+        collectFilesInDir(resPath, "res"),
+    ]);
+    files.push(...scriptFiles, ...uiFiles, ...resFiles);
+    return files;
+}
+/**
+ * 获取设备上的文件列表
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @param projectName 项目名称
+ * @returns 设备当前文件信息列表
+ * @example
+ * await listDeviceFiles("192.168.1.10", 9800, "demo")
+ */
+async function listDeviceFiles(ip, port, projectName) {
+    const url = new URL(`http://${ip}:${port}/api/files`);
+    url.searchParams.set("projectName", projectName);
+    const response = await fetch(url.toString(), { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`文件列表请求失败: ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return Array.isArray(data) ? data : [];
+}
+/**
+ * 将项目文件增量同步到设备
+ * @param workspacePath 项目根目录
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @returns 同步完成后返回 Promise<void>
+ * @example
+ * await syncProjectToDevice("/Users/demo/project", "192.168.1.10", 9800)
+ */
+async function syncProjectToDevice(workspacePath, ip, port) {
+    const { projectName, appVersion } = await getProjectMeta(workspacePath);
+    console.log("🔎 正在获取设备文件列表...");
+    const deviceFiles = await listDeviceFiles(ip, port, projectName);
+    const deviceFileMap = new Map(deviceFiles.map((file) => [file.path, file]));
+    console.log("📂 正在分析项目文件...");
+    const files = await collectProjectFiles(workspacePath);
+    const filesToSync = [];
+    for (const file of files) {
+        const deviceFile = deviceFileMap.get(file.bundlePath);
+        const requireSyncFile = file.bundlePath.includes("main.js") ||
+            file.bundlePath.includes("main.py");
+        if (!deviceFile) {
+            filesToSync.push(file);
+            continue;
+        }
+        const changed = deviceFile.size !== file.size ||
+            deviceFile.crc32.toLowerCase() !== file.crc32.toLowerCase();
+        if (requireSyncFile || changed) {
+            filesToSync.push(file);
+        }
+    }
+    console.log(`📦 发现 ${filesToSync.length} 个文件需要同步`);
+    if (filesToSync.length === 0) {
+        console.log("✅ 无需同步文件");
+        return;
+    }
+    let syncedCount = 0;
+    for (const file of filesToSync) {
+        syncedCount += 1;
+        console.log(`⬆️  [${syncedCount}/${filesToSync.length}] 同步 ${file.bundlePath}`);
+        const binary = await fsExtra.readFile(file.path);
+        const url = new URL(`http://${ip}:${port}/debug/patchSync`);
+        url.searchParams.set("path", file.bundlePath);
+        url.searchParams.set("projectName", projectName);
+        url.searchParams.set("appVersion", appVersion);
+        const response = await fetch(url.toString(), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/octet-stream",
+            },
+            body: binary,
+        });
+        if (!response.ok) {
+            throw new Error(`同步失败: ${file.bundlePath} (状态码: ${response.status})`);
+        }
+    }
+    console.log(`✅ 同步完成，共 ${filesToSync.length} 个文件`);
+}
+/**
+ * 发送设备动作请求
+ * @param action 动作名称，支持 run 与 stop
+ * @param ip 设备 IP 地址
+ * @param port 设备端口
+ * @returns 请求成功时返回 Promise<void>
+ * @example
+ * await requestDeviceAction("stop", "192.168.1.10", 9800)
+ */
+async function requestDeviceAction(action, ip, port) {
+    const url = `http://${ip}:${port}/api/${action}`;
+    const response = await fetch(url, { method: "GET" });
+    if (!response.ok) {
+        throw new Error(`${action} 失败，状态码: ${response.status}`);
+    }
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+async function runOnDevice(options) {
+    const workspacePath = options.path
+        ? path.resolve(options.path)
+        : process.cwd();
+    const { ip, port } = parseDeviceOptions(options);
+    console.log(`🔧 开始构建项目: ${workspacePath}`);
+    await (0, build_js_1.buildAll)(true, workspacePath);
+    console.log(`📦 开始同步项目到设备: ${ip}:${port}`);
+    await syncProjectToDevice(workspacePath, ip, port);
+    console.log(`🚀 开始运行项目: ${ip}:${port}`);
+    await requestDeviceAction("run", ip, port);
+    console.log("✅ 运行请求已发送");
+}
+/**
+ * 在设备上预览 UI（先同步后调用 runUI）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+async function runUIOnDevice(options) {
+    const workspacePath = options.path
+        ? path.resolve(options.path)
+        : process.cwd();
+    const { ip, port } = parseDeviceOptions(options);
+    console.log(`🔧 开始构建项目: ${workspacePath}`);
+    await (0, build_js_1.buildAll)(true, workspacePath);
+    console.log(`📦 开始同步项目到设备: ${ip}:${port}`);
+    await syncProjectToDevice(workspacePath, ip, port);
+    console.log(`🖼️ 开始预览 UI: ${ip}:${port}`);
+    await requestDeviceAction("runUI", ip, port);
+    console.log("✅ UI 预览请求已发送");
+}
+/**
+ * 停止设备上的项目
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+async function stopOnDevice(options) {
+    const { ip, port } = parseDeviceOptions(options);
+    console.log(`🛑 开始停止项目: ${ip}:${port}`);
+    await requestDeviceAction("stop", ip, port);
+    console.log("✅ 停止请求已发送");
+}

package/dist/project.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 设备命令选项
+ */
+export interface DeviceCliOptions {
+    ip?: string;
+    port?: string;
+    transport?: string;
+    wsPort?: string;
+    wsWaitMs?: string;
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 在设备上预览 UI（先同步后调用 runUI）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runUIOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 停止设备上的项目
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+export declare function stopOnDevice(options: DeviceCliOptions): Promise<void>;