@flun/desktop-builder 1.0.1

package/desktopAppConfig.js

@@ -0,0 +1,222 @@
+/**
+ * @flun/desktop-builder 配置文件
+ * 所有路径相对于项目根目录
+ */
+export default {
+	// 必填字段:serverPath,appUrl,appName;
+	serverPath: './server.js',           // 网站启动脚本路径
+	appUrl: 'http://www.abc.com:7296',   // 网站访问地址
+	appName: '我的桌面应用',              // 应用显示名称
+	enableLogging: false,                // 是否启用日志文件记录,默认关闭
+
+	// 窗口配置
+	window: {
+		width: 1200,                      // 默认宽度(px)
+		height: 800,                      // 默认高度(px)
+		minWidth: 800,                    // 最小宽度(px)
+		minHeight: 600,                   // 最小高度(px)
+		maxWidth: undefined,              // 最大宽度(px)，不限制则留空
+		maxHeight: undefined,             // 最大高度(px)，不限制则留空
+		resizable: true,                  // 是否可调整窗口大小
+		fullscreenable: true,             // 是否允许全屏
+		alwaysOnTop: false,               // 是否始终置顶
+		frame: true,                      // 是否显示标题栏
+		titleBarStyle: 'default',         // 标题栏样式: default/hidden/hiddenInset
+		backgroundColor: '#ffffff',      // 加载时的背景色
+		show: false,                       // false=等页面渲染完再显示，防白屏
+		webPreferences: {
+			// 注意：nodeIntegration、contextIsolation、sandbox 将被强制覆盖，此处配置无效
+			// 其他属性（如 plugins, webSecurity, enableWebAuthn 等）仍然生效
+			nodeIntegration: false,        // 此值无效，实际强制为 true
+			contextIsolation: true,        // 此值无效，实际强制为 false
+		},
+	},
+
+	// 图标
+	branding: {
+		appIcon: null,             		   // 应用图标路径，建议 512x512 PNG
+		installerIcon: null,    		   // 安装程序图标（必须 .ico）
+		uninstallerIcon: null   		   // 卸载程序图标（必须 .ico）
+	},
+
+	// 菜单配置（可自由修改语言和结构）
+	menu: [
+		{
+			label: '文件',
+			submenu: [
+				{ role: 'close', label: '关闭' },
+				{ type: 'separator' },
+				{ role: 'quit', label: '退出' }
+			]
+		},
+		{
+			label: '编辑',
+			submenu: [
+				{ role: 'undo', label: '撤销' },
+				{ role: 'redo', label: '重做' },
+				{ type: 'separator' },
+				{ role: 'cut', label: '剪切' },
+				{ role: 'copy', label: '复制' },
+				{ role: 'paste', label: '粘贴' },
+				{ role: 'selectAll', label: '全选' }
+			]
+		},
+		{
+			label: '查看',
+			submenu: [
+				{ role: 'reload', label: '重新加载' },
+				{ role: 'forceReload', label: '强制重新加载' },
+				{ role: 'toggleDevTools', label: '开发者工具' },
+				{ type: 'separator' },
+				{ role: 'resetZoom', label: '重置缩放' },
+				{ role: 'zoomIn', label: '放大' },
+				{ role: 'zoomOut', label: '缩小' },
+				{ type: 'separator' },
+				{ role: 'togglefullscreen', label: '全屏' }
+			]
+		},
+		{
+			label: '窗口',
+			submenu: [
+				{
+					label: '在浏览器中打开',
+					click: '__TOGGLE_BROWSER__'
+				},
+				{ role: 'minimize', label: '最小化' },
+				{ role: 'zoom', label: '缩放' },
+				{ type: 'separator' },
+				{ role: 'close', label: '关闭' }
+			]
+		},
+		{
+			label: '帮助',
+			submenu: [
+				{
+					label: '关于',
+					click: `() => { require('electron').shell.openExternal('https://electronjs.org'); }`
+				}
+			]
+		}
+	],
+
+	// 打包配置
+	build: {
+		appId: 'com.mycompany.myapp',    	// 应用唯一标识（反向域名格式）
+		outputDir: './dist',             	// 安装包输出目录
+
+		// ----- Windows 安装包选项 (NSIS) -----
+		nsis: {
+			oneClick: false,                 // true=一键安装，false=向导安装
+			perMachine: true,                // true=安装到所有用户，false=仅当前用户
+			allowToChangeInstallationDirectory: true, // 是否允许用户更改安装路径
+			createDesktopShortcut: true,     // 是否创建桌面快捷方式
+			createStartMenuShortcut: true,   // 是否创建开始菜单快捷方式
+			shortcutName: '我的桌面应用',     // 快捷方式名称
+			deleteAppDataOnUninstall: false, // 卸载时是否删除用户数据
+		},
+		// Windows 平台通用配置（可覆盖或补充）
+		win: {
+			target: ['nsis'],                // 构建目标：nsis / portable / zip 等
+			// 其他可选字段：icon, publisherName, signingHashAlgorithms 等
+		},
+
+		// ----- macOS 配置（增强） -----
+		mac: {
+			target: ['dmg', 'zip'],          // 构建目标：dmg / zip / pkg / mas 等
+			// 以下为可选高级字段（如需代码签名或 Mac App Store 发布，可取消注释并填写）
+			// identity: 'Developer ID Application: Your Name (TEAM123)', // 签名证书名称
+			// hardenedRuntime: true,        // 启用 Hardened Runtime
+			// entitlements: './build/entitlements.mac.plist', // 签名 entitlements 文件
+			// entitlementsInherit: './build/entitlements.mac.inherit.plist', // Helper 进程 entitlements
+			// provisioningProfile: './build/profile.provisionprofile', // 仅 MAS 需要
+		},
+		// macOS DMG 选项
+		dmg: {
+			iconSize: 128,                		 // 图标大小
+			window: { width: 540, height: 380 }, // DMG 窗口尺寸
+			// 以下为增强选项（可选）
+			// background: './build/dmg-background.png',   // DMG 背景图片（建议 PNG）
+			// backgroundColor: '#ffffff',                 // 无背景图时的背景色
+			// icon: './build/volume-icon.icns',           // DMG 卷宗图标（显示在 Finder 侧边栏）
+			// title: '${productName} ${version}',         // 挂载后显示的卷宗名称
+			// format: 'UDZO',                            // 压缩格式（UDZO/ULFO/UDBZ 等）
+			// contents: [                                // 自定义窗口内图标布局
+			//   { x: 130, y: 220, type: 'file' },
+			//   { x: 410, y: 220, type: 'link', path: '/Applications' }
+			// ]
+		},
+
+		// ----- Linux 配置（增强） -----
+		linux: {
+			target: ['AppImage', 'deb'],     // 构建目标：AppImage / deb / rpm / snap / flatpak 等
+			category: 'Development',         // 系统菜单分类（如 Utility, Network, Development 等）
+			// 以下为可选高级字段
+			// description: '完整的应用描述',   // 长描述
+			// synopsis: '简短描述',           // 短描述
+			// maintainer: '你的名字 <email@example.com>', // 维护者信息
+			// vendor: '我的公司',            // 供应商名称
+			// executableArgs: ['--enable-features=...'], // 启动时的命令行参数
+			// desktop: {                    // 自定义 .desktop 文件内容
+			//   entry: {
+			//     Name: '我的应用',
+			//     Comment: '一个很棒的应用',
+			//     Categories: 'Development;Utility;',
+			//     Keywords: 'app;tool;',
+			//     Terminal: false,
+			//     Type: 'Application'
+			//   }
+			// },
+			// syncDesktopName: true,        // 同步 .desktop 文件名与窗口类名，防止任务栏图标错乱
+		},
+		// 特定格式的额外配置（可选）
+		// appImage: {
+		//   systemIntegration: 'doNotAsk'  // 是否询问系统集成
+		// },
+		// deb: {
+		//   depends: ['libgtk-3-0']        // deb 包的依赖
+		// },
+	},
+
+	// 高级选项
+	advanced: {
+		autoStartServer: true,           // 是否自动启动后端服务
+		autoKillServer: true             // 退出时是否自动关闭后端
+	},
+
+	// 排除文件/目录（相对于项目根目录,支持 glob 模式）
+	excludeFiles: [
+		'.vscode/',
+		'.idea/',
+		'.git/',
+		'.hintrc',
+		'.greenlockrc',
+		'node_modules/', // ← 默认排除,以优化构建和安装速度（避免签名和解压海量文件）
+		'dist/',
+		'docs/',
+		'temp/',
+		'tests/',
+		'./yarn.lock',
+		'./desktop.ini',
+		'./desktopAppConfig.js',
+		'./sevWin.js',
+		'./unSevWin.js',
+		'*.tgz',
+		'*.log'
+	],
+
+	// 排除依赖包（从最终依赖列表中移除,不会安装）
+	excludeDependencies: [
+		'@flun/desktop-builder',
+		'@flun/windows'
+	],
+
+	/**
+	 * 排除输出文件（在最终输出目录中排除某些安装包文件）
+	 * 例如 *.blockmap、latest.yml 等;
+	 * 注意：此配置仅在复制最终安装包到输出目录时生效,不影响构建过程;
+	 */
+	excludeOutputs: [
+		'*.blockmap',
+		'latest.yml'
+	]
+};

package/electron-main.js

@@ -0,0 +1,317 @@
+import { app, BrowserWindow, Menu, shell } from 'electron';
+import { spawn, exec } from 'child_process';
+import { promisify } from 'util';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs';
+import http from 'http';
+import https from 'https';
+import net from 'net';
+import { createRequire } from 'module';
+
+// --------------------- 全局变量 ---------------------
+let mainWindow = null, serverProcess = null, windowCreationPromise = null, loadRetryCount = 0;
+const require = createRequire(import.meta.url),
+  __dirname = path.dirname(fileURLToPath(import.meta.url)), execPromise = promisify(exec),
+  // 配置注入
+  CONFIG = {
+    APP_URL: JSON.parse('__APP_URL__'),
+    WINDOW_CONFIG: JSON.parse('__WINDOW_CONFIG__'),
+    SERVER_PATH: JSON.parse('__SERVER_PATH__'),
+    AUTO_START_SERVER: JSON.parse('__AUTO_START_SERVER__'),
+    AUTO_KILL_SERVER: JSON.parse('__AUTO_KILL_SERVER__'),
+    LOGGING_ENABLED: JSON.parse('__LOGGING_ENABLED__'),
+    MENU_TEMPLATE: __MENU_TEMPLATE__,
+  }, TARGET_URL = CONFIG.APP_URL,
+  // 命令行开关
+  switches = ['no-sandbox', 'ignore-certificate-errors', 'allow-insecure-localhost'],
+
+  // --------------------- 函数声明 ---------------------
+  // 日志（根据配置决定是否写入）
+  writeLog = (filePath, msg) => {
+    try {
+      fs.appendFileSync(filePath, new Date().toISOString() + ' ' + msg + '\n');
+    } catch (_) { }
+  },
+  log = msg => {
+    if (!CONFIG.LOGGING_ENABLED) return;
+    writeLog(path.join(app.getPath('desktop'), 'myapp_debug.log'), msg);
+  },
+  emergencyLog = (msg) => {
+    if (!CONFIG.LOGGING_ENABLED) return;
+    writeLog(path.join(process.cwd(), 'myapp_emergency.log'), msg);
+  },
+  // 服务器管理
+  killServerProcess = () => {
+    if (!serverProcess) return;
+    try {
+      if (process.platform === 'win32') exec(`taskkill /pid ${serverProcess.pid} /T /F`);
+      else process.kill(-serverProcess.pid, 'SIGTERM');
+    } catch (_) { }
+    serverProcess = null;
+  },
+
+  focusMainWindow = () => {
+    if (mainWindow && !mainWindow.isDestroyed()) {
+      if (mainWindow.isMinimized()) mainWindow.restore();
+      return mainWindow.focus(), true;
+    }
+    return false;
+  },
+  sleep = ms => new Promise(resolve => setTimeout(resolve, ms)),
+  // 依赖安装
+  ensureDependencies = async () => {
+    const nodeModulesPath = path.join(__dirname, 'node_modules');
+    try {
+      return await fs.promises.access(nodeModulesPath, fs.constants.F_OK), true;
+    } catch {
+      log('未找到 node_modules，开始安装依赖...');
+      const depsPath = path.join(__dirname, 'deps.json');
+      try {
+        await fs.promises.access(depsPath, fs.constants.F_OK);
+      } catch {
+        return log('错误: deps.json 不存在，无法安装依赖'), false;
+      }
+      let deps;
+      try {
+        const depsContent = await fs.promises.readFile(depsPath, 'utf-8');
+        deps = JSON.parse(depsContent);
+      } catch (err) {
+        return log('读取 deps.json 失败: ' + err.message), false;
+      }
+      const pkgPath = path.join(__dirname, 'package.json');
+      let pkg;
+      try {
+        const pkgContent = await fs.promises.readFile(pkgPath, 'utf-8');
+        pkg = JSON.parse(pkgContent);
+      } catch (err) {
+        return log('读取 package.json 失败: ' + err.message), false;
+      }
+      pkg.dependencies = deps, pkg.devDependencies = {};
+      try {
+        await fs.promises.writeFile(pkgPath, JSON.stringify(pkg, null, 2), 'utf-8');
+      } catch (err) {
+        return log('写入 package.json 失败: ' + err.message), false;
+      }
+      try {
+        let cmd = 'npm install';
+        const lockPath = path.join(__dirname, 'package-lock.json');
+        try {
+          await fs.promises.access(lockPath, fs.constants.F_OK);
+          log('找到 package-lock.json，使用 npm ci'), cmd = 'npm ci';
+        } catch {
+          log('未找到 package-lock.json，使用 npm install');
+        }
+        const { stdout, stderr } = await execPromise(cmd, { cwd: __dirname, env: process.env, timeout: 120000 });
+        if (stdout && stderr) log('依赖安装完成');
+        try {
+          return await fs.promises.access(nodeModulesPath, fs.constants.F_OK), true;
+        } catch {
+          return log('安装 node_modules 失败'), false;
+        }
+      } catch (error) {
+        return log('依赖安装失败: ' + error.message), emergencyLog('依赖安装失败堆栈: ' + error.stack), false;
+      }
+    }
+  },
+
+  // 端口检查
+  ensurePortFree = port => {
+    return new Promise((resolve) => {
+      const server = net.createServer();
+      server.once('error', (err) => {
+        if (err.code === 'EADDRINUSE') {
+          const cmd = process.platform === 'win32' ? `netstat -ano | findstr :${port}` : `lsof -i :${port} -t`;
+          exec(cmd, (err, stdout) => {
+            if (err) { resolve(false); return; }
+            const pids = stdout.split(/\s+/).filter(x => x && !isNaN(x));
+            let killed = false;
+            for (const pid of pids)
+              try { process.kill(parseInt(pid), 'SIGTERM'), killed = true; } catch (_) { };
+            setTimeout(() => resolve(killed), 1000);
+          });
+        }
+        else resolve(false);
+      });
+      server.once('listening', () => { server.close(), resolve(true); }), server.listen(port, '127.0.0.1');
+    });
+  },
+
+  // 等待服务器就绪
+  waitForServer = (port, timeout = 30000) => {
+    return new Promise((resolve) => {
+      const start = Date.now(), protocol = new URL(CONFIG.APP_URL).protocol,
+        httpModule = protocol === 'https:' ? https : http,
+        check = () => {
+          if (Date.now() - start > timeout) return log('服务器就绪超时'), resolve(false);
+          const req = httpModule.get({
+            hostname: '127.0.0.1', port, path: '/',
+            rejectUnauthorized: false,
+            timeout: 5000, family: 4,
+          }, res => {
+            log('服务器响应 ' + res.statusCode), resolve(true), req.destroy();
+          });
+          req.on('error', err => {
+            log('服务器尚未就绪: ' + err.message), setTimeout(check, 2000);
+          });
+          req.on('timeout', () => {
+            req.destroy(), setTimeout(check, 2000);
+          });
+        };
+      check();
+    });
+  },
+
+  openInBrowser = () => {
+    try {
+      shell.openExternal(CONFIG.APP_URL);
+    } catch (e) {
+      log('打开浏览器失败: ' + e.message);
+    }
+  },
+
+  // 创建窗口
+  createWindow = async () => {
+    if (mainWindow && !mainWindow.isDestroyed()) return focusMainWindow(), mainWindow;
+    if (windowCreationPromise) {
+      await windowCreationPromise;
+      if (mainWindow) return focusMainWindow(), mainWindow;
+    }
+    windowCreationPromise = (async () => {
+      try {
+        const winConfig = {
+          ...CONFIG.WINDOW_CONFIG,
+          webPreferences: {
+            ...CONFIG.WINDOW_CONFIG.webPreferences,
+            webSecurity: true,
+            allowRunningInsecureContent: true,
+            enableWebAuthn: true,
+            plugins: true,
+            nodeIntegration: true,
+            sandbox: false,
+            contextIsolation: false,
+          }
+        };
+        mainWindow = new BrowserWindow(winConfig);
+        mainWindow.webContents.session.setPermissionRequestHandler((wc, perm, cb) => cb(true));
+        mainWindow.webContents.session.setDevicePermissionHandler(() => true);
+
+        let shown = false;
+        mainWindow.once('ready-to-show', () => {
+          if (!mainWindow.isDestroyed())
+            mainWindow.show(), mainWindow.focus(), mainWindow.webContents.focus(), shown = true;
+        });
+
+        mainWindow.webContents.on('did-fail-load', (e, code, desc, url) => {
+          if (code === -102 && loadRetryCount < 3) {
+            loadRetryCount++;
+            setTimeout(() => { if (mainWindow) mainWindow.loadURL(TARGET_URL).catch(() => { }); }, 2000);
+            return;
+          }
+          if (!shown) mainWindow.show();
+          mainWindow.loadURL(`data:text/html;charset=utf-8,<h2>加载失败</h2><p>${desc}</p><p>URL: ${url}</p>`);
+        });
+
+        await mainWindow.loadURL(TARGET_URL), loadRetryCount = 0;
+        setTimeout(() => { if (mainWindow && !mainWindow.isVisible()) mainWindow.show(); }, 3000);
+        mainWindow.on('closed', () => mainWindow = null);
+        return mainWindow;
+      } catch (err) {
+        log('创建窗口失败: ' + err.message), emergencyLog('窗口创建失败: ' + err.message), app.quit();
+      } finally { windowCreationPromise = null; }
+    })();
+    return windowCreationPromise;
+  },
+
+  // 启动服务器
+  startServer = async () => {
+    if (!CONFIG.AUTO_START_SERVER) return;
+    const serverPath = path.join(__dirname, CONFIG.SERVER_PATH);
+    if (!fs.existsSync(serverPath)) { log('服务器文件不存在: ' + serverPath); return; }
+
+    let port = 7296;
+    try { port = parseInt(new URL(CONFIG.APP_URL).port) || 7296 } catch (_) { }
+
+    for (let attempt = 1; attempt <= 3; attempt++) {
+      await ensurePortFree(port);
+
+      const env = { ...process.env, NODE_PATH: path.join(__dirname, 'node_modules') };
+      serverProcess = spawn('node', [serverPath], { cwd: __dirname, stdio: ['ignore', 'pipe', 'pipe'], detached: true, env });
+      serverProcess.stdout.on('data', d => log('服务器 stdout: ' + d.toString().trim()));
+      serverProcess.stderr.on('data', d => log('服务器 stderr: ' + d.toString().trim()));
+      serverProcess.on('error', err => log('服务器进程错误: ' + err.message));
+      serverProcess.unref();
+
+      const ready = await waitForServer(port, 30000);
+      if (ready) return;
+
+      log(`服务器未就绪 (尝试 ${attempt}/3),重试...`), killServerProcess(), await sleep(2000);
+    }
+    log('服务器启动失败,尝试重新加载窗口');
+  },
+
+  // 菜单设置（处理特殊标记）
+  setupMenu = () => {
+    const template = CONFIG.MENU_TEMPLATE;
+    if (!template || template.length === 0) return;
+
+    const processMenu = (items) => {
+      return items.map(item => {
+        const newItem = { ...item };
+        if (newItem.submenu) newItem.submenu = processMenu(newItem.submenu);
+        if (newItem.click === '__TOGGLE_BROWSER__') newItem.click = openInBrowser;
+        else if (typeof newItem.click === 'string' &&
+          /^(async\s+)?(function\s*(\w*\s*)?\(|\(\)\s*=>|async\s*\(\)\s*=>)/.test(newItem.click.trim()))
+          try { newItem.click = eval(newItem.click) } catch (_) { }
+
+        return newItem;
+      });
+    };
+
+    Menu.setApplicationMenu(Menu.buildFromTemplate(processMenu(template)));
+  };
+
+// --------------------- 主流程 ---------------------
+globalThis.require = require;
+switches.forEach(s => app.commandLine.appendSwitch(s));
+try {
+  const hostname = new URL(TARGET_URL).hostname;
+  app.commandLine.appendSwitch('host-resolver-rules', `MAP ${hostname} 127.0.0.1`);
+  app.commandLine.appendSwitch('enable-features',
+    'WebAuthentication,WebAuthn,WebAuthenticationHidSupport,WebAuthenticationWindowsApi,WebAuthenticationAndroidAccessory');
+  app.commandLine.appendSwitch('disable-features', 'UseDnsHttpsSvcb,BlockInsecurePrivateNetworkRequests');
+  app.commandLine.appendSwitch('enable-experimental-web-platform-features');
+  app.commandLine.appendSwitch('disable-blink-features', 'AutomationControlled');
+  app.commandLine.appendSwitch('vmodule', 'webauthn*=3');
+  log(`已映射 ${hostname} 到 127.0.0.1`);
+} catch (_) { }
+// 单例锁
+if (!app.requestSingleInstanceLock()) { log('已有另一个实例在运行,退出'); app.quit(); }
+else app.on('second-instance', () => focusMainWindow());
+app.on('certificate-error', (e, wc, url, err, cert, cb) => { e.preventDefault(), cb(true); });
+
+app.whenReady().then(async () => {
+  setupMenu();
+
+  const depsOk = await ensureDependencies();
+  if (!depsOk) log('依赖安装失败，再次尝试启动服务器（可能失败）');
+  await startServer(), await createWindow();
+});
+
+app.on('window-all-closed', () => {
+  log('所有窗口已关闭');
+  if (CONFIG.AUTO_KILL_SERVER) killServerProcess();
+  app.quit();
+});
+
+app.on('activate', () => {
+  if (BrowserWindow.getAllWindows().length === 0) createWindow();
+  else if (mainWindow) mainWindow.focus();
+});
+
+process.on('uncaughtException', (err) => {
+  const msg = '未捕获异常: ' + err.message + '\n' + err.stack;
+  log(msg), emergencyLog(msg), app.quit();
+});
+
+app.on('will-quit', () => killServerProcess());

package/index.d.ts

@@ -0,0 +1,37 @@
+import { runCLI, build } from './lib/build.js';
+
+// =================================== lib/build.js ===================================
+/**
+ * ```js
+ * // 文件导出内容
+ * build();  // 构建桌面应用程序
+ * runCLI(); // 解析 process.argv 并执行对应的构建命令
+ * ```
+ * >查看定义:@see {@link build}、{@link runCLI}
+ */
+declare module './lib/build.js' {
+    export * from './lib/build.js';
+}
+
+// =================================== 模块导出入口 ===================================
+/**
+ * 模块 主要功能：
+ * ```js
+ * build();           // 构建桌面应用程序
+ * ```
+ * ---
+ * >查看定义:@see {@link build}
+ * @example
+ *  // 基础示例
+ *   import { build } from '@flun/desktop-builder';
+ *
+ *   try {
+ *       await build();
+ *   } catch (err) {
+ *       console.error('❌ 失败:', err.message);
+ *       process.exit(1);
+ *   }
+ */
+declare module './index.js' {
+    export { build } from './lib/build.js';
+}

package/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCLI, build } from './lib/build.js';
+if (import.meta.url === `file://${process.argv[1]}`) await runCLI();
+export { build };